google-api-client 0.11.2 → 0.11.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (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