google-api-client 0.13.0 → 0.13.1

Sign up to get free protection for your applications and to get access to all the features.
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