google-api-client 0.13.0 → 0.13.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (241) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +3 -0
  3. data/README.md +6 -2
  4. data/generated/google/apis/acceleratedmobilepageurl_v1/classes.rb +46 -46
  5. data/generated/google/apis/acceleratedmobilepageurl_v1/representations.rb +15 -15
  6. data/generated/google/apis/acceleratedmobilepageurl_v1/service.rb +4 -4
  7. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +1 -1
  8. data/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb +404 -435
  9. data/generated/google/apis/adexchangebuyer2_v2beta1/representations.rb +107 -121
  10. data/generated/google/apis/adexchangebuyer2_v2beta1/service.rb +657 -713
  11. data/generated/google/apis/admin_directory_v1.rb +1 -1
  12. data/generated/google/apis/admin_directory_v1/classes.rb +45 -5
  13. data/generated/google/apis/admin_directory_v1/representations.rb +16 -0
  14. data/generated/google/apis/admin_directory_v1/service.rb +4 -1
  15. data/generated/google/apis/admin_reports_v1.rb +1 -1
  16. data/generated/google/apis/adsense_v1_4.rb +1 -1
  17. data/generated/google/apis/adsensehost_v4_1.rb +1 -1
  18. data/generated/google/apis/analyticsreporting_v4.rb +1 -1
  19. data/generated/google/apis/analyticsreporting_v4/classes.rb +399 -399
  20. data/generated/google/apis/analyticsreporting_v4/representations.rb +101 -101
  21. data/generated/google/apis/analyticsreporting_v4/service.rb +10 -10
  22. data/generated/google/apis/androidenterprise_v1.rb +1 -1
  23. data/generated/google/apis/appengine_v1.rb +4 -4
  24. data/generated/google/apis/appengine_v1/classes.rb +747 -747
  25. data/generated/google/apis/appengine_v1/representations.rb +158 -158
  26. data/generated/google/apis/appengine_v1/service.rb +214 -214
  27. data/generated/google/apis/appsactivity_v1.rb +1 -1
  28. data/generated/google/apis/appstate_v1.rb +1 -1
  29. data/generated/google/apis/bigquery_v2.rb +1 -1
  30. data/generated/google/apis/bigquery_v2/classes.rb +6 -0
  31. data/generated/google/apis/bigquery_v2/representations.rb +2 -0
  32. data/generated/google/apis/calendar_v3.rb +1 -1
  33. data/generated/google/apis/classroom_v1.rb +7 -7
  34. data/generated/google/apis/classroom_v1/classes.rb +517 -515
  35. data/generated/google/apis/classroom_v1/representations.rb +147 -147
  36. data/generated/google/apis/classroom_v1/service.rb +1144 -1143
  37. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  38. data/generated/google/apis/cloudbuild_v1/classes.rb +435 -386
  39. data/generated/google/apis/cloudbuild_v1/representations.rb +133 -115
  40. data/generated/google/apis/cloudbuild_v1/service.rb +148 -148
  41. data/generated/google/apis/clouddebugger_v2.rb +1 -1
  42. data/generated/google/apis/clouddebugger_v2/classes.rb +708 -708
  43. data/generated/google/apis/clouddebugger_v2/representations.rb +146 -146
  44. data/generated/google/apis/clouddebugger_v2/service.rb +124 -124
  45. data/generated/google/apis/clouderrorreporting_v1beta1.rb +1 -1
  46. data/generated/google/apis/clouderrorreporting_v1beta1/classes.rb +142 -142
  47. data/generated/google/apis/clouderrorreporting_v1beta1/representations.rb +29 -29
  48. data/generated/google/apis/clouderrorreporting_v1beta1/service.rb +87 -87
  49. data/generated/google/apis/cloudfunctions_v1.rb +1 -1
  50. data/generated/google/apis/cloudfunctions_v1/service.rb +6 -6
  51. data/generated/google/apis/cloudkms_v1.rb +1 -1
  52. data/generated/google/apis/cloudkms_v1/classes.rb +692 -675
  53. data/generated/google/apis/cloudkms_v1/representations.rb +144 -144
  54. data/generated/google/apis/cloudkms_v1/service.rb +276 -276
  55. data/generated/google/apis/cloudresourcemanager_v1.rb +1 -1
  56. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +1168 -1168
  57. data/generated/google/apis/cloudresourcemanager_v1/representations.rb +190 -190
  58. data/generated/google/apis/cloudresourcemanager_v1/service.rb +311 -288
  59. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +4 -4
  60. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +406 -406
  61. data/generated/google/apis/cloudresourcemanager_v1beta1/representations.rb +95 -95
  62. data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb +242 -234
  63. data/generated/google/apis/cloudtrace_v1.rb +4 -4
  64. data/generated/google/apis/cloudtrace_v1/classes.rb +68 -68
  65. data/generated/google/apis/cloudtrace_v1/representations.rb +22 -22
  66. data/generated/google/apis/cloudtrace_v1/service.rb +48 -48
  67. data/generated/google/apis/compute_beta.rb +1 -1
  68. data/generated/google/apis/compute_beta/classes.rb +82 -6
  69. data/generated/google/apis/compute_beta/representations.rb +4 -0
  70. data/generated/google/apis/compute_beta/service.rb +1177 -834
  71. data/generated/google/apis/compute_v1.rb +1 -1
  72. data/generated/google/apis/compute_v1/classes.rb +371 -1
  73. data/generated/google/apis/compute_v1/representations.rb +139 -0
  74. data/generated/google/apis/compute_v1/service.rb +257 -9
  75. data/generated/google/apis/container_v1.rb +1 -1
  76. data/generated/google/apis/container_v1/classes.rb +1122 -826
  77. data/generated/google/apis/container_v1/representations.rb +279 -135
  78. data/generated/google/apis/container_v1/service.rb +440 -98
  79. data/generated/google/apis/content_v2.rb +1 -1
  80. data/generated/google/apis/content_v2/service.rb +3 -1
  81. data/generated/google/apis/customsearch_v1.rb +1 -1
  82. data/generated/google/apis/dataflow_v1b3.rb +4 -4
  83. data/generated/google/apis/dataflow_v1b3/classes.rb +3423 -3423
  84. data/generated/google/apis/dataflow_v1b3/representations.rb +813 -813
  85. data/generated/google/apis/dataflow_v1b3/service.rb +410 -410
  86. data/generated/google/apis/dataproc_v1.rb +1 -1
  87. data/generated/google/apis/dataproc_v1/classes.rb +450 -431
  88. data/generated/google/apis/dataproc_v1/representations.rb +92 -92
  89. data/generated/google/apis/dataproc_v1/service.rb +200 -200
  90. data/generated/google/apis/datastore_v1.rb +4 -4
  91. data/generated/google/apis/datastore_v1/classes.rb +397 -397
  92. data/generated/google/apis/datastore_v1/representations.rb +100 -100
  93. data/generated/google/apis/datastore_v1/service.rb +62 -62
  94. data/generated/google/apis/deploymentmanager_v2.rb +1 -1
  95. data/generated/google/apis/deploymentmanager_v2/classes.rb +79 -3
  96. data/generated/google/apis/deploymentmanager_v2/representations.rb +33 -0
  97. data/generated/google/apis/deploymentmanager_v2/service.rb +15 -20
  98. data/generated/google/apis/dns_v1.rb +1 -1
  99. data/generated/google/apis/dns_v2beta1.rb +1 -1
  100. data/generated/google/apis/doubleclickbidmanager_v1.rb +1 -1
  101. data/generated/google/apis/doubleclickbidmanager_v1/classes.rb +2 -2
  102. data/generated/google/apis/doubleclicksearch_v2.rb +1 -1
  103. data/generated/google/apis/drive_v2.rb +1 -1
  104. data/generated/google/apis/drive_v2/service.rb +1 -1
  105. data/generated/google/apis/drive_v3.rb +1 -1
  106. data/generated/google/apis/drive_v3/service.rb +1 -1
  107. data/generated/google/apis/firebasedynamiclinks_v1.rb +1 -1
  108. data/generated/google/apis/firebasedynamiclinks_v1/classes.rb +87 -87
  109. data/generated/google/apis/firebasedynamiclinks_v1/representations.rb +27 -27
  110. data/generated/google/apis/firebaserules_v1/classes.rb +271 -271
  111. data/generated/google/apis/firebaserules_v1/representations.rb +82 -82
  112. data/generated/google/apis/firebaserules_v1/service.rb +151 -151
  113. data/generated/google/apis/games_configuration_v1configuration.rb +1 -1
  114. data/generated/google/apis/games_management_v1management.rb +1 -1
  115. data/generated/google/apis/games_v1.rb +1 -1
  116. data/generated/google/apis/genomics_v1.rb +9 -9
  117. data/generated/google/apis/genomics_v1/classes.rb +2242 -2242
  118. data/generated/google/apis/genomics_v1/representations.rb +306 -306
  119. data/generated/google/apis/genomics_v1/service.rb +1172 -1172
  120. data/generated/google/apis/gmail_v1.rb +1 -1
  121. data/generated/google/apis/iam_v1.rb +1 -1
  122. data/generated/google/apis/iam_v1/classes.rb +243 -243
  123. data/generated/google/apis/iam_v1/representations.rb +79 -79
  124. data/generated/google/apis/iam_v1/service.rb +137 -137
  125. data/generated/google/apis/identitytoolkit_v3.rb +1 -1
  126. data/generated/google/apis/identitytoolkit_v3/classes.rb +18 -0
  127. data/generated/google/apis/identitytoolkit_v3/representations.rb +3 -0
  128. data/generated/google/apis/kgsearch_v1/classes.rb +9 -9
  129. data/generated/google/apis/kgsearch_v1/representations.rb +2 -2
  130. data/generated/google/apis/kgsearch_v1/service.rb +4 -4
  131. data/generated/google/apis/language_v1.rb +1 -1
  132. data/generated/google/apis/language_v1/classes.rb +451 -451
  133. data/generated/google/apis/language_v1/representations.rb +103 -103
  134. data/generated/google/apis/language_v1/service.rb +49 -49
  135. data/generated/google/apis/language_v1beta1.rb +1 -1
  136. data/generated/google/apis/language_v1beta1/classes.rb +459 -459
  137. data/generated/google/apis/language_v1beta1/representations.rb +110 -110
  138. data/generated/google/apis/language_v1beta1/service.rb +43 -43
  139. data/generated/google/apis/logging_v2.rb +8 -8
  140. data/generated/google/apis/logging_v2/classes.rb +915 -915
  141. data/generated/google/apis/logging_v2/representations.rb +142 -142
  142. data/generated/google/apis/logging_v2/service.rb +415 -415
  143. data/generated/google/apis/logging_v2beta1.rb +8 -8
  144. data/generated/google/apis/logging_v2beta1/classes.rb +905 -905
  145. data/generated/google/apis/logging_v2beta1/representations.rb +150 -150
  146. data/generated/google/apis/logging_v2beta1/service.rb +221 -221
  147. data/generated/google/apis/manufacturers_v1.rb +1 -1
  148. data/generated/google/apis/manufacturers_v1/classes.rb +334 -315
  149. data/generated/google/apis/manufacturers_v1/representations.rb +99 -87
  150. data/generated/google/apis/manufacturers_v1/service.rb +101 -4
  151. data/generated/google/apis/ml_v1.rb +1 -1
  152. data/generated/google/apis/ml_v1/classes.rb +709 -673
  153. data/generated/google/apis/ml_v1/representations.rb +154 -151
  154. data/generated/google/apis/ml_v1/service.rb +341 -354
  155. data/generated/google/apis/monitoring_v3.rb +6 -6
  156. data/generated/google/apis/monitoring_v3/classes.rb +869 -869
  157. data/generated/google/apis/monitoring_v3/representations.rb +171 -171
  158. data/generated/google/apis/monitoring_v3/service.rb +340 -340
  159. data/generated/google/apis/partners_v2.rb +1 -1
  160. data/generated/google/apis/partners_v2/classes.rb +1569 -1569
  161. data/generated/google/apis/partners_v2/representations.rb +256 -256
  162. data/generated/google/apis/partners_v2/service.rb +530 -530
  163. data/generated/google/apis/people_v1.rb +7 -7
  164. data/generated/google/apis/people_v1/classes.rb +1287 -946
  165. data/generated/google/apis/people_v1/representations.rb +355 -203
  166. data/generated/google/apis/people_v1/service.rb +409 -32
  167. data/generated/google/apis/plus_domains_v1.rb +1 -1
  168. data/generated/google/apis/plus_v1.rb +1 -1
  169. data/generated/google/apis/proximitybeacon_v1beta1.rb +1 -1
  170. data/generated/google/apis/proximitybeacon_v1beta1/classes.rb +445 -445
  171. data/generated/google/apis/proximitybeacon_v1beta1/representations.rb +104 -104
  172. data/generated/google/apis/proximitybeacon_v1beta1/service.rb +241 -241
  173. data/generated/google/apis/pubsub_v1.rb +4 -4
  174. data/generated/google/apis/pubsub_v1/classes.rb +286 -287
  175. data/generated/google/apis/pubsub_v1/representations.rb +80 -80
  176. data/generated/google/apis/pubsub_v1/service.rb +178 -178
  177. data/generated/google/apis/runtimeconfig_v1.rb +1 -1
  178. data/generated/google/apis/runtimeconfig_v1/classes.rb +52 -52
  179. data/generated/google/apis/runtimeconfig_v1/representations.rb +15 -15
  180. data/generated/google/apis/runtimeconfig_v1/service.rb +21 -21
  181. data/generated/google/apis/script_v1.rb +4 -4
  182. data/generated/google/apis/script_v1/classes.rb +172 -172
  183. data/generated/google/apis/script_v1/representations.rb +41 -41
  184. data/generated/google/apis/script_v1/service.rb +6 -6
  185. data/generated/google/apis/searchconsole_v1.rb +1 -1
  186. data/generated/google/apis/searchconsole_v1/classes.rb +6 -6
  187. data/generated/google/apis/searchconsole_v1/representations.rb +1 -1
  188. data/generated/google/apis/servicecontrol_v1.rb +1 -1
  189. data/generated/google/apis/servicecontrol_v1/classes.rb +1110 -1110
  190. data/generated/google/apis/servicecontrol_v1/representations.rb +215 -215
  191. data/generated/google/apis/servicecontrol_v1/service.rb +65 -65
  192. data/generated/google/apis/servicemanagement_v1.rb +6 -6
  193. data/generated/google/apis/servicemanagement_v1/classes.rb +3594 -3562
  194. data/generated/google/apis/servicemanagement_v1/representations.rb +564 -562
  195. data/generated/google/apis/servicemanagement_v1/service.rb +253 -253
  196. data/generated/google/apis/serviceuser_v1.rb +1 -1
  197. data/generated/google/apis/serviceuser_v1/classes.rb +2678 -2670
  198. data/generated/google/apis/serviceuser_v1/representations.rb +269 -268
  199. data/generated/google/apis/serviceuser_v1/service.rb +59 -59
  200. data/generated/google/apis/sheets_v4.rb +5 -5
  201. data/generated/google/apis/sheets_v4/classes.rb +5155 -5104
  202. data/generated/google/apis/sheets_v4/representations.rb +957 -940
  203. data/generated/google/apis/sheets_v4/service.rb +175 -175
  204. data/generated/google/apis/slides_v1.rb +1 -1
  205. data/generated/google/apis/slides_v1/classes.rb +2932 -2905
  206. data/generated/google/apis/slides_v1/representations.rb +709 -694
  207. data/generated/google/apis/slides_v1/service.rb +50 -50
  208. data/generated/google/apis/sourcerepo_v1/classes.rb +139 -139
  209. data/generated/google/apis/sourcerepo_v1/representations.rb +40 -40
  210. data/generated/google/apis/sourcerepo_v1/service.rb +61 -61
  211. data/generated/google/apis/spanner_v1.rb +7 -1
  212. data/generated/google/apis/spanner_v1/classes.rb +2362 -2299
  213. data/generated/google/apis/spanner_v1/representations.rb +342 -323
  214. data/generated/google/apis/spanner_v1/service.rb +502 -492
  215. data/generated/google/apis/speech_v1beta1.rb +1 -1
  216. data/generated/google/apis/speech_v1beta1/classes.rb +244 -244
  217. data/generated/google/apis/speech_v1beta1/representations.rb +52 -52
  218. data/generated/google/apis/speech_v1beta1/service.rb +91 -91
  219. data/generated/google/apis/storage_v1.rb +1 -1
  220. data/generated/google/apis/storagetransfer_v1.rb +1 -1
  221. data/generated/google/apis/storagetransfer_v1/classes.rb +784 -781
  222. data/generated/google/apis/storagetransfer_v1/representations.rb +88 -88
  223. data/generated/google/apis/storagetransfer_v1/service.rb +154 -154
  224. data/generated/google/apis/toolresults_v1beta3.rb +1 -1
  225. data/generated/google/apis/toolresults_v1beta3/classes.rb +90 -1
  226. data/generated/google/apis/toolresults_v1beta3/representations.rb +18 -0
  227. data/generated/google/apis/translate_v2/classes.rb +107 -107
  228. data/generated/google/apis/translate_v2/representations.rb +49 -49
  229. data/generated/google/apis/translate_v2/service.rb +81 -81
  230. data/generated/google/apis/vision_v1.rb +4 -1
  231. data/generated/google/apis/vision_v1/classes.rb +527 -527
  232. data/generated/google/apis/vision_v1/representations.rb +115 -115
  233. data/generated/google/apis/youtube_analytics_v1.rb +1 -1
  234. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  235. data/generated/google/apis/youtubereporting_v1.rb +1 -1
  236. data/generated/google/apis/youtubereporting_v1/classes.rb +124 -124
  237. data/generated/google/apis/youtubereporting_v1/representations.rb +30 -30
  238. data/generated/google/apis/youtubereporting_v1/service.rb +113 -113
  239. data/lib/google/apis/version.rb +1 -1
  240. data/samples/cli/lib/samples/analytics.rb +2 -2
  241. metadata +2 -2
@@ -25,19 +25,19 @@ module Google
25
25
  # @see https://cloud.google.com/logging/docs/
26
26
  module LoggingV2beta1
27
27
  VERSION = 'V2beta1'
28
- REVISION = '20170605'
28
+ REVISION = '20170710'
29
29
 
30
- # View your data across Google Cloud Platform services
31
- AUTH_CLOUD_PLATFORM_READ_ONLY = 'https://www.googleapis.com/auth/cloud-platform.read-only'
32
-
33
- # Administrate log data for your projects
34
- AUTH_LOGGING_ADMIN = 'https://www.googleapis.com/auth/logging.admin'
30
+ # Submit log data for your projects
31
+ AUTH_LOGGING_WRITE = 'https://www.googleapis.com/auth/logging.write'
35
32
 
36
33
  # View log data for your projects
37
34
  AUTH_LOGGING_READ = 'https://www.googleapis.com/auth/logging.read'
38
35
 
39
- # Submit log data for your projects
40
- AUTH_LOGGING_WRITE = 'https://www.googleapis.com/auth/logging.write'
36
+ # Administrate log data for your projects
37
+ AUTH_LOGGING_ADMIN = 'https://www.googleapis.com/auth/logging.admin'
38
+
39
+ # View your data across Google Cloud Platform services
40
+ AUTH_CLOUD_PLATFORM_READ_ONLY = 'https://www.googleapis.com/auth/cloud-platform.read-only'
41
41
 
42
42
  # View and manage your data across Google Cloud Platform services
43
43
  AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
@@ -22,171 +22,62 @@ module Google
22
22
  module Apis
23
23
  module LoggingV2beta1
24
24
 
25
- # The parameters to WriteLogEntries.
26
- class WriteLogEntriesRequest
25
+ # The parameters to ListLogEntries.
26
+ class ListLogEntriesRequest
27
27
  include Google::Apis::Core::Hashable
28
28
 
29
- # Optional. Whether valid entries should be written even if some other entries
30
- # fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any entry is not
31
- # written, then the response status is the error associated with one of the
32
- # failed entries and the response includes error details keyed by the entries'
33
- # zero-based index in the entries.write method.
34
- # Corresponds to the JSON property `partialSuccess`
35
- # @return [Boolean]
36
- attr_accessor :partial_success
37
- alias_method :partial_success?, :partial_success
38
-
39
- # Optional. Default labels that are added to the labels field of all log entries
40
- # in entries. If a log entry already has a label with the same key as a label in
41
- # this parameter, then the log entry's label is not changed. See LogEntry.
42
- # Corresponds to the JSON property `labels`
43
- # @return [Hash<String,String>]
44
- attr_accessor :labels
45
-
46
- # An object representing a resource that can be used for monitoring, logging,
47
- # billing, or other purposes. Examples include virtual machine instances,
48
- # databases, and storage devices such as disks. The type field identifies a
49
- # MonitoredResourceDescriptor object that describes the resource's schema.
50
- # Information in the labels field identifies the actual resource and its
51
- # attributes according to the schema. For example, a particular Compute Engine
52
- # VM instance could be represented by the following object, because the
53
- # MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "
54
- # zone":
55
- # ` "type": "gce_instance",
56
- # "labels": ` "instance_id": "12345678901234",
57
- # "zone": "us-central1-a" ``
58
- # Corresponds to the JSON property `resource`
59
- # @return [Google::Apis::LoggingV2beta1::MonitoredResource]
60
- attr_accessor :resource
61
-
62
- # Optional. A default log resource name that is assigned to all log entries in
63
- # entries that do not specify a value for log_name:
64
- # "projects/[PROJECT_ID]/logs/[LOG_ID]"
65
- # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
66
- # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
67
- # "folders/[FOLDER_ID]/logs/[LOG_ID]"
68
- # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog"
69
- # or "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%
70
- # 2Factivity". For more information about log names, see LogEntry.
71
- # Corresponds to the JSON property `logName`
29
+ # Optional. How the results should be sorted. Presently, the only permitted
30
+ # values are "timestamp asc" (default) and "timestamp desc". The first option
31
+ # returns entries in order of increasing values of LogEntry.timestamp (oldest
32
+ # first), and the second option returns entries in order of decreasing
33
+ # timestamps (newest first). Entries with equal timestamps are returned in order
34
+ # of their insert_id values.
35
+ # Corresponds to the JSON property `orderBy`
72
36
  # @return [String]
73
- attr_accessor :log_name
74
-
75
- # Required. The log entries to write. Values supplied for the fields log_name,
76
- # resource, and labels in this entries.write request are inserted into those log
77
- # entries in this list that do not provide their own values.Stackdriver Logging
78
- # also creates and inserts values for timestamp and insert_id if the entries do
79
- # not provide them. The created insert_id for the N'th entry in this list will
80
- # be greater than earlier entries and less than later entries. Otherwise, the
81
- # order of log entries in this list does not matter.To improve throughput and to
82
- # avoid exceeding the quota limit for calls to entries.write, you should write
83
- # multiple log entries at once rather than calling this method for each
84
- # individual log entry.
85
- # Corresponds to the JSON property `entries`
86
- # @return [Array<Google::Apis::LoggingV2beta1::LogEntry>]
87
- attr_accessor :entries
88
-
89
- def initialize(**args)
90
- update!(**args)
91
- end
92
-
93
- # Update properties of this object
94
- def update!(**args)
95
- @partial_success = args[:partial_success] if args.key?(:partial_success)
96
- @labels = args[:labels] if args.key?(:labels)
97
- @resource = args[:resource] if args.key?(:resource)
98
- @log_name = args[:log_name] if args.key?(:log_name)
99
- @entries = args[:entries] if args.key?(:entries)
100
- end
101
- end
102
-
103
- # Describes a sink used to export log entries to one of the following
104
- # destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a
105
- # Cloud Pub/Sub topic. A logs filter controls which log entries are exported.
106
- # The sink must be created within a project, organization, billing account, or
107
- # folder.
108
- class LogSink
109
- include Google::Apis::Core::Hashable
37
+ attr_accessor :order_by
110
38
 
111
- # Optional. This field applies only to sinks owned by organizations and folders.
112
- # If the field is false, the default, only the logs owned by the sink's parent
113
- # resource are available for export. If the field is true, then logs from all
114
- # the projects, folders, and billing accounts contained in the sink's parent
115
- # resource are also available for export. Whether a particular log entry from
116
- # the children is exported depends on the sink's filter expression. For example,
117
- # if this field is true, then the filter resource.type=gce_instance would export
118
- # all Compute Engine VM instance log entries from all projects in the sink's
119
- # parent. To only export entries from certain child projects, filter on the
120
- # project part of the log name:
121
- # logName:("projects/test-project1/" OR "projects/test-project2/") AND
122
- # resource.type=gce_instance
123
- # Corresponds to the JSON property `includeChildren`
124
- # @return [Boolean]
125
- attr_accessor :include_children
126
- alias_method :include_children?, :include_children
39
+ # Required. Names of one or more parent resources from which to retrieve log
40
+ # entries:
41
+ # "projects/[PROJECT_ID]"
42
+ # "organizations/[ORGANIZATION_ID]"
43
+ # "billingAccounts/[BILLING_ACCOUNT_ID]"
44
+ # "folders/[FOLDER_ID]"
45
+ # Projects listed in the project_ids field are added to this list.
46
+ # Corresponds to the JSON property `resourceNames`
47
+ # @return [Array<String>]
48
+ attr_accessor :resource_names
127
49
 
128
- # Required. The export destination:
129
- # "storage.googleapis.com/[GCS_BUCKET]"
130
- # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
131
- # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
132
- # The sink's writer_identity, set when the sink is created, must have permission
133
- # to write to the destination or else the log entries are not exported. For more
134
- # information, see Exporting Logs With Sinks.
135
- # Corresponds to the JSON property `destination`
136
- # @return [String]
137
- attr_accessor :destination
50
+ # Deprecated. Use resource_names instead. One or more project identifiers or
51
+ # project numbers from which to retrieve log entries. Example: "my-project-1A".
52
+ # If present, these project identifiers are converted to resource name format
53
+ # and added to the list of resources in resource_names.
54
+ # Corresponds to the JSON property `projectIds`
55
+ # @return [Array<String>]
56
+ attr_accessor :project_ids
138
57
 
139
- # Optional. An advanced logs filter. The only exported log entries are those
140
- # that are in the resource owning the sink and that match the filter. The filter
141
- # must use the log entry format specified by the output_version_format parameter.
142
- # For example, in the v2 format:
143
- # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
58
+ # Optional. A filter that chooses which log entries to return. See Advanced Logs
59
+ # Filters. Only log entries that match the filter are returned. An empty filter
60
+ # matches all log entries in the resources listed in resource_names. Referencing
61
+ # a parent resource that is not listed in resource_names will cause the filter
62
+ # to return no results. The maximum length of the filter is 20000 characters.
144
63
  # Corresponds to the JSON property `filter`
145
64
  # @return [String]
146
65
  attr_accessor :filter
147
66
 
148
- # Optional. The time at which this sink will stop exporting log entries. Log
149
- # entries are exported only if their timestamp is earlier than the end time. If
150
- # this field is not supplied, there is no end time. If both a start time and an
151
- # end time are provided, then the end time must be later than the start time.
152
- # Corresponds to the JSON property `endTime`
153
- # @return [String]
154
- attr_accessor :end_time
155
-
156
- # Output only. An IAM identity&mdash;a service account or group&mdash;under
157
- # which Stackdriver Logging writes the exported log entries to the sink's
158
- # destination. This field is set by sinks.create and sinks.update, based on the
159
- # setting of unique_writer_identity in those methods.Until you grant this
160
- # identity write-access to the destination, log entry exports from this sink
161
- # will fail. For more information, see Granting access for a resource. Consult
162
- # the destination service's documentation to determine the appropriate IAM roles
163
- # to assign to the identity.
164
- # Corresponds to the JSON property `writerIdentity`
165
- # @return [String]
166
- attr_accessor :writer_identity
167
-
168
- # Optional. The time at which this sink will begin exporting log entries. Log
169
- # entries are exported only if their timestamp is not earlier than the start
170
- # time. The default value of this field is the time the sink is created or
171
- # updated.
172
- # Corresponds to the JSON property `startTime`
173
- # @return [String]
174
- attr_accessor :start_time
175
-
176
- # Optional. The log entry format to use for this sink's exported log entries.
177
- # The v2 format is used by default. The v1 format is deprecated and should be
178
- # used only as part of a migration effort to v2. See Migration to the v2 API.
179
- # Corresponds to the JSON property `outputVersionFormat`
67
+ # Optional. If present, then retrieve the next batch of results from the
68
+ # preceding call to this method. page_token must be the value of next_page_token
69
+ # from the previous response. The values of other method parameters should be
70
+ # identical to those in the previous call.
71
+ # Corresponds to the JSON property `pageToken`
180
72
  # @return [String]
181
- attr_accessor :output_version_format
73
+ attr_accessor :page_token
182
74
 
183
- # Required. The client-assigned sink identifier, unique within the project.
184
- # Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100
185
- # characters and can include only the following characters: upper and lower-case
186
- # alphanumeric characters, underscores, hyphens, and periods.
187
- # Corresponds to the JSON property `name`
188
- # @return [String]
189
- attr_accessor :name
75
+ # Optional. The maximum number of results to return from this request. Non-
76
+ # positive values are ignored. The presence of next_page_token in the response
77
+ # indicates that more results might be available.
78
+ # Corresponds to the JSON property `pageSize`
79
+ # @return [Fixnum]
80
+ attr_accessor :page_size
190
81
 
191
82
  def initialize(**args)
192
83
  update!(**args)
@@ -194,261 +85,196 @@ module Google
194
85
 
195
86
  # Update properties of this object
196
87
  def update!(**args)
197
- @include_children = args[:include_children] if args.key?(:include_children)
198
- @destination = args[:destination] if args.key?(:destination)
88
+ @order_by = args[:order_by] if args.key?(:order_by)
89
+ @resource_names = args[:resource_names] if args.key?(:resource_names)
90
+ @project_ids = args[:project_ids] if args.key?(:project_ids)
199
91
  @filter = args[:filter] if args.key?(:filter)
200
- @end_time = args[:end_time] if args.key?(:end_time)
201
- @writer_identity = args[:writer_identity] if args.key?(:writer_identity)
202
- @start_time = args[:start_time] if args.key?(:start_time)
203
- @output_version_format = args[:output_version_format] if args.key?(:output_version_format)
204
- @name = args[:name] if args.key?(:name)
92
+ @page_token = args[:page_token] if args.key?(:page_token)
93
+ @page_size = args[:page_size] if args.key?(:page_size)
205
94
  end
206
95
  end
207
96
 
208
- # Result returned from ListLogs.
209
- class ListLogsResponse
97
+ # Complete log information about a single HTTP request to an App Engine
98
+ # application.
99
+ class RequestLog
210
100
  include Google::Apis::Core::Hashable
211
101
 
212
- # If there might be more results than those appearing in this response, then
213
- # nextPageToken is included. To get the next set of results, call this method
214
- # again using the value of nextPageToken as pageToken.
215
- # Corresponds to the JSON property `nextPageToken`
102
+ # Origin IP address.
103
+ # Corresponds to the JSON property `ip`
216
104
  # @return [String]
217
- attr_accessor :next_page_token
218
-
219
- # A list of log names. For example, "projects/my-project/syslog" or "
220
- # organizations/123/cloudresourcemanager.googleapis.com%2Factivity".
221
- # Corresponds to the JSON property `logNames`
222
- # @return [Array<String>]
223
- attr_accessor :log_names
224
-
225
- def initialize(**args)
226
- update!(**args)
227
- end
228
-
229
- # Update properties of this object
230
- def update!(**args)
231
- @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
232
- @log_names = args[:log_names] if args.key?(:log_names)
233
- end
234
- end
105
+ attr_accessor :ip
235
106
 
236
- # A common proto for logging HTTP requests. Only contains semantics defined by
237
- # the HTTP specification. Product-specific logging information MUST be defined
238
- # in a separate message.
239
- class HttpRequest
240
- include Google::Apis::Core::Hashable
107
+ # Application that handled this request.
108
+ # Corresponds to the JSON property `appId`
109
+ # @return [String]
110
+ attr_accessor :app_id
241
111
 
242
- # The user agent sent by the client. Example: "Mozilla/4.0 (compatible; MSIE 6.0;
243
- # Windows 98; Q312461; .NET CLR 1.0.3705)".
244
- # Corresponds to the JSON property `userAgent`
112
+ # App Engine release version.
113
+ # Corresponds to the JSON property `appEngineRelease`
245
114
  # @return [String]
246
- attr_accessor :user_agent
115
+ attr_accessor :app_engine_release
247
116
 
248
- # The request processing latency on the server, from the time the request was
249
- # received until the response was sent.
250
- # Corresponds to the JSON property `latency`
117
+ # Request method. Example: "GET", "HEAD", "PUT", "POST", "DELETE".
118
+ # Corresponds to the JSON property `method`
251
119
  # @return [String]
252
- attr_accessor :latency
120
+ attr_accessor :method_prop
253
121
 
254
- # The number of HTTP response bytes inserted into cache. Set only when a cache
255
- # fill was attempted.
256
- # Corresponds to the JSON property `cacheFillBytes`
257
- # @return [Fixnum]
258
- attr_accessor :cache_fill_bytes
122
+ # An indication of the relative cost of serving this request.
123
+ # Corresponds to the JSON property `cost`
124
+ # @return [Float]
125
+ attr_accessor :cost
259
126
 
260
- # The request method. Examples: "GET", "HEAD", "PUT", "POST".
261
- # Corresponds to the JSON property `requestMethod`
127
+ # An identifier for the instance that handled the request.
128
+ # Corresponds to the JSON property `instanceId`
262
129
  # @return [String]
263
- attr_accessor :request_method
130
+ attr_accessor :instance_id
264
131
 
265
- # The size of the HTTP response message sent back to the client, in bytes,
266
- # including the response headers and the response body.
267
- # Corresponds to the JSON property `responseSize`
132
+ # Number of CPU megacycles used to process request.
133
+ # Corresponds to the JSON property `megaCycles`
268
134
  # @return [Fixnum]
269
- attr_accessor :response_size
135
+ attr_accessor :mega_cycles
270
136
 
271
- # The size of the HTTP request message in bytes, including the request headers
272
- # and the request body.
273
- # Corresponds to the JSON property `requestSize`
274
- # @return [Fixnum]
275
- attr_accessor :request_size
137
+ # Whether this is the first RequestLog entry for this request. If an active
138
+ # request has several RequestLog entries written to Stackdriver Logging, then
139
+ # this field will be set for one of them.
140
+ # Corresponds to the JSON property `first`
141
+ # @return [Boolean]
142
+ attr_accessor :first
143
+ alias_method :first?, :first
276
144
 
277
- # The scheme (http, https), the host name, the path and the query portion of the
278
- # URL that was requested. Example: "http://example.com/some/info?color=red".
279
- # Corresponds to the JSON property `requestUrl`
145
+ # Version of the application that handled this request.
146
+ # Corresponds to the JSON property `versionId`
280
147
  # @return [String]
281
- attr_accessor :request_url
148
+ attr_accessor :version_id
282
149
 
283
- # The IP address (IPv4 or IPv6) of the origin server that the request was sent
284
- # to.
285
- # Corresponds to the JSON property `serverIp`
150
+ # Module of the application that handled this request.
151
+ # Corresponds to the JSON property `moduleId`
286
152
  # @return [String]
287
- attr_accessor :server_ip
153
+ attr_accessor :module_id
288
154
 
289
- # The IP address (IPv4 or IPv6) of the client that issued the HTTP request.
290
- # Examples: "192.168.1.1", "FE80::0202:B3FF:FE1E:8329".
291
- # Corresponds to the JSON property `remoteIp`
155
+ # Time when the request finished.
156
+ # Corresponds to the JSON property `endTime`
292
157
  # @return [String]
293
- attr_accessor :remote_ip
158
+ attr_accessor :end_time
294
159
 
295
- # Whether or not a cache lookup was attempted.
296
- # Corresponds to the JSON property `cacheLookup`
297
- # @return [Boolean]
298
- attr_accessor :cache_lookup
299
- alias_method :cache_lookup?, :cache_lookup
160
+ # User agent that made the request.
161
+ # Corresponds to the JSON property `userAgent`
162
+ # @return [String]
163
+ attr_accessor :user_agent
300
164
 
301
- # Whether or not an entity was served from cache (with or without validation).
302
- # Corresponds to the JSON property `cacheHit`
165
+ # Whether this was a loading request for the instance.
166
+ # Corresponds to the JSON property `wasLoadingRequest`
303
167
  # @return [Boolean]
304
- attr_accessor :cache_hit
305
- alias_method :cache_hit?, :cache_hit
168
+ attr_accessor :was_loading_request
169
+ alias_method :was_loading_request?, :was_loading_request
306
170
 
307
- # Whether or not the response was validated with the origin server before being
308
- # served from cache. This field is only meaningful if cache_hit is True.
309
- # Corresponds to the JSON property `cacheValidatedWithOriginServer`
310
- # @return [Boolean]
311
- attr_accessor :cache_validated_with_origin_server
312
- alias_method :cache_validated_with_origin_server?, :cache_validated_with_origin_server
171
+ # Source code for the application that handled this request. There can be more
172
+ # than one source reference per deployed application if source code is
173
+ # distributed among multiple repositories.
174
+ # Corresponds to the JSON property `sourceReference`
175
+ # @return [Array<Google::Apis::LoggingV2beta1::SourceReference>]
176
+ attr_accessor :source_reference
313
177
 
314
- # The response code indicating the status of response. Examples: 200, 404.
315
- # Corresponds to the JSON property `status`
178
+ # Size in bytes sent back to client by request.
179
+ # Corresponds to the JSON property `responseSize`
316
180
  # @return [Fixnum]
317
- attr_accessor :status
181
+ attr_accessor :response_size
318
182
 
319
- # The referer URL of the request, as defined in HTTP/1.1 Header Field
320
- # Definitions (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
321
- # Corresponds to the JSON property `referer`
183
+ # Stackdriver Trace identifier for this request.
184
+ # Corresponds to the JSON property `traceId`
322
185
  # @return [String]
323
- attr_accessor :referer
324
-
325
- def initialize(**args)
326
- update!(**args)
327
- end
328
-
329
- # Update properties of this object
330
- def update!(**args)
331
- @user_agent = args[:user_agent] if args.key?(:user_agent)
332
- @latency = args[:latency] if args.key?(:latency)
333
- @cache_fill_bytes = args[:cache_fill_bytes] if args.key?(:cache_fill_bytes)
334
- @request_method = args[:request_method] if args.key?(:request_method)
335
- @response_size = args[:response_size] if args.key?(:response_size)
336
- @request_size = args[:request_size] if args.key?(:request_size)
337
- @request_url = args[:request_url] if args.key?(:request_url)
338
- @server_ip = args[:server_ip] if args.key?(:server_ip)
339
- @remote_ip = args[:remote_ip] if args.key?(:remote_ip)
340
- @cache_lookup = args[:cache_lookup] if args.key?(:cache_lookup)
341
- @cache_hit = args[:cache_hit] if args.key?(:cache_hit)
342
- @cache_validated_with_origin_server = args[:cache_validated_with_origin_server] if args.key?(:cache_validated_with_origin_server)
343
- @status = args[:status] if args.key?(:status)
344
- @referer = args[:referer] if args.key?(:referer)
345
- end
346
- end
186
+ attr_accessor :trace_id
347
187
 
348
- # Result returned from ListSinks.
349
- class ListSinksResponse
350
- include Google::Apis::Core::Hashable
188
+ # A list of log lines emitted by the application while serving this request.
189
+ # Corresponds to the JSON property `line`
190
+ # @return [Array<Google::Apis::LoggingV2beta1::LogLine>]
191
+ attr_accessor :line
351
192
 
352
- # A list of sinks.
353
- # Corresponds to the JSON property `sinks`
354
- # @return [Array<Google::Apis::LoggingV2beta1::LogSink>]
355
- attr_accessor :sinks
193
+ # Referrer URL of request.
194
+ # Corresponds to the JSON property `referrer`
195
+ # @return [String]
196
+ attr_accessor :referrer
356
197
 
357
- # If there might be more results than appear in this response, then
358
- # nextPageToken is included. To get the next set of results, call the same
359
- # method again using the value of nextPageToken as pageToken.
360
- # Corresponds to the JSON property `nextPageToken`
198
+ # Queue name of the request, in the case of an offline request.
199
+ # Corresponds to the JSON property `taskQueueName`
361
200
  # @return [String]
362
- attr_accessor :next_page_token
201
+ attr_accessor :task_queue_name
363
202
 
364
- def initialize(**args)
365
- update!(**args)
366
- end
203
+ # Globally unique identifier for a request, which is based on the request start
204
+ # time. Request IDs for requests which started later will compare greater as
205
+ # strings than those for requests which started earlier.
206
+ # Corresponds to the JSON property `requestId`
207
+ # @return [String]
208
+ attr_accessor :request_id
367
209
 
368
- # Update properties of this object
369
- def update!(**args)
370
- @sinks = args[:sinks] if args.key?(:sinks)
371
- @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
372
- end
373
- end
210
+ # The logged-in user who made the request.Most likely, this is the part of the
211
+ # user's email before the @ sign. The field value is the same for different
212
+ # requests from the same user, but different users can have similar names. This
213
+ # information is also available to the application via the App Engine Users API.
214
+ # This field will be populated starting with App Engine 1.9.21.
215
+ # Corresponds to the JSON property `nickname`
216
+ # @return [String]
217
+ attr_accessor :nickname
374
218
 
375
- # A description of a label.
376
- class LabelDescriptor
377
- include Google::Apis::Core::Hashable
219
+ # HTTP response status code. Example: 200, 404.
220
+ # Corresponds to the JSON property `status`
221
+ # @return [Fixnum]
222
+ attr_accessor :status
378
223
 
379
- # The type of data that can be assigned to the label.
380
- # Corresponds to the JSON property `valueType`
224
+ # Contains the path and query portion of the URL that was requested. For example,
225
+ # if the URL was "http://example.com/app?name=val", the resource would be "/app?
226
+ # name=val". The fragment identifier, which is identified by the # character, is
227
+ # not included.
228
+ # Corresponds to the JSON property `resource`
381
229
  # @return [String]
382
- attr_accessor :value_type
230
+ attr_accessor :resource
383
231
 
384
- # The label key.
385
- # Corresponds to the JSON property `key`
232
+ # Time this request spent in the pending request queue.
233
+ # Corresponds to the JSON property `pendingTime`
386
234
  # @return [String]
387
- attr_accessor :key
235
+ attr_accessor :pending_time
388
236
 
389
- # A human-readable description for the label.
390
- # Corresponds to the JSON property `description`
237
+ # Task name of the request, in the case of an offline request.
238
+ # Corresponds to the JSON property `taskName`
391
239
  # @return [String]
392
- attr_accessor :description
393
-
394
- def initialize(**args)
395
- update!(**args)
396
- end
240
+ attr_accessor :task_name
397
241
 
398
- # Update properties of this object
399
- def update!(**args)
400
- @value_type = args[:value_type] if args.key?(:value_type)
401
- @key = args[:key] if args.key?(:key)
402
- @description = args[:description] if args.key?(:description)
403
- end
404
- end
242
+ # File or class that handled the request.
243
+ # Corresponds to the JSON property `urlMapEntry`
244
+ # @return [String]
245
+ attr_accessor :url_map_entry
405
246
 
406
- # An object that describes the schema of a MonitoredResource object using a type
407
- # name and a set of labels. For example, the monitored resource descriptor for
408
- # Google Compute Engine VM instances has a type of "gce_instance" and specifies
409
- # the use of the labels "instance_id" and "zone" to identify particular VM
410
- # instances.Different APIs can support different monitored resource types. APIs
411
- # generally provide a list method that returns the monitored resource
412
- # descriptors used by the API.
413
- class MonitoredResourceDescriptor
414
- include Google::Apis::Core::Hashable
247
+ # If the instance processing this request belongs to a manually scaled module,
248
+ # then this is the 0-based index of the instance. Otherwise, this value is -1.
249
+ # Corresponds to the JSON property `instanceIndex`
250
+ # @return [Fixnum]
251
+ attr_accessor :instance_index
415
252
 
416
- # Required. A set of labels used to describe instances of this monitored
417
- # resource type. For example, an individual Google Cloud SQL database is
418
- # identified by values for the labels "database_id" and "zone".
419
- # Corresponds to the JSON property `labels`
420
- # @return [Array<Google::Apis::LoggingV2beta1::LabelDescriptor>]
421
- attr_accessor :labels
253
+ # Whether this request is finished or active.
254
+ # Corresponds to the JSON property `finished`
255
+ # @return [Boolean]
256
+ attr_accessor :finished
257
+ alias_method :finished?, :finished
422
258
 
423
- # Optional. The resource name of the monitored resource descriptor: "projects/`
424
- # project_id`/monitoredResourceDescriptors/`type`" where `type` is the value of
425
- # the type field in this object and `project_id` is a project ID that provides
426
- # API-specific context for accessing the type. APIs that do not use project
427
- # information can use the resource name format "monitoredResourceDescriptors/`
428
- # type`".
429
- # Corresponds to the JSON property `name`
259
+ # Internet host and port number of the resource being requested.
260
+ # Corresponds to the JSON property `host`
430
261
  # @return [String]
431
- attr_accessor :name
262
+ attr_accessor :host
432
263
 
433
- # Optional. A concise name for the monitored resource type that might be
434
- # displayed in user interfaces. It should be a Title Cased Noun Phrase, without
435
- # any article or other determiners. For example, "Google Cloud SQL Database".
436
- # Corresponds to the JSON property `displayName`
264
+ # HTTP version of request. Example: "HTTP/1.1".
265
+ # Corresponds to the JSON property `httpVersion`
437
266
  # @return [String]
438
- attr_accessor :display_name
267
+ attr_accessor :http_version
439
268
 
440
- # Optional. A detailed description of the monitored resource type that might be
441
- # used in documentation.
442
- # Corresponds to the JSON property `description`
269
+ # Time when the request started.
270
+ # Corresponds to the JSON property `startTime`
443
271
  # @return [String]
444
- attr_accessor :description
272
+ attr_accessor :start_time
445
273
 
446
- # Required. The monitored resource type. For example, the type "
447
- # cloudsql_database" represents databases in Google Cloud SQL. The maximum
448
- # length of this value is 256 characters.
449
- # Corresponds to the JSON property `type`
274
+ # Latency of the request.
275
+ # Corresponds to the JSON property `latency`
450
276
  # @return [String]
451
- attr_accessor :type
277
+ attr_accessor :latency
452
278
 
453
279
  def initialize(**args)
454
280
  update!(**args)
@@ -456,39 +282,56 @@ module Google
456
282
 
457
283
  # Update properties of this object
458
284
  def update!(**args)
459
- @labels = args[:labels] if args.key?(:labels)
460
- @name = args[:name] if args.key?(:name)
461
- @display_name = args[:display_name] if args.key?(:display_name)
462
- @description = args[:description] if args.key?(:description)
463
- @type = args[:type] if args.key?(:type)
285
+ @ip = args[:ip] if args.key?(:ip)
286
+ @app_id = args[:app_id] if args.key?(:app_id)
287
+ @app_engine_release = args[:app_engine_release] if args.key?(:app_engine_release)
288
+ @method_prop = args[:method_prop] if args.key?(:method_prop)
289
+ @cost = args[:cost] if args.key?(:cost)
290
+ @instance_id = args[:instance_id] if args.key?(:instance_id)
291
+ @mega_cycles = args[:mega_cycles] if args.key?(:mega_cycles)
292
+ @first = args[:first] if args.key?(:first)
293
+ @version_id = args[:version_id] if args.key?(:version_id)
294
+ @module_id = args[:module_id] if args.key?(:module_id)
295
+ @end_time = args[:end_time] if args.key?(:end_time)
296
+ @user_agent = args[:user_agent] if args.key?(:user_agent)
297
+ @was_loading_request = args[:was_loading_request] if args.key?(:was_loading_request)
298
+ @source_reference = args[:source_reference] if args.key?(:source_reference)
299
+ @response_size = args[:response_size] if args.key?(:response_size)
300
+ @trace_id = args[:trace_id] if args.key?(:trace_id)
301
+ @line = args[:line] if args.key?(:line)
302
+ @referrer = args[:referrer] if args.key?(:referrer)
303
+ @task_queue_name = args[:task_queue_name] if args.key?(:task_queue_name)
304
+ @request_id = args[:request_id] if args.key?(:request_id)
305
+ @nickname = args[:nickname] if args.key?(:nickname)
306
+ @status = args[:status] if args.key?(:status)
307
+ @resource = args[:resource] if args.key?(:resource)
308
+ @pending_time = args[:pending_time] if args.key?(:pending_time)
309
+ @task_name = args[:task_name] if args.key?(:task_name)
310
+ @url_map_entry = args[:url_map_entry] if args.key?(:url_map_entry)
311
+ @instance_index = args[:instance_index] if args.key?(:instance_index)
312
+ @finished = args[:finished] if args.key?(:finished)
313
+ @host = args[:host] if args.key?(:host)
314
+ @http_version = args[:http_version] if args.key?(:http_version)
315
+ @start_time = args[:start_time] if args.key?(:start_time)
316
+ @latency = args[:latency] if args.key?(:latency)
464
317
  end
465
318
  end
466
319
 
467
- # Additional information about the source code location that produced the log
468
- # entry.
469
- class LogEntrySourceLocation
320
+ # Result returned from ListMonitoredResourceDescriptors.
321
+ class ListMonitoredResourceDescriptorsResponse
470
322
  include Google::Apis::Core::Hashable
471
323
 
472
- # Optional. Source file name. Depending on the runtime environment, this might
473
- # be a simple name or a fully-qualified name.
474
- # Corresponds to the JSON property `file`
475
- # @return [String]
476
- attr_accessor :file
477
-
478
- # Optional. Human-readable name of the function or method being invoked, with
479
- # optional context such as the class or package name. This information may be
480
- # used in contexts such as the logs viewer, where a file and line number are
481
- # less meaningful. The format can vary by language. For example: qual.if.ied.
482
- # Class.method (Java), dir/package.func (Go), function (Python).
483
- # Corresponds to the JSON property `function`
324
+ # If there might be more results than those appearing in this response, then
325
+ # nextPageToken is included. To get the next set of results, call this method
326
+ # again using the value of nextPageToken as pageToken.
327
+ # Corresponds to the JSON property `nextPageToken`
484
328
  # @return [String]
485
- attr_accessor :function
329
+ attr_accessor :next_page_token
486
330
 
487
- # Optional. Line within the source file. 1-based; 0 indicates no line number
488
- # available.
489
- # Corresponds to the JSON property `line`
490
- # @return [Fixnum]
491
- attr_accessor :line
331
+ # A list of resource descriptors.
332
+ # Corresponds to the JSON property `resourceDescriptors`
333
+ # @return [Array<Google::Apis::LoggingV2beta1::MonitoredResourceDescriptor>]
334
+ attr_accessor :resource_descriptors
492
335
 
493
336
  def initialize(**args)
494
337
  update!(**args)
@@ -496,33 +339,27 @@ module Google
496
339
 
497
340
  # Update properties of this object
498
341
  def update!(**args)
499
- @file = args[:file] if args.key?(:file)
500
- @function = args[:function] if args.key?(:function)
501
- @line = args[:line] if args.key?(:line)
342
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
343
+ @resource_descriptors = args[:resource_descriptors] if args.key?(:resource_descriptors)
502
344
  end
503
345
  end
504
346
 
505
- # Result returned from ListLogEntries.
506
- class ListLogEntriesResponse
347
+ # A reference to a particular snapshot of the source tree used to build and
348
+ # deploy an application.
349
+ class SourceReference
507
350
  include Google::Apis::Core::Hashable
508
351
 
509
- # A list of log entries.
510
- # Corresponds to the JSON property `entries`
511
- # @return [Array<Google::Apis::LoggingV2beta1::LogEntry>]
512
- attr_accessor :entries
352
+ # The canonical and persistent identifier of the deployed revision. Example (git)
353
+ # : "0035781c50ec7aa23385dc841529ce8a4b70db1b"
354
+ # Corresponds to the JSON property `revisionId`
355
+ # @return [String]
356
+ attr_accessor :revision_id
513
357
 
514
- # If there might be more results than those appearing in this response, then
515
- # nextPageToken is included. To get the next set of results, call this method
516
- # again using the value of nextPageToken as pageToken.If a value for
517
- # next_page_token appears and the entries field is empty, it means that the
518
- # search found no log entries so far but it did not have time to search all the
519
- # possible log entries. Retry the method with this value for page_token to
520
- # continue the search. Alternatively, consider speeding up the search by
521
- # changing your filter to specify a single log name or resource type, or to
522
- # narrow the time range of the search.
523
- # Corresponds to the JSON property `nextPageToken`
358
+ # Optional. A URI string identifying the repository. Example: "https://github.
359
+ # com/GoogleCloudPlatform/kubernetes.git"
360
+ # Corresponds to the JSON property `repository`
524
361
  # @return [String]
525
- attr_accessor :next_page_token
362
+ attr_accessor :repository
526
363
 
527
364
  def initialize(**args)
528
365
  update!(**args)
@@ -530,34 +367,47 @@ module Google
530
367
 
531
368
  # Update properties of this object
532
369
  def update!(**args)
533
- @entries = args[:entries] if args.key?(:entries)
534
- @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
370
+ @revision_id = args[:revision_id] if args.key?(:revision_id)
371
+ @repository = args[:repository] if args.key?(:repository)
535
372
  end
536
373
  end
537
374
 
538
- # Application log line emitted while processing a request.
539
- class LogLine
375
+ # Describes a logs-based metric. The value of the metric is the number of log
376
+ # entries that match a logs filter in a given time interval.
377
+ class LogMetric
540
378
  include Google::Apis::Core::Hashable
541
379
 
542
- # Severity of this log entry.
543
- # Corresponds to the JSON property `severity`
380
+ # Required. An advanced logs filter which is used to match log entries. Example:
381
+ # "resource.type=gae_app AND severity>=ERROR"
382
+ # The maximum length of the filter is 20000 characters.
383
+ # Corresponds to the JSON property `filter`
544
384
  # @return [String]
545
- attr_accessor :severity
385
+ attr_accessor :filter
546
386
 
547
- # App-provided log message.
548
- # Corresponds to the JSON property `logMessage`
387
+ # Required. The client-assigned metric identifier. Examples: "error_count", "
388
+ # nginx/requests".Metric identifiers are limited to 100 characters and can
389
+ # include only the following characters: A-Z, a-z, 0-9, and the special
390
+ # characters _-.,+!*',()%/. The forward-slash character (/) denotes a hierarchy
391
+ # of name pieces, and it cannot be the first character of the name.The metric
392
+ # identifier in this field must not be URL-encoded (https://en.wikipedia.org/
393
+ # wiki/Percent-encoding). However, when the metric identifier appears as the [
394
+ # METRIC_ID] part of a metric_name API parameter, then the metric identifier
395
+ # must be URL-encoded. Example: "projects/my-project/metrics/nginx%2Frequests".
396
+ # Corresponds to the JSON property `name`
549
397
  # @return [String]
550
- attr_accessor :log_message
398
+ attr_accessor :name
551
399
 
552
- # Specifies a location in a source code file.
553
- # Corresponds to the JSON property `sourceLocation`
554
- # @return [Google::Apis::LoggingV2beta1::SourceLocation]
555
- attr_accessor :source_location
400
+ # Optional. A description of this metric, which is used in documentation.
401
+ # Corresponds to the JSON property `description`
402
+ # @return [String]
403
+ attr_accessor :description
556
404
 
557
- # Approximate time when this log entry was made.
558
- # Corresponds to the JSON property `time`
405
+ # Output only. The API version that created or updated this metric. The version
406
+ # also dictates the syntax of the filter expression. When a value for this field
407
+ # is missing, the default value of V2 should be assumed.
408
+ # Corresponds to the JSON property `version`
559
409
  # @return [String]
560
- attr_accessor :time
410
+ attr_accessor :version
561
411
 
562
412
  def initialize(**args)
563
413
  update!(**args)
@@ -565,120 +415,119 @@ module Google
565
415
 
566
416
  # Update properties of this object
567
417
  def update!(**args)
568
- @severity = args[:severity] if args.key?(:severity)
569
- @log_message = args[:log_message] if args.key?(:log_message)
570
- @source_location = args[:source_location] if args.key?(:source_location)
571
- @time = args[:time] if args.key?(:time)
418
+ @filter = args[:filter] if args.key?(:filter)
419
+ @name = args[:name] if args.key?(:name)
420
+ @description = args[:description] if args.key?(:description)
421
+ @version = args[:version] if args.key?(:version)
572
422
  end
573
423
  end
574
424
 
575
- # Result returned from ListLogMetrics.
576
- class ListLogMetricsResponse
425
+ # Result returned from WriteLogEntries. empty
426
+ class WriteLogEntriesResponse
577
427
  include Google::Apis::Core::Hashable
578
428
 
579
- # If there might be more results than appear in this response, then
580
- # nextPageToken is included. To get the next set of results, call this method
581
- # again using the value of nextPageToken as pageToken.
582
- # Corresponds to the JSON property `nextPageToken`
583
- # @return [String]
584
- attr_accessor :next_page_token
585
-
586
- # A list of logs-based metrics.
587
- # Corresponds to the JSON property `metrics`
588
- # @return [Array<Google::Apis::LoggingV2beta1::LogMetric>]
589
- attr_accessor :metrics
590
-
591
429
  def initialize(**args)
592
430
  update!(**args)
593
431
  end
594
432
 
595
433
  # Update properties of this object
596
434
  def update!(**args)
597
- @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
598
- @metrics = args[:metrics] if args.key?(:metrics)
599
435
  end
600
436
  end
601
437
 
602
- # A generic empty message that you can re-use to avoid defining duplicated empty
603
- # messages in your APIs. A typical example is to use it as the request or the
604
- # response type of an API method. For instance:
605
- # service Foo `
606
- # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
607
- # `
608
- # The JSON representation for Empty is empty JSON object ``.
609
- class Empty
438
+ # Additional information about a potentially long-running operation with which a
439
+ # log entry is associated.
440
+ class LogEntryOperation
610
441
  include Google::Apis::Core::Hashable
611
442
 
443
+ # Optional. Set this to True if this is the first log entry in the operation.
444
+ # Corresponds to the JSON property `first`
445
+ # @return [Boolean]
446
+ attr_accessor :first
447
+ alias_method :first?, :first
448
+
449
+ # Optional. An arbitrary producer identifier. The combination of id and producer
450
+ # must be globally unique. Examples for producer: "MyDivision.MyBigCompany.com",
451
+ # "github.com/MyProject/MyApplication".
452
+ # Corresponds to the JSON property `producer`
453
+ # @return [String]
454
+ attr_accessor :producer
455
+
456
+ # Optional. Set this to True if this is the last log entry in the operation.
457
+ # Corresponds to the JSON property `last`
458
+ # @return [Boolean]
459
+ attr_accessor :last
460
+ alias_method :last?, :last
461
+
462
+ # Optional. An arbitrary operation identifier. Log entries with the same
463
+ # identifier are assumed to be part of the same operation.
464
+ # Corresponds to the JSON property `id`
465
+ # @return [String]
466
+ attr_accessor :id
467
+
612
468
  def initialize(**args)
613
469
  update!(**args)
614
470
  end
615
471
 
616
472
  # Update properties of this object
617
473
  def update!(**args)
474
+ @first = args[:first] if args.key?(:first)
475
+ @producer = args[:producer] if args.key?(:producer)
476
+ @last = args[:last] if args.key?(:last)
477
+ @id = args[:id] if args.key?(:id)
618
478
  end
619
479
  end
620
480
 
621
- # An individual entry in a log.
622
- class LogEntry
481
+ # An object representing a resource that can be used for monitoring, logging,
482
+ # billing, or other purposes. Examples include virtual machine instances,
483
+ # databases, and storage devices such as disks. The type field identifies a
484
+ # MonitoredResourceDescriptor object that describes the resource's schema.
485
+ # Information in the labels field identifies the actual resource and its
486
+ # attributes according to the schema. For example, a particular Compute Engine
487
+ # VM instance could be represented by the following object, because the
488
+ # MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "
489
+ # zone":
490
+ # ` "type": "gce_instance",
491
+ # "labels": ` "instance_id": "12345678901234",
492
+ # "zone": "us-central1-a" ``
493
+ class MonitoredResource
623
494
  include Google::Apis::Core::Hashable
624
495
 
625
- # Optional. A set of user-defined (key, value) data that provides additional
626
- # information about the log entry.
496
+ # Required. Values for all of the labels listed in the associated monitored
497
+ # resource descriptor. For example, Compute Engine VM instances use the labels "
498
+ # project_id", "instance_id", and "zone".
627
499
  # Corresponds to the JSON property `labels`
628
500
  # @return [Hash<String,String>]
629
501
  attr_accessor :labels
630
502
 
631
- # Optional. Resource name of the trace associated with the log entry, if any. If
632
- # it contains a relative resource name, the name is assumed to be relative to //
633
- # tracing.googleapis.com. Example: projects/my-projectid/traces/
634
- # 06796866738c859f2f19b7cfb3214824
635
- # Corresponds to the JSON property `trace`
636
- # @return [String]
637
- attr_accessor :trace
638
-
639
- # Optional. The severity of the log entry. The default value is LogSeverity.
640
- # DEFAULT.
641
- # Corresponds to the JSON property `severity`
642
- # @return [String]
643
- attr_accessor :severity
644
-
645
- # Additional information about the source code location that produced the log
646
- # entry.
647
- # Corresponds to the JSON property `sourceLocation`
648
- # @return [Google::Apis::LoggingV2beta1::LogEntrySourceLocation]
649
- attr_accessor :source_location
650
-
651
- # Optional. The time the event described by the log entry occurred. If omitted
652
- # in a new log entry, Stackdriver Logging will insert the time the log entry is
653
- # received. Stackdriver Logging might reject log entries whose time stamps are
654
- # more than a couple of hours in the future. Log entries with time stamps in the
655
- # past are accepted.
656
- # Corresponds to the JSON property `timestamp`
503
+ # Required. The monitored resource type. This field must match the type field of
504
+ # a MonitoredResourceDescriptor object. For example, the type of a Compute
505
+ # Engine VM instance is gce_instance.
506
+ # Corresponds to the JSON property `type`
657
507
  # @return [String]
658
- attr_accessor :timestamp
508
+ attr_accessor :type
659
509
 
660
- # Output only. The time the log entry was received by Stackdriver Logging.
661
- # Corresponds to the JSON property `receiveTimestamp`
662
- # @return [String]
663
- attr_accessor :receive_timestamp
510
+ def initialize(**args)
511
+ update!(**args)
512
+ end
664
513
 
665
- # Required. The resource name of the log to which this log entry belongs:
666
- # "projects/[PROJECT_ID]/logs/[LOG_ID]"
667
- # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
668
- # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
669
- # "folders/[FOLDER_ID]/logs/[LOG_ID]"
670
- # [LOG_ID] must be URL-encoded within log_name. Example: "organizations/
671
- # 1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". [LOG_ID] must
672
- # be less than 512 characters long and can only include the following characters:
673
- # upper and lower case alphanumeric characters, forward-slash, underscore,
674
- # hyphen, and period.For backward compatibility, if log_name begins with a
675
- # forward-slash, such as /projects/..., then the log entry is ingested as usual
676
- # but the forward-slash is removed. Listing the log entry will not show the
677
- # leading slash and filtering for a log name with a leading slash will never
678
- # return any results.
679
- # Corresponds to the JSON property `logName`
680
- # @return [String]
681
- attr_accessor :log_name
514
+ # Update properties of this object
515
+ def update!(**args)
516
+ @labels = args[:labels] if args.key?(:labels)
517
+ @type = args[:type] if args.key?(:type)
518
+ end
519
+ end
520
+
521
+ # The parameters to WriteLogEntries.
522
+ class WriteLogEntriesRequest
523
+ include Google::Apis::Core::Hashable
524
+
525
+ # Optional. Default labels that are added to the labels field of all log entries
526
+ # in entries. If a log entry already has a label with the same key as a label in
527
+ # this parameter, then the log entry's label is not changed. See LogEntry.
528
+ # Corresponds to the JSON property `labels`
529
+ # @return [Hash<String,String>]
530
+ attr_accessor :labels
682
531
 
683
532
  # An object representing a resource that can be used for monitoring, logging,
684
533
  # billing, or other purposes. Examples include virtual machine instances,
@@ -696,45 +545,42 @@ module Google
696
545
  # @return [Google::Apis::LoggingV2beta1::MonitoredResource]
697
546
  attr_accessor :resource
698
547
 
699
- # A common proto for logging HTTP requests. Only contains semantics defined by
700
- # the HTTP specification. Product-specific logging information MUST be defined
701
- # in a separate message.
702
- # Corresponds to the JSON property `httpRequest`
703
- # @return [Google::Apis::LoggingV2beta1::HttpRequest]
704
- attr_accessor :http_request
705
-
706
- # The log entry payload, represented as a structure that is expressed as a JSON
707
- # object.
708
- # Corresponds to the JSON property `jsonPayload`
709
- # @return [Hash<String,Object>]
710
- attr_accessor :json_payload
711
-
712
- # Additional information about a potentially long-running operation with which a
713
- # log entry is associated.
714
- # Corresponds to the JSON property `operation`
715
- # @return [Google::Apis::LoggingV2beta1::LogEntryOperation]
716
- attr_accessor :operation
717
-
718
- # Optional. A unique identifier for the log entry. If you provide a value, then
719
- # Stackdriver Logging considers other log entries in the same project, with the
720
- # same timestamp, and with the same insert_id to be duplicates which can be
721
- # removed. If omitted in new log entries, then Stackdriver Logging will insert
722
- # its own unique identifier. The insert_id is used to order log entries that
723
- # have the same timestamp value.
724
- # Corresponds to the JSON property `insertId`
725
- # @return [String]
726
- attr_accessor :insert_id
548
+ # Required. The log entries to write. Values supplied for the fields log_name,
549
+ # resource, and labels in this entries.write request are inserted into those log
550
+ # entries in this list that do not provide their own values.Stackdriver Logging
551
+ # also creates and inserts values for timestamp and insert_id if the entries do
552
+ # not provide them. The created insert_id for the N'th entry in this list will
553
+ # be greater than earlier entries and less than later entries. Otherwise, the
554
+ # order of log entries in this list does not matter.To improve throughput and to
555
+ # avoid exceeding the quota limit for calls to entries.write, you should write
556
+ # multiple log entries at once rather than calling this method for each
557
+ # individual log entry.
558
+ # Corresponds to the JSON property `entries`
559
+ # @return [Array<Google::Apis::LoggingV2beta1::LogEntry>]
560
+ attr_accessor :entries
727
561
 
728
- # The log entry payload, represented as a Unicode string (UTF-8).
729
- # Corresponds to the JSON property `textPayload`
562
+ # Optional. A default log resource name that is assigned to all log entries in
563
+ # entries that do not specify a value for log_name:
564
+ # "projects/[PROJECT_ID]/logs/[LOG_ID]"
565
+ # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
566
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
567
+ # "folders/[FOLDER_ID]/logs/[LOG_ID]"
568
+ # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog"
569
+ # or "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%
570
+ # 2Factivity". For more information about log names, see LogEntry.
571
+ # Corresponds to the JSON property `logName`
730
572
  # @return [String]
731
- attr_accessor :text_payload
573
+ attr_accessor :log_name
732
574
 
733
- # The log entry payload, represented as a protocol buffer. Some Google Cloud
734
- # Platform services use this field for their log entry payloads.
735
- # Corresponds to the JSON property `protoPayload`
736
- # @return [Hash<String,Object>]
737
- attr_accessor :proto_payload
575
+ # Optional. Whether valid entries should be written even if some other entries
576
+ # fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any entry is not
577
+ # written, then the response status is the error associated with one of the
578
+ # failed entries and the response includes error details keyed by the entries'
579
+ # zero-based index in the entries.write method.
580
+ # Corresponds to the JSON property `partialSuccess`
581
+ # @return [Boolean]
582
+ attr_accessor :partial_success
583
+ alias_method :partial_success?, :partial_success
738
584
 
739
585
  def initialize(**args)
740
586
  update!(**args)
@@ -743,114 +589,100 @@ module Google
743
589
  # Update properties of this object
744
590
  def update!(**args)
745
591
  @labels = args[:labels] if args.key?(:labels)
746
- @trace = args[:trace] if args.key?(:trace)
747
- @severity = args[:severity] if args.key?(:severity)
748
- @source_location = args[:source_location] if args.key?(:source_location)
749
- @timestamp = args[:timestamp] if args.key?(:timestamp)
750
- @receive_timestamp = args[:receive_timestamp] if args.key?(:receive_timestamp)
751
- @log_name = args[:log_name] if args.key?(:log_name)
752
592
  @resource = args[:resource] if args.key?(:resource)
753
- @http_request = args[:http_request] if args.key?(:http_request)
754
- @json_payload = args[:json_payload] if args.key?(:json_payload)
755
- @operation = args[:operation] if args.key?(:operation)
756
- @insert_id = args[:insert_id] if args.key?(:insert_id)
757
- @text_payload = args[:text_payload] if args.key?(:text_payload)
758
- @proto_payload = args[:proto_payload] if args.key?(:proto_payload)
593
+ @entries = args[:entries] if args.key?(:entries)
594
+ @log_name = args[:log_name] if args.key?(:log_name)
595
+ @partial_success = args[:partial_success] if args.key?(:partial_success)
759
596
  end
760
597
  end
761
598
 
762
- # Specifies a location in a source code file.
763
- class SourceLocation
599
+ # Describes a sink used to export log entries to one of the following
600
+ # destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a
601
+ # Cloud Pub/Sub topic. A logs filter controls which log entries are exported.
602
+ # The sink must be created within a project, organization, billing account, or
603
+ # folder.
604
+ class LogSink
764
605
  include Google::Apis::Core::Hashable
765
606
 
766
- # Line within the source file.
767
- # Corresponds to the JSON property `line`
768
- # @return [Fixnum]
769
- attr_accessor :line
770
-
771
- # Source file name. Depending on the runtime environment, this might be a simple
772
- # name or a fully-qualified name.
773
- # Corresponds to the JSON property `file`
774
- # @return [String]
775
- attr_accessor :file
607
+ # Optional. This field applies only to sinks owned by organizations and folders.
608
+ # If the field is false, the default, only the logs owned by the sink's parent
609
+ # resource are available for export. If the field is true, then logs from all
610
+ # the projects, folders, and billing accounts contained in the sink's parent
611
+ # resource are also available for export. Whether a particular log entry from
612
+ # the children is exported depends on the sink's filter expression. For example,
613
+ # if this field is true, then the filter resource.type=gce_instance would export
614
+ # all Compute Engine VM instance log entries from all projects in the sink's
615
+ # parent. To only export entries from certain child projects, filter on the
616
+ # project part of the log name:
617
+ # logName:("projects/test-project1/" OR "projects/test-project2/") AND
618
+ # resource.type=gce_instance
619
+ # Corresponds to the JSON property `includeChildren`
620
+ # @return [Boolean]
621
+ attr_accessor :include_children
622
+ alias_method :include_children?, :include_children
776
623
 
777
- # Human-readable name of the function or method being invoked, with optional
778
- # context such as the class or package name. This information is used in
779
- # contexts such as the logs viewer, where a file and line number are less
780
- # meaningful. The format can vary by language. For example: qual.if.ied.Class.
781
- # method (Java), dir/package.func (Go), function (Python).
782
- # Corresponds to the JSON property `functionName`
624
+ # Required. The export destination:
625
+ # "storage.googleapis.com/[GCS_BUCKET]"
626
+ # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
627
+ # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
628
+ # The sink's writer_identity, set when the sink is created, must have permission
629
+ # to write to the destination or else the log entries are not exported. For more
630
+ # information, see Exporting Logs With Sinks.
631
+ # Corresponds to the JSON property `destination`
783
632
  # @return [String]
784
- attr_accessor :function_name
785
-
786
- def initialize(**args)
787
- update!(**args)
788
- end
789
-
790
- # Update properties of this object
791
- def update!(**args)
792
- @line = args[:line] if args.key?(:line)
793
- @file = args[:file] if args.key?(:file)
794
- @function_name = args[:function_name] if args.key?(:function_name)
795
- end
796
- end
797
-
798
- # The parameters to ListLogEntries.
799
- class ListLogEntriesRequest
800
- include Google::Apis::Core::Hashable
633
+ attr_accessor :destination
801
634
 
802
- # Optional. A filter that chooses which log entries to return. See Advanced Logs
803
- # Filters. Only log entries that match the filter are returned. An empty filter
804
- # matches all log entries in the resources listed in resource_names. Referencing
805
- # a parent resource that is not listed in resource_names will cause the filter
806
- # to return no results. The maximum length of the filter is 20000 characters.
635
+ # Optional. An advanced logs filter. The only exported log entries are those
636
+ # that are in the resource owning the sink and that match the filter. The filter
637
+ # must use the log entry format specified by the output_version_format parameter.
638
+ # For example, in the v2 format:
639
+ # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
807
640
  # Corresponds to the JSON property `filter`
808
641
  # @return [String]
809
642
  attr_accessor :filter
810
643
 
811
- # Deprecated. Use resource_names instead. One or more project identifiers or
812
- # project numbers from which to retrieve log entries. Example: "my-project-1A".
813
- # If present, these project identifiers are converted to resource name format
814
- # and added to the list of resources in resource_names.
815
- # Corresponds to the JSON property `projectIds`
816
- # @return [Array<String>]
817
- attr_accessor :project_ids
644
+ # Optional. The time at which this sink will stop exporting log entries. Log
645
+ # entries are exported only if their timestamp is earlier than the end time. If
646
+ # this field is not supplied, there is no end time. If both a start time and an
647
+ # end time are provided, then the end time must be later than the start time.
648
+ # Corresponds to the JSON property `endTime`
649
+ # @return [String]
650
+ attr_accessor :end_time
818
651
 
819
- # Optional. If present, then retrieve the next batch of results from the
820
- # preceding call to this method. page_token must be the value of next_page_token
821
- # from the previous response. The values of other method parameters should be
822
- # identical to those in the previous call.
823
- # Corresponds to the JSON property `pageToken`
652
+ # Optional. The time at which this sink will begin exporting log entries. Log
653
+ # entries are exported only if their timestamp is not earlier than the start
654
+ # time. The default value of this field is the time the sink is created or
655
+ # updated.
656
+ # Corresponds to the JSON property `startTime`
824
657
  # @return [String]
825
- attr_accessor :page_token
658
+ attr_accessor :start_time
826
659
 
827
- # Optional. The maximum number of results to return from this request. Non-
828
- # positive values are ignored. The presence of next_page_token in the response
829
- # indicates that more results might be available.
830
- # Corresponds to the JSON property `pageSize`
831
- # @return [Fixnum]
832
- attr_accessor :page_size
660
+ # Output only. An IAM identity&mdash;a service account or group&mdash;under
661
+ # which Stackdriver Logging writes the exported log entries to the sink's
662
+ # destination. This field is set by sinks.create and sinks.update, based on the
663
+ # setting of unique_writer_identity in those methods.Until you grant this
664
+ # identity write-access to the destination, log entry exports from this sink
665
+ # will fail. For more information, see Granting access for a resource. Consult
666
+ # the destination service's documentation to determine the appropriate IAM roles
667
+ # to assign to the identity.
668
+ # Corresponds to the JSON property `writerIdentity`
669
+ # @return [String]
670
+ attr_accessor :writer_identity
833
671
 
834
- # Optional. How the results should be sorted. Presently, the only permitted
835
- # values are "timestamp asc" (default) and "timestamp desc". The first option
836
- # returns entries in order of increasing values of LogEntry.timestamp (oldest
837
- # first), and the second option returns entries in order of decreasing
838
- # timestamps (newest first). Entries with equal timestamps are returned in order
839
- # of their insert_id values.
840
- # Corresponds to the JSON property `orderBy`
672
+ # Optional. The log entry format to use for this sink's exported log entries.
673
+ # The v2 format is used by default. The v1 format is deprecated and should be
674
+ # used only as part of a migration effort to v2. See Migration to the v2 API.
675
+ # Corresponds to the JSON property `outputVersionFormat`
841
676
  # @return [String]
842
- attr_accessor :order_by
677
+ attr_accessor :output_version_format
843
678
 
844
- # Required. Names of one or more parent resources from which to retrieve log
845
- # entries:
846
- # "projects/[PROJECT_ID]"
847
- # "organizations/[ORGANIZATION_ID]"
848
- # "billingAccounts/[BILLING_ACCOUNT_ID]"
849
- # "folders/[FOLDER_ID]"
850
- # Projects listed in the project_ids field are added to this list.
851
- # Corresponds to the JSON property `resourceNames`
852
- # @return [Array<String>]
853
- attr_accessor :resource_names
679
+ # Required. The client-assigned sink identifier, unique within the project.
680
+ # Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100
681
+ # characters and can include only the following characters: upper and lower-case
682
+ # alphanumeric characters, underscores, hyphens, and periods.
683
+ # Corresponds to the JSON property `name`
684
+ # @return [String]
685
+ attr_accessor :name
854
686
 
855
687
  def initialize(**args)
856
688
  update!(**args)
@@ -858,196 +690,301 @@ module Google
858
690
 
859
691
  # Update properties of this object
860
692
  def update!(**args)
693
+ @include_children = args[:include_children] if args.key?(:include_children)
694
+ @destination = args[:destination] if args.key?(:destination)
861
695
  @filter = args[:filter] if args.key?(:filter)
862
- @project_ids = args[:project_ids] if args.key?(:project_ids)
863
- @page_token = args[:page_token] if args.key?(:page_token)
864
- @page_size = args[:page_size] if args.key?(:page_size)
865
- @order_by = args[:order_by] if args.key?(:order_by)
866
- @resource_names = args[:resource_names] if args.key?(:resource_names)
696
+ @end_time = args[:end_time] if args.key?(:end_time)
697
+ @start_time = args[:start_time] if args.key?(:start_time)
698
+ @writer_identity = args[:writer_identity] if args.key?(:writer_identity)
699
+ @output_version_format = args[:output_version_format] if args.key?(:output_version_format)
700
+ @name = args[:name] if args.key?(:name)
867
701
  end
868
702
  end
869
703
 
870
- # Complete log information about a single HTTP request to an App Engine
871
- # application.
872
- class RequestLog
704
+ # Result returned from ListLogs.
705
+ class ListLogsResponse
873
706
  include Google::Apis::Core::Hashable
874
707
 
875
- # Module of the application that handled this request.
876
- # Corresponds to the JSON property `moduleId`
708
+ # If there might be more results than those appearing in this response, then
709
+ # nextPageToken is included. To get the next set of results, call this method
710
+ # again using the value of nextPageToken as pageToken.
711
+ # Corresponds to the JSON property `nextPageToken`
877
712
  # @return [String]
878
- attr_accessor :module_id
713
+ attr_accessor :next_page_token
879
714
 
880
- # Time when the request finished.
881
- # Corresponds to the JSON property `endTime`
882
- # @return [String]
883
- attr_accessor :end_time
715
+ # A list of log names. For example, "projects/my-project/syslog" or "
716
+ # organizations/123/cloudresourcemanager.googleapis.com%2Factivity".
717
+ # Corresponds to the JSON property `logNames`
718
+ # @return [Array<String>]
719
+ attr_accessor :log_names
884
720
 
885
- # User agent that made the request.
886
- # Corresponds to the JSON property `userAgent`
887
- # @return [String]
888
- attr_accessor :user_agent
721
+ def initialize(**args)
722
+ update!(**args)
723
+ end
889
724
 
890
- # Whether this was a loading request for the instance.
891
- # Corresponds to the JSON property `wasLoadingRequest`
725
+ # Update properties of this object
726
+ def update!(**args)
727
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
728
+ @log_names = args[:log_names] if args.key?(:log_names)
729
+ end
730
+ end
731
+
732
+ # A common proto for logging HTTP requests. Only contains semantics defined by
733
+ # the HTTP specification. Product-specific logging information MUST be defined
734
+ # in a separate message.
735
+ class HttpRequest
736
+ include Google::Apis::Core::Hashable
737
+
738
+ # Whether or not a cache lookup was attempted.
739
+ # Corresponds to the JSON property `cacheLookup`
892
740
  # @return [Boolean]
893
- attr_accessor :was_loading_request
894
- alias_method :was_loading_request?, :was_loading_request
741
+ attr_accessor :cache_lookup
742
+ alias_method :cache_lookup?, :cache_lookup
895
743
 
896
- # Source code for the application that handled this request. There can be more
897
- # than one source reference per deployed application if source code is
898
- # distributed among multiple repositories.
899
- # Corresponds to the JSON property `sourceReference`
900
- # @return [Array<Google::Apis::LoggingV2beta1::SourceReference>]
901
- attr_accessor :source_reference
744
+ # Whether or not an entity was served from cache (with or without validation).
745
+ # Corresponds to the JSON property `cacheHit`
746
+ # @return [Boolean]
747
+ attr_accessor :cache_hit
748
+ alias_method :cache_hit?, :cache_hit
902
749
 
903
- # Size in bytes sent back to client by request.
904
- # Corresponds to the JSON property `responseSize`
750
+ # Whether or not the response was validated with the origin server before being
751
+ # served from cache. This field is only meaningful if cache_hit is True.
752
+ # Corresponds to the JSON property `cacheValidatedWithOriginServer`
753
+ # @return [Boolean]
754
+ attr_accessor :cache_validated_with_origin_server
755
+ alias_method :cache_validated_with_origin_server?, :cache_validated_with_origin_server
756
+
757
+ # The response code indicating the status of response. Examples: 200, 404.
758
+ # Corresponds to the JSON property `status`
905
759
  # @return [Fixnum]
906
- attr_accessor :response_size
760
+ attr_accessor :status
907
761
 
908
- # Stackdriver Trace identifier for this request.
909
- # Corresponds to the JSON property `traceId`
762
+ # The referer URL of the request, as defined in HTTP/1.1 Header Field
763
+ # Definitions (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
764
+ # Corresponds to the JSON property `referer`
910
765
  # @return [String]
911
- attr_accessor :trace_id
912
-
913
- # A list of log lines emitted by the application while serving this request.
914
- # Corresponds to the JSON property `line`
915
- # @return [Array<Google::Apis::LoggingV2beta1::LogLine>]
916
- attr_accessor :line
766
+ attr_accessor :referer
917
767
 
918
- # Referrer URL of request.
919
- # Corresponds to the JSON property `referrer`
768
+ # The user agent sent by the client. Example: "Mozilla/4.0 (compatible; MSIE 6.0;
769
+ # Windows 98; Q312461; .NET CLR 1.0.3705)".
770
+ # Corresponds to the JSON property `userAgent`
920
771
  # @return [String]
921
- attr_accessor :referrer
772
+ attr_accessor :user_agent
922
773
 
923
- # Queue name of the request, in the case of an offline request.
924
- # Corresponds to the JSON property `taskQueueName`
774
+ # The request processing latency on the server, from the time the request was
775
+ # received until the response was sent.
776
+ # Corresponds to the JSON property `latency`
925
777
  # @return [String]
926
- attr_accessor :task_queue_name
778
+ attr_accessor :latency
927
779
 
928
- # Globally unique identifier for a request, which is based on the request start
929
- # time. Request IDs for requests which started later will compare greater as
930
- # strings than those for requests which started earlier.
931
- # Corresponds to the JSON property `requestId`
932
- # @return [String]
933
- attr_accessor :request_id
780
+ # The number of HTTP response bytes inserted into cache. Set only when a cache
781
+ # fill was attempted.
782
+ # Corresponds to the JSON property `cacheFillBytes`
783
+ # @return [Fixnum]
784
+ attr_accessor :cache_fill_bytes
934
785
 
935
- # The logged-in user who made the request.Most likely, this is the part of the
936
- # user's email before the @ sign. The field value is the same for different
937
- # requests from the same user, but different users can have similar names. This
938
- # information is also available to the application via the App Engine Users API.
939
- # This field will be populated starting with App Engine 1.9.21.
940
- # Corresponds to the JSON property `nickname`
786
+ # The request method. Examples: "GET", "HEAD", "PUT", "POST".
787
+ # Corresponds to the JSON property `requestMethod`
941
788
  # @return [String]
942
- attr_accessor :nickname
789
+ attr_accessor :request_method
943
790
 
944
- # HTTP response status code. Example: 200, 404.
945
- # Corresponds to the JSON property `status`
791
+ # The size of the HTTP response message sent back to the client, in bytes,
792
+ # including the response headers and the response body.
793
+ # Corresponds to the JSON property `responseSize`
946
794
  # @return [Fixnum]
947
- attr_accessor :status
795
+ attr_accessor :response_size
948
796
 
949
- # Contains the path and query portion of the URL that was requested. For example,
950
- # if the URL was "http://example.com/app?name=val", the resource would be "/app?
951
- # name=val". The fragment identifier, which is identified by the # character, is
952
- # not included.
953
- # Corresponds to the JSON property `resource`
954
- # @return [String]
955
- attr_accessor :resource
797
+ # The size of the HTTP request message in bytes, including the request headers
798
+ # and the request body.
799
+ # Corresponds to the JSON property `requestSize`
800
+ # @return [Fixnum]
801
+ attr_accessor :request_size
956
802
 
957
- # Time this request spent in the pending request queue.
958
- # Corresponds to the JSON property `pendingTime`
803
+ # The scheme (http, https), the host name, the path and the query portion of the
804
+ # URL that was requested. Example: "http://example.com/some/info?color=red".
805
+ # Corresponds to the JSON property `requestUrl`
959
806
  # @return [String]
960
- attr_accessor :pending_time
807
+ attr_accessor :request_url
961
808
 
962
- # Task name of the request, in the case of an offline request.
963
- # Corresponds to the JSON property `taskName`
809
+ # The IP address (IPv4 or IPv6) of the origin server that the request was sent
810
+ # to.
811
+ # Corresponds to the JSON property `serverIp`
964
812
  # @return [String]
965
- attr_accessor :task_name
813
+ attr_accessor :server_ip
966
814
 
967
- # File or class that handled the request.
968
- # Corresponds to the JSON property `urlMapEntry`
815
+ # The IP address (IPv4 or IPv6) of the client that issued the HTTP request.
816
+ # Examples: "192.168.1.1", "FE80::0202:B3FF:FE1E:8329".
817
+ # Corresponds to the JSON property `remoteIp`
969
818
  # @return [String]
970
- attr_accessor :url_map_entry
819
+ attr_accessor :remote_ip
971
820
 
972
- # If the instance processing this request belongs to a manually scaled module,
973
- # then this is the 0-based index of the instance. Otherwise, this value is -1.
974
- # Corresponds to the JSON property `instanceIndex`
975
- # @return [Fixnum]
976
- attr_accessor :instance_index
821
+ def initialize(**args)
822
+ update!(**args)
823
+ end
977
824
 
978
- # Internet host and port number of the resource being requested.
979
- # Corresponds to the JSON property `host`
825
+ # Update properties of this object
826
+ def update!(**args)
827
+ @cache_lookup = args[:cache_lookup] if args.key?(:cache_lookup)
828
+ @cache_hit = args[:cache_hit] if args.key?(:cache_hit)
829
+ @cache_validated_with_origin_server = args[:cache_validated_with_origin_server] if args.key?(:cache_validated_with_origin_server)
830
+ @status = args[:status] if args.key?(:status)
831
+ @referer = args[:referer] if args.key?(:referer)
832
+ @user_agent = args[:user_agent] if args.key?(:user_agent)
833
+ @latency = args[:latency] if args.key?(:latency)
834
+ @cache_fill_bytes = args[:cache_fill_bytes] if args.key?(:cache_fill_bytes)
835
+ @request_method = args[:request_method] if args.key?(:request_method)
836
+ @response_size = args[:response_size] if args.key?(:response_size)
837
+ @request_size = args[:request_size] if args.key?(:request_size)
838
+ @request_url = args[:request_url] if args.key?(:request_url)
839
+ @server_ip = args[:server_ip] if args.key?(:server_ip)
840
+ @remote_ip = args[:remote_ip] if args.key?(:remote_ip)
841
+ end
842
+ end
843
+
844
+ # Result returned from ListSinks.
845
+ class ListSinksResponse
846
+ include Google::Apis::Core::Hashable
847
+
848
+ # A list of sinks.
849
+ # Corresponds to the JSON property `sinks`
850
+ # @return [Array<Google::Apis::LoggingV2beta1::LogSink>]
851
+ attr_accessor :sinks
852
+
853
+ # If there might be more results than appear in this response, then
854
+ # nextPageToken is included. To get the next set of results, call the same
855
+ # method again using the value of nextPageToken as pageToken.
856
+ # Corresponds to the JSON property `nextPageToken`
980
857
  # @return [String]
981
- attr_accessor :host
858
+ attr_accessor :next_page_token
859
+
860
+ def initialize(**args)
861
+ update!(**args)
862
+ end
863
+
864
+ # Update properties of this object
865
+ def update!(**args)
866
+ @sinks = args[:sinks] if args.key?(:sinks)
867
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
868
+ end
869
+ end
982
870
 
983
- # Whether this request is finished or active.
984
- # Corresponds to the JSON property `finished`
985
- # @return [Boolean]
986
- attr_accessor :finished
987
- alias_method :finished?, :finished
871
+ # A description of a label.
872
+ class LabelDescriptor
873
+ include Google::Apis::Core::Hashable
988
874
 
989
- # HTTP version of request. Example: "HTTP/1.1".
990
- # Corresponds to the JSON property `httpVersion`
875
+ # The type of data that can be assigned to the label.
876
+ # Corresponds to the JSON property `valueType`
991
877
  # @return [String]
992
- attr_accessor :http_version
878
+ attr_accessor :value_type
993
879
 
994
- # Time when the request started.
995
- # Corresponds to the JSON property `startTime`
880
+ # The label key.
881
+ # Corresponds to the JSON property `key`
996
882
  # @return [String]
997
- attr_accessor :start_time
883
+ attr_accessor :key
998
884
 
999
- # Latency of the request.
1000
- # Corresponds to the JSON property `latency`
885
+ # A human-readable description for the label.
886
+ # Corresponds to the JSON property `description`
1001
887
  # @return [String]
1002
- attr_accessor :latency
888
+ attr_accessor :description
1003
889
 
1004
- # Origin IP address.
1005
- # Corresponds to the JSON property `ip`
1006
- # @return [String]
1007
- attr_accessor :ip
890
+ def initialize(**args)
891
+ update!(**args)
892
+ end
1008
893
 
1009
- # Application that handled this request.
1010
- # Corresponds to the JSON property `appId`
894
+ # Update properties of this object
895
+ def update!(**args)
896
+ @value_type = args[:value_type] if args.key?(:value_type)
897
+ @key = args[:key] if args.key?(:key)
898
+ @description = args[:description] if args.key?(:description)
899
+ end
900
+ end
901
+
902
+ # An object that describes the schema of a MonitoredResource object using a type
903
+ # name and a set of labels. For example, the monitored resource descriptor for
904
+ # Google Compute Engine VM instances has a type of "gce_instance" and specifies
905
+ # the use of the labels "instance_id" and "zone" to identify particular VM
906
+ # instances.Different APIs can support different monitored resource types. APIs
907
+ # generally provide a list method that returns the monitored resource
908
+ # descriptors used by the API.
909
+ class MonitoredResourceDescriptor
910
+ include Google::Apis::Core::Hashable
911
+
912
+ # Optional. A detailed description of the monitored resource type that might be
913
+ # used in documentation.
914
+ # Corresponds to the JSON property `description`
1011
915
  # @return [String]
1012
- attr_accessor :app_id
916
+ attr_accessor :description
1013
917
 
1014
- # App Engine release version.
1015
- # Corresponds to the JSON property `appEngineRelease`
918
+ # Optional. A concise name for the monitored resource type that might be
919
+ # displayed in user interfaces. It should be a Title Cased Noun Phrase, without
920
+ # any article or other determiners. For example, "Google Cloud SQL Database".
921
+ # Corresponds to the JSON property `displayName`
1016
922
  # @return [String]
1017
- attr_accessor :app_engine_release
923
+ attr_accessor :display_name
1018
924
 
1019
- # Request method. Example: "GET", "HEAD", "PUT", "POST", "DELETE".
1020
- # Corresponds to the JSON property `method`
925
+ # Required. The monitored resource type. For example, the type "
926
+ # cloudsql_database" represents databases in Google Cloud SQL. The maximum
927
+ # length of this value is 256 characters.
928
+ # Corresponds to the JSON property `type`
1021
929
  # @return [String]
1022
- attr_accessor :method_prop
930
+ attr_accessor :type
1023
931
 
1024
- # An indication of the relative cost of serving this request.
1025
- # Corresponds to the JSON property `cost`
1026
- # @return [Float]
1027
- attr_accessor :cost
932
+ # Required. A set of labels used to describe instances of this monitored
933
+ # resource type. For example, an individual Google Cloud SQL database is
934
+ # identified by values for the labels "database_id" and "zone".
935
+ # Corresponds to the JSON property `labels`
936
+ # @return [Array<Google::Apis::LoggingV2beta1::LabelDescriptor>]
937
+ attr_accessor :labels
1028
938
 
1029
- # An identifier for the instance that handled the request.
1030
- # Corresponds to the JSON property `instanceId`
939
+ # Optional. The resource name of the monitored resource descriptor: "projects/`
940
+ # project_id`/monitoredResourceDescriptors/`type`" where `type` is the value of
941
+ # the type field in this object and `project_id` is a project ID that provides
942
+ # API-specific context for accessing the type. APIs that do not use project
943
+ # information can use the resource name format "monitoredResourceDescriptors/`
944
+ # type`".
945
+ # Corresponds to the JSON property `name`
1031
946
  # @return [String]
1032
- attr_accessor :instance_id
947
+ attr_accessor :name
1033
948
 
1034
- # Number of CPU megacycles used to process request.
1035
- # Corresponds to the JSON property `megaCycles`
1036
- # @return [Fixnum]
1037
- attr_accessor :mega_cycles
949
+ def initialize(**args)
950
+ update!(**args)
951
+ end
1038
952
 
1039
- # Whether this is the first RequestLog entry for this request. If an active
1040
- # request has several RequestLog entries written to Stackdriver Logging, then
1041
- # this field will be set for one of them.
1042
- # Corresponds to the JSON property `first`
1043
- # @return [Boolean]
1044
- attr_accessor :first
1045
- alias_method :first?, :first
953
+ # Update properties of this object
954
+ def update!(**args)
955
+ @description = args[:description] if args.key?(:description)
956
+ @display_name = args[:display_name] if args.key?(:display_name)
957
+ @type = args[:type] if args.key?(:type)
958
+ @labels = args[:labels] if args.key?(:labels)
959
+ @name = args[:name] if args.key?(:name)
960
+ end
961
+ end
1046
962
 
1047
- # Version of the application that handled this request.
1048
- # Corresponds to the JSON property `versionId`
963
+ # Additional information about the source code location that produced the log
964
+ # entry.
965
+ class LogEntrySourceLocation
966
+ include Google::Apis::Core::Hashable
967
+
968
+ # Optional. Source file name. Depending on the runtime environment, this might
969
+ # be a simple name or a fully-qualified name.
970
+ # Corresponds to the JSON property `file`
1049
971
  # @return [String]
1050
- attr_accessor :version_id
972
+ attr_accessor :file
973
+
974
+ # Optional. Human-readable name of the function or method being invoked, with
975
+ # optional context such as the class or package name. This information may be
976
+ # used in contexts such as the logs viewer, where a file and line number are
977
+ # less meaningful. The format can vary by language. For example: qual.if.ied.
978
+ # Class.method (Java), dir/package.func (Go), function (Python).
979
+ # Corresponds to the JSON property `function`
980
+ # @return [String]
981
+ attr_accessor :function
982
+
983
+ # Optional. Line within the source file. 1-based; 0 indicates no line number
984
+ # available.
985
+ # Corresponds to the JSON property `line`
986
+ # @return [Fixnum]
987
+ attr_accessor :line
1051
988
 
1052
989
  def initialize(**args)
1053
990
  update!(**args)
@@ -1055,56 +992,33 @@ module Google
1055
992
 
1056
993
  # Update properties of this object
1057
994
  def update!(**args)
1058
- @module_id = args[:module_id] if args.key?(:module_id)
1059
- @end_time = args[:end_time] if args.key?(:end_time)
1060
- @user_agent = args[:user_agent] if args.key?(:user_agent)
1061
- @was_loading_request = args[:was_loading_request] if args.key?(:was_loading_request)
1062
- @source_reference = args[:source_reference] if args.key?(:source_reference)
1063
- @response_size = args[:response_size] if args.key?(:response_size)
1064
- @trace_id = args[:trace_id] if args.key?(:trace_id)
995
+ @file = args[:file] if args.key?(:file)
996
+ @function = args[:function] if args.key?(:function)
1065
997
  @line = args[:line] if args.key?(:line)
1066
- @referrer = args[:referrer] if args.key?(:referrer)
1067
- @task_queue_name = args[:task_queue_name] if args.key?(:task_queue_name)
1068
- @request_id = args[:request_id] if args.key?(:request_id)
1069
- @nickname = args[:nickname] if args.key?(:nickname)
1070
- @status = args[:status] if args.key?(:status)
1071
- @resource = args[:resource] if args.key?(:resource)
1072
- @pending_time = args[:pending_time] if args.key?(:pending_time)
1073
- @task_name = args[:task_name] if args.key?(:task_name)
1074
- @url_map_entry = args[:url_map_entry] if args.key?(:url_map_entry)
1075
- @instance_index = args[:instance_index] if args.key?(:instance_index)
1076
- @host = args[:host] if args.key?(:host)
1077
- @finished = args[:finished] if args.key?(:finished)
1078
- @http_version = args[:http_version] if args.key?(:http_version)
1079
- @start_time = args[:start_time] if args.key?(:start_time)
1080
- @latency = args[:latency] if args.key?(:latency)
1081
- @ip = args[:ip] if args.key?(:ip)
1082
- @app_id = args[:app_id] if args.key?(:app_id)
1083
- @app_engine_release = args[:app_engine_release] if args.key?(:app_engine_release)
1084
- @method_prop = args[:method_prop] if args.key?(:method_prop)
1085
- @cost = args[:cost] if args.key?(:cost)
1086
- @instance_id = args[:instance_id] if args.key?(:instance_id)
1087
- @mega_cycles = args[:mega_cycles] if args.key?(:mega_cycles)
1088
- @first = args[:first] if args.key?(:first)
1089
- @version_id = args[:version_id] if args.key?(:version_id)
1090
998
  end
1091
999
  end
1092
1000
 
1093
- # Result returned from ListMonitoredResourceDescriptors.
1094
- class ListMonitoredResourceDescriptorsResponse
1001
+ # Result returned from ListLogEntries.
1002
+ class ListLogEntriesResponse
1095
1003
  include Google::Apis::Core::Hashable
1096
1004
 
1097
1005
  # If there might be more results than those appearing in this response, then
1098
1006
  # nextPageToken is included. To get the next set of results, call this method
1099
- # again using the value of nextPageToken as pageToken.
1007
+ # again using the value of nextPageToken as pageToken.If a value for
1008
+ # next_page_token appears and the entries field is empty, it means that the
1009
+ # search found no log entries so far but it did not have time to search all the
1010
+ # possible log entries. Retry the method with this value for page_token to
1011
+ # continue the search. Alternatively, consider speeding up the search by
1012
+ # changing your filter to specify a single log name or resource type, or to
1013
+ # narrow the time range of the search.
1100
1014
  # Corresponds to the JSON property `nextPageToken`
1101
1015
  # @return [String]
1102
1016
  attr_accessor :next_page_token
1103
1017
 
1104
- # A list of resource descriptors.
1105
- # Corresponds to the JSON property `resourceDescriptors`
1106
- # @return [Array<Google::Apis::LoggingV2beta1::MonitoredResourceDescriptor>]
1107
- attr_accessor :resource_descriptors
1018
+ # A list of log entries.
1019
+ # Corresponds to the JSON property `entries`
1020
+ # @return [Array<Google::Apis::LoggingV2beta1::LogEntry>]
1021
+ attr_accessor :entries
1108
1022
 
1109
1023
  def initialize(**args)
1110
1024
  update!(**args)
@@ -1113,26 +1027,62 @@ module Google
1113
1027
  # Update properties of this object
1114
1028
  def update!(**args)
1115
1029
  @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
1116
- @resource_descriptors = args[:resource_descriptors] if args.key?(:resource_descriptors)
1030
+ @entries = args[:entries] if args.key?(:entries)
1117
1031
  end
1118
1032
  end
1119
1033
 
1120
- # A reference to a particular snapshot of the source tree used to build and
1121
- # deploy an application.
1122
- class SourceReference
1034
+ # Application log line emitted while processing a request.
1035
+ class LogLine
1123
1036
  include Google::Apis::Core::Hashable
1124
1037
 
1125
- # Optional. A URI string identifying the repository. Example: "https://github.
1126
- # com/GoogleCloudPlatform/kubernetes.git"
1127
- # Corresponds to the JSON property `repository`
1038
+ # App-provided log message.
1039
+ # Corresponds to the JSON property `logMessage`
1128
1040
  # @return [String]
1129
- attr_accessor :repository
1041
+ attr_accessor :log_message
1130
1042
 
1131
- # The canonical and persistent identifier of the deployed revision. Example (git)
1132
- # : "0035781c50ec7aa23385dc841529ce8a4b70db1b"
1133
- # Corresponds to the JSON property `revisionId`
1043
+ # Severity of this log entry.
1044
+ # Corresponds to the JSON property `severity`
1045
+ # @return [String]
1046
+ attr_accessor :severity
1047
+
1048
+ # Specifies a location in a source code file.
1049
+ # Corresponds to the JSON property `sourceLocation`
1050
+ # @return [Google::Apis::LoggingV2beta1::SourceLocation]
1051
+ attr_accessor :source_location
1052
+
1053
+ # Approximate time when this log entry was made.
1054
+ # Corresponds to the JSON property `time`
1055
+ # @return [String]
1056
+ attr_accessor :time
1057
+
1058
+ def initialize(**args)
1059
+ update!(**args)
1060
+ end
1061
+
1062
+ # Update properties of this object
1063
+ def update!(**args)
1064
+ @log_message = args[:log_message] if args.key?(:log_message)
1065
+ @severity = args[:severity] if args.key?(:severity)
1066
+ @source_location = args[:source_location] if args.key?(:source_location)
1067
+ @time = args[:time] if args.key?(:time)
1068
+ end
1069
+ end
1070
+
1071
+ # Result returned from ListLogMetrics.
1072
+ class ListLogMetricsResponse
1073
+ include Google::Apis::Core::Hashable
1074
+
1075
+ # A list of logs-based metrics.
1076
+ # Corresponds to the JSON property `metrics`
1077
+ # @return [Array<Google::Apis::LoggingV2beta1::LogMetric>]
1078
+ attr_accessor :metrics
1079
+
1080
+ # If there might be more results than appear in this response, then
1081
+ # nextPageToken is included. To get the next set of results, call this method
1082
+ # again using the value of nextPageToken as pageToken.
1083
+ # Corresponds to the JSON property `nextPageToken`
1134
1084
  # @return [String]
1135
- attr_accessor :revision_id
1085
+ attr_accessor :next_page_token
1136
1086
 
1137
1087
  def initialize(**args)
1138
1088
  update!(**args)
@@ -1140,64 +1090,128 @@ module Google
1140
1090
 
1141
1091
  # Update properties of this object
1142
1092
  def update!(**args)
1143
- @repository = args[:repository] if args.key?(:repository)
1144
- @revision_id = args[:revision_id] if args.key?(:revision_id)
1093
+ @metrics = args[:metrics] if args.key?(:metrics)
1094
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
1145
1095
  end
1146
1096
  end
1147
1097
 
1148
- # Describes a logs-based metric. The value of the metric is the number of log
1149
- # entries that match a logs filter in a given time interval.
1150
- class LogMetric
1098
+ # An individual entry in a log.
1099
+ class LogEntry
1151
1100
  include Google::Apis::Core::Hashable
1152
1101
 
1153
- # Required. The client-assigned metric identifier. Examples: "error_count", "
1154
- # nginx/requests".Metric identifiers are limited to 100 characters and can
1155
- # include only the following characters: A-Z, a-z, 0-9, and the special
1156
- # characters _-.,+!*',()%/. The forward-slash character (/) denotes a hierarchy
1157
- # of name pieces, and it cannot be the first character of the name.The metric
1158
- # identifier in this field must not be URL-encoded (https://en.wikipedia.org/
1159
- # wiki/Percent-encoding). However, when the metric identifier appears as the [
1160
- # METRIC_ID] part of a metric_name API parameter, then the metric identifier
1161
- # must be URL-encoded. Example: "projects/my-project/metrics/nginx%2Frequests".
1162
- # Corresponds to the JSON property `name`
1102
+ # Optional. The time the event described by the log entry occurred. If omitted
1103
+ # in a new log entry, Stackdriver Logging will insert the time the log entry is
1104
+ # received. Stackdriver Logging might reject log entries whose time stamps are
1105
+ # more than a couple of hours in the future. Log entries with time stamps in the
1106
+ # past are accepted.
1107
+ # Corresponds to the JSON property `timestamp`
1163
1108
  # @return [String]
1164
- attr_accessor :name
1109
+ attr_accessor :timestamp
1165
1110
 
1166
- # Optional. A description of this metric, which is used in documentation.
1167
- # Corresponds to the JSON property `description`
1111
+ # Output only. The time the log entry was received by Stackdriver Logging.
1112
+ # Corresponds to the JSON property `receiveTimestamp`
1168
1113
  # @return [String]
1169
- attr_accessor :description
1114
+ attr_accessor :receive_timestamp
1170
1115
 
1171
- # Output only. The API version that created or updated this metric. The version
1172
- # also dictates the syntax of the filter expression. When a value for this field
1173
- # is missing, the default value of V2 should be assumed.
1174
- # Corresponds to the JSON property `version`
1116
+ # Required. The resource name of the log to which this log entry belongs:
1117
+ # "projects/[PROJECT_ID]/logs/[LOG_ID]"
1118
+ # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
1119
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
1120
+ # "folders/[FOLDER_ID]/logs/[LOG_ID]"
1121
+ # [LOG_ID] must be URL-encoded within log_name. Example: "organizations/
1122
+ # 1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". [LOG_ID] must
1123
+ # be less than 512 characters long and can only include the following characters:
1124
+ # upper and lower case alphanumeric characters, forward-slash, underscore,
1125
+ # hyphen, and period.For backward compatibility, if log_name begins with a
1126
+ # forward-slash, such as /projects/..., then the log entry is ingested as usual
1127
+ # but the forward-slash is removed. Listing the log entry will not show the
1128
+ # leading slash and filtering for a log name with a leading slash will never
1129
+ # return any results.
1130
+ # Corresponds to the JSON property `logName`
1175
1131
  # @return [String]
1176
- attr_accessor :version
1132
+ attr_accessor :log_name
1177
1133
 
1178
- # Required. An advanced logs filter which is used to match log entries. Example:
1179
- # "resource.type=gae_app AND severity>=ERROR"
1180
- # The maximum length of the filter is 20000 characters.
1181
- # Corresponds to the JSON property `filter`
1134
+ # A common proto for logging HTTP requests. Only contains semantics defined by
1135
+ # the HTTP specification. Product-specific logging information MUST be defined
1136
+ # in a separate message.
1137
+ # Corresponds to the JSON property `httpRequest`
1138
+ # @return [Google::Apis::LoggingV2beta1::HttpRequest]
1139
+ attr_accessor :http_request
1140
+
1141
+ # An object representing a resource that can be used for monitoring, logging,
1142
+ # billing, or other purposes. Examples include virtual machine instances,
1143
+ # databases, and storage devices such as disks. The type field identifies a
1144
+ # MonitoredResourceDescriptor object that describes the resource's schema.
1145
+ # Information in the labels field identifies the actual resource and its
1146
+ # attributes according to the schema. For example, a particular Compute Engine
1147
+ # VM instance could be represented by the following object, because the
1148
+ # MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "
1149
+ # zone":
1150
+ # ` "type": "gce_instance",
1151
+ # "labels": ` "instance_id": "12345678901234",
1152
+ # "zone": "us-central1-a" ``
1153
+ # Corresponds to the JSON property `resource`
1154
+ # @return [Google::Apis::LoggingV2beta1::MonitoredResource]
1155
+ attr_accessor :resource
1156
+
1157
+ # The log entry payload, represented as a structure that is expressed as a JSON
1158
+ # object.
1159
+ # Corresponds to the JSON property `jsonPayload`
1160
+ # @return [Hash<String,Object>]
1161
+ attr_accessor :json_payload
1162
+
1163
+ # Additional information about a potentially long-running operation with which a
1164
+ # log entry is associated.
1165
+ # Corresponds to the JSON property `operation`
1166
+ # @return [Google::Apis::LoggingV2beta1::LogEntryOperation]
1167
+ attr_accessor :operation
1168
+
1169
+ # Optional. A unique identifier for the log entry. If you provide a value, then
1170
+ # Stackdriver Logging considers other log entries in the same project, with the
1171
+ # same timestamp, and with the same insert_id to be duplicates which can be
1172
+ # removed. If omitted in new log entries, then Stackdriver Logging will insert
1173
+ # its own unique identifier. The insert_id is used to order log entries that
1174
+ # have the same timestamp value.
1175
+ # Corresponds to the JSON property `insertId`
1182
1176
  # @return [String]
1183
- attr_accessor :filter
1177
+ attr_accessor :insert_id
1184
1178
 
1185
- def initialize(**args)
1186
- update!(**args)
1187
- end
1179
+ # The log entry payload, represented as a Unicode string (UTF-8).
1180
+ # Corresponds to the JSON property `textPayload`
1181
+ # @return [String]
1182
+ attr_accessor :text_payload
1188
1183
 
1189
- # Update properties of this object
1190
- def update!(**args)
1191
- @name = args[:name] if args.key?(:name)
1192
- @description = args[:description] if args.key?(:description)
1193
- @version = args[:version] if args.key?(:version)
1194
- @filter = args[:filter] if args.key?(:filter)
1195
- end
1196
- end
1184
+ # The log entry payload, represented as a protocol buffer. Some Google Cloud
1185
+ # Platform services use this field for their log entry payloads.
1186
+ # Corresponds to the JSON property `protoPayload`
1187
+ # @return [Hash<String,Object>]
1188
+ attr_accessor :proto_payload
1197
1189
 
1198
- # Result returned from WriteLogEntries. empty
1199
- class WriteLogEntriesResponse
1200
- include Google::Apis::Core::Hashable
1190
+ # Optional. A set of user-defined (key, value) data that provides additional
1191
+ # information about the log entry.
1192
+ # Corresponds to the JSON property `labels`
1193
+ # @return [Hash<String,String>]
1194
+ attr_accessor :labels
1195
+
1196
+ # Optional. Resource name of the trace associated with the log entry, if any. If
1197
+ # it contains a relative resource name, the name is assumed to be relative to //
1198
+ # tracing.googleapis.com. Example: projects/my-projectid/traces/
1199
+ # 06796866738c859f2f19b7cfb3214824
1200
+ # Corresponds to the JSON property `trace`
1201
+ # @return [String]
1202
+ attr_accessor :trace
1203
+
1204
+ # Optional. The severity of the log entry. The default value is LogSeverity.
1205
+ # DEFAULT.
1206
+ # Corresponds to the JSON property `severity`
1207
+ # @return [String]
1208
+ attr_accessor :severity
1209
+
1210
+ # Additional information about the source code location that produced the log
1211
+ # entry.
1212
+ # Corresponds to the JSON property `sourceLocation`
1213
+ # @return [Google::Apis::LoggingV2beta1::LogEntrySourceLocation]
1214
+ attr_accessor :source_location
1201
1215
 
1202
1216
  def initialize(**args)
1203
1217
  update!(**args)
@@ -1205,80 +1219,65 @@ module Google
1205
1219
 
1206
1220
  # Update properties of this object
1207
1221
  def update!(**args)
1222
+ @timestamp = args[:timestamp] if args.key?(:timestamp)
1223
+ @receive_timestamp = args[:receive_timestamp] if args.key?(:receive_timestamp)
1224
+ @log_name = args[:log_name] if args.key?(:log_name)
1225
+ @http_request = args[:http_request] if args.key?(:http_request)
1226
+ @resource = args[:resource] if args.key?(:resource)
1227
+ @json_payload = args[:json_payload] if args.key?(:json_payload)
1228
+ @operation = args[:operation] if args.key?(:operation)
1229
+ @insert_id = args[:insert_id] if args.key?(:insert_id)
1230
+ @text_payload = args[:text_payload] if args.key?(:text_payload)
1231
+ @proto_payload = args[:proto_payload] if args.key?(:proto_payload)
1232
+ @labels = args[:labels] if args.key?(:labels)
1233
+ @trace = args[:trace] if args.key?(:trace)
1234
+ @severity = args[:severity] if args.key?(:severity)
1235
+ @source_location = args[:source_location] if args.key?(:source_location)
1208
1236
  end
1209
1237
  end
1210
1238
 
1211
- # Additional information about a potentially long-running operation with which a
1212
- # log entry is associated.
1213
- class LogEntryOperation
1239
+ # A generic empty message that you can re-use to avoid defining duplicated empty
1240
+ # messages in your APIs. A typical example is to use it as the request or the
1241
+ # response type of an API method. For instance:
1242
+ # service Foo `
1243
+ # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
1244
+ # `
1245
+ # The JSON representation for Empty is empty JSON object ``.
1246
+ class Empty
1214
1247
  include Google::Apis::Core::Hashable
1215
1248
 
1216
- # Optional. An arbitrary producer identifier. The combination of id and producer
1217
- # must be globally unique. Examples for producer: "MyDivision.MyBigCompany.com",
1218
- # "github.com/MyProject/MyApplication".
1219
- # Corresponds to the JSON property `producer`
1220
- # @return [String]
1221
- attr_accessor :producer
1222
-
1223
- # Optional. Set this to True if this is the first log entry in the operation.
1224
- # Corresponds to the JSON property `first`
1225
- # @return [Boolean]
1226
- attr_accessor :first
1227
- alias_method :first?, :first
1228
-
1229
- # Optional. Set this to True if this is the last log entry in the operation.
1230
- # Corresponds to the JSON property `last`
1231
- # @return [Boolean]
1232
- attr_accessor :last
1233
- alias_method :last?, :last
1234
-
1235
- # Optional. An arbitrary operation identifier. Log entries with the same
1236
- # identifier are assumed to be part of the same operation.
1237
- # Corresponds to the JSON property `id`
1238
- # @return [String]
1239
- attr_accessor :id
1240
-
1241
1249
  def initialize(**args)
1242
1250
  update!(**args)
1243
1251
  end
1244
1252
 
1245
1253
  # Update properties of this object
1246
1254
  def update!(**args)
1247
- @producer = args[:producer] if args.key?(:producer)
1248
- @first = args[:first] if args.key?(:first)
1249
- @last = args[:last] if args.key?(:last)
1250
- @id = args[:id] if args.key?(:id)
1251
1255
  end
1252
1256
  end
1253
1257
 
1254
- # An object representing a resource that can be used for monitoring, logging,
1255
- # billing, or other purposes. Examples include virtual machine instances,
1256
- # databases, and storage devices such as disks. The type field identifies a
1257
- # MonitoredResourceDescriptor object that describes the resource's schema.
1258
- # Information in the labels field identifies the actual resource and its
1259
- # attributes according to the schema. For example, a particular Compute Engine
1260
- # VM instance could be represented by the following object, because the
1261
- # MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "
1262
- # zone":
1263
- # ` "type": "gce_instance",
1264
- # "labels": ` "instance_id": "12345678901234",
1265
- # "zone": "us-central1-a" ``
1266
- class MonitoredResource
1258
+ # Specifies a location in a source code file.
1259
+ class SourceLocation
1267
1260
  include Google::Apis::Core::Hashable
1268
1261
 
1269
- # Required. The monitored resource type. This field must match the type field of
1270
- # a MonitoredResourceDescriptor object. For example, the type of a Compute
1271
- # Engine VM instance is gce_instance.
1272
- # Corresponds to the JSON property `type`
1262
+ # Source file name. Depending on the runtime environment, this might be a simple
1263
+ # name or a fully-qualified name.
1264
+ # Corresponds to the JSON property `file`
1273
1265
  # @return [String]
1274
- attr_accessor :type
1266
+ attr_accessor :file
1275
1267
 
1276
- # Required. Values for all of the labels listed in the associated monitored
1277
- # resource descriptor. For example, Compute Engine VM instances use the labels "
1278
- # project_id", "instance_id", and "zone".
1279
- # Corresponds to the JSON property `labels`
1280
- # @return [Hash<String,String>]
1281
- attr_accessor :labels
1268
+ # Human-readable name of the function or method being invoked, with optional
1269
+ # context such as the class or package name. This information is used in
1270
+ # contexts such as the logs viewer, where a file and line number are less
1271
+ # meaningful. The format can vary by language. For example: qual.if.ied.Class.
1272
+ # method (Java), dir/package.func (Go), function (Python).
1273
+ # Corresponds to the JSON property `functionName`
1274
+ # @return [String]
1275
+ attr_accessor :function_name
1276
+
1277
+ # Line within the source file.
1278
+ # Corresponds to the JSON property `line`
1279
+ # @return [Fixnum]
1280
+ attr_accessor :line
1282
1281
 
1283
1282
  def initialize(**args)
1284
1283
  update!(**args)
@@ -1286,8 +1285,9 @@ module Google
1286
1285
 
1287
1286
  # Update properties of this object
1288
1287
  def update!(**args)
1289
- @type = args[:type] if args.key?(:type)
1290
- @labels = args[:labels] if args.key?(:labels)
1288
+ @file = args[:file] if args.key?(:file)
1289
+ @function_name = args[:function_name] if args.key?(:function_name)
1290
+ @line = args[:line] if args.key?(:line)
1291
1291
  end
1292
1292
  end
1293
1293
  end