google-api-client 0.11.2 → 0.11.3

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