google-api-client 0.10.1 → 0.10.2

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