google-api-client 0.10.2 → 0.10.3

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