google-cloud-error_reporting-v1beta1 0.10.0 → 0.11.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (20) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/error_reporting/v1beta1/error_group_service/client.rb +24 -6
  3. data/lib/google/cloud/error_reporting/v1beta1/error_group_service/rest/client.rb +24 -6
  4. data/lib/google/cloud/error_reporting/v1beta1/error_group_service/rest/service_stub.rb +15 -0
  5. data/lib/google/cloud/error_reporting/v1beta1/error_stats_service/client.rb +80 -31
  6. data/lib/google/cloud/error_reporting/v1beta1/error_stats_service/rest/client.rb +80 -31
  7. data/lib/google/cloud/error_reporting/v1beta1/error_stats_service/rest/service_stub.rb +21 -0
  8. data/lib/google/cloud/error_reporting/v1beta1/report_errors_service/client.rb +15 -4
  9. data/lib/google/cloud/error_reporting/v1beta1/report_errors_service/rest/client.rb +15 -4
  10. data/lib/google/cloud/error_reporting/v1beta1/version.rb +1 -1
  11. data/lib/google/devtools/clouderrorreporting/v1beta1/error_group_service_pb.rb +1 -1
  12. data/lib/google/devtools/clouderrorreporting/v1beta1/error_stats_service_pb.rb +1 -1
  13. data/lib/google/devtools/clouderrorreporting/v1beta1/report_errors_service_services_pb.rb +9 -3
  14. data/proto_docs/google/api/client.rb +18 -10
  15. data/proto_docs/google/api/resource.rb +7 -2
  16. data/proto_docs/google/devtools/clouderrorreporting/v1beta1/common.rb +24 -3
  17. data/proto_docs/google/devtools/clouderrorreporting/v1beta1/error_group_service.rb +17 -4
  18. data/proto_docs/google/devtools/clouderrorreporting/v1beta1/error_stats_service.rb +90 -35
  19. data/proto_docs/google/devtools/clouderrorreporting/v1beta1/report_errors_service.rb +8 -4
  20. metadata +2 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 8ec22134797cd4766912641d4b69e73caa55629f652786641d396630b96d0224
4
- data.tar.gz: d742fc3dc0786d87f9ebadff6a3db7980bc7d66002db866c2541fb6be79a41f9
3
+ metadata.gz: 8a256b2998f89e129d2d6e63002f6e1a6320dd827719d06eb2cc79089f2aa021
4
+ data.tar.gz: 101cddfec1e4a6310f442f7a1675ae7f155e158e4b4f1d1bc271b5c6f096898e
5
5
  SHA512:
6
- metadata.gz: 971170b398ad29a59ceeeec3e13cc2943a47106d72eb99f19970b0425f52ba4de2856dcefac47d95ff27c657eafbc3e7d6f3860d7617fdd65a117e6dcd06e7fd
7
- data.tar.gz: cb4017013b0ad9ccfefab1f30a58984ed1390ce0e6d260618eeb8737238dd0e089a613796f78060a3992efbada08912517b73a5758a843709851125a6377fd8a
6
+ metadata.gz: e042118779cad7a1eb13618cfd6fa7d64295c6a5b0131ce4cf32cf38f3039f9c26ad22408b4da8d7c88f219bd4710c20966f3c9eb8db1b03e0080a4e23c3a000
7
+ data.tar.gz: 626c30d34e9efbbc7a174b58e24156196ae555a64267431fc3d9866b1bb76c47488eca9557c8ba85b503c9e55d418055d8b324a5a49c273a8ccc289d34e25bfd
@@ -30,6 +30,9 @@ module Google
30
30
  # Service for retrieving and updating individual error groups.
31
31
  #
32
32
  class Client
33
+ # @private
34
+ API_VERSION = ""
35
+
33
36
  # @private
34
37
  DEFAULT_ENDPOINT_TEMPLATE = "clouderrorreporting.$UNIVERSE_DOMAIN$"
35
38
 
@@ -184,12 +187,25 @@ module Google
184
187
  # the default parameter values, pass an empty Hash as a request object (see above).
185
188
  #
186
189
  # @param group_name [::String]
187
- # Required. The group resource name. Written as
188
- # `projects/{projectID}/groups/{group_name}`. Call
189
- # [`groupStats.list`](https://cloud.google.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list)
190
+ # Required. The group resource name. Written as either
191
+ # `projects/{projectID}/groups/{group_id}` or
192
+ # `projects/{projectID}/locations/{location}/groups/{group_id}`. Call
193
+ # [groupStats.list]
194
+ # [google.devtools.clouderrorreporting.v1beta1.ErrorStatsService.ListGroupStats]
190
195
  # to return a list of groups belonging to this project.
191
196
  #
192
- # Example: `projects/my-project-123/groups/my-group`
197
+ # Examples: `projects/my-project-123/groups/my-group`,
198
+ # `projects/my-project-123/locations/global/groups/my-group`
199
+ #
200
+ # In the group resource name, the `group_id` is a unique identifier for a
201
+ # particular error group. The identifier is derived from key parts of the
202
+ # error-log content and is treated as Service Data. For information about
203
+ # how Service Data is handled, see [Google Cloud Privacy
204
+ # Notice](https://cloud.google.com/terms/cloud-privacy-notice).
205
+ #
206
+ # For a list of supported locations, see [Supported
207
+ # Regions](https://cloud.google.com/logging/docs/region-support). `global` is
208
+ # the default when unspecified.
193
209
  #
194
210
  # @yield [response, operation] Access the result along with the RPC operation
195
211
  # @yieldparam response [::Google::Cloud::ErrorReporting::V1beta1::ErrorGroup]
@@ -225,10 +241,11 @@ module Google
225
241
  # Customize the options with defaults
226
242
  metadata = @config.rpcs.get_group.metadata.to_h
227
243
 
228
- # Set x-goog-api-client and x-goog-user-project headers
244
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
229
245
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
230
246
  lib_name: @config.lib_name, lib_version: @config.lib_version,
231
247
  gapic_version: ::Google::Cloud::ErrorReporting::V1beta1::VERSION
248
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
232
249
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
233
250
 
234
251
  header_params = {}
@@ -311,10 +328,11 @@ module Google
311
328
  # Customize the options with defaults
312
329
  metadata = @config.rpcs.update_group.metadata.to_h
313
330
 
314
- # Set x-goog-api-client and x-goog-user-project headers
331
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
315
332
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
316
333
  lib_name: @config.lib_name, lib_version: @config.lib_version,
317
334
  gapic_version: ::Google::Cloud::ErrorReporting::V1beta1::VERSION
335
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
318
336
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
319
337
 
320
338
  header_params = {}
@@ -32,6 +32,9 @@ module Google
32
32
  # Service for retrieving and updating individual error groups.
33
33
  #
34
34
  class Client
35
+ # @private
36
+ API_VERSION = ""
37
+
35
38
  # @private
36
39
  DEFAULT_ENDPOINT_TEMPLATE = "clouderrorreporting.$UNIVERSE_DOMAIN$"
37
40
 
@@ -177,12 +180,25 @@ module Google
177
180
  # the default parameter values, pass an empty Hash as a request object (see above).
178
181
  #
179
182
  # @param group_name [::String]
180
- # Required. The group resource name. Written as
181
- # `projects/{projectID}/groups/{group_name}`. Call
182
- # [`groupStats.list`](https://cloud.google.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list)
183
+ # Required. The group resource name. Written as either
184
+ # `projects/{projectID}/groups/{group_id}` or
185
+ # `projects/{projectID}/locations/{location}/groups/{group_id}`. Call
186
+ # [groupStats.list]
187
+ # [google.devtools.clouderrorreporting.v1beta1.ErrorStatsService.ListGroupStats]
183
188
  # to return a list of groups belonging to this project.
184
189
  #
185
- # Example: `projects/my-project-123/groups/my-group`
190
+ # Examples: `projects/my-project-123/groups/my-group`,
191
+ # `projects/my-project-123/locations/global/groups/my-group`
192
+ #
193
+ # In the group resource name, the `group_id` is a unique identifier for a
194
+ # particular error group. The identifier is derived from key parts of the
195
+ # error-log content and is treated as Service Data. For information about
196
+ # how Service Data is handled, see [Google Cloud Privacy
197
+ # Notice](https://cloud.google.com/terms/cloud-privacy-notice).
198
+ #
199
+ # For a list of supported locations, see [Supported
200
+ # Regions](https://cloud.google.com/logging/docs/region-support). `global` is
201
+ # the default when unspecified.
186
202
  # @yield [result, operation] Access the result along with the TransportOperation object
187
203
  # @yieldparam result [::Google::Cloud::ErrorReporting::V1beta1::ErrorGroup]
188
204
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -217,12 +233,13 @@ module Google
217
233
  # Customize the options with defaults
218
234
  call_metadata = @config.rpcs.get_group.metadata.to_h
219
235
 
220
- # Set x-goog-api-client and x-goog-user-project headers
236
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
221
237
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
222
238
  lib_name: @config.lib_name, lib_version: @config.lib_version,
223
239
  gapic_version: ::Google::Cloud::ErrorReporting::V1beta1::VERSION,
224
240
  transports_version_send: [:rest]
225
241
 
242
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
226
243
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
227
244
 
228
245
  options.apply_defaults timeout: @config.rpcs.get_group.timeout,
@@ -296,12 +313,13 @@ module Google
296
313
  # Customize the options with defaults
297
314
  call_metadata = @config.rpcs.update_group.metadata.to_h
298
315
 
299
- # Set x-goog-api-client and x-goog-user-project headers
316
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
300
317
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
301
318
  lib_name: @config.lib_name, lib_version: @config.lib_version,
302
319
  gapic_version: ::Google::Cloud::ErrorReporting::V1beta1::VERSION,
303
320
  transports_version_send: [:rest]
304
321
 
322
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
305
323
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
306
324
 
307
325
  options.apply_defaults timeout: @config.rpcs.update_group.timeout,
@@ -155,6 +155,13 @@ module Google
155
155
  ["group_name", %r{^projects/[^/]+/groups/[^/]+/?$}, false]
156
156
  ]
157
157
  )
158
+ .with_bindings(
159
+ uri_method: :get,
160
+ uri_template: "/v1beta1/{group_name}",
161
+ matches: [
162
+ ["group_name", %r{^projects/[^/]+/locations/[^/]+/groups/[^/]+/?$}, false]
163
+ ]
164
+ )
158
165
  transcoder.transcode request_pb
159
166
  end
160
167
 
@@ -177,6 +184,14 @@ module Google
177
184
  ["group.name", %r{^projects/[^/]+/groups/[^/]+/?$}, false]
178
185
  ]
179
186
  )
187
+ .with_bindings(
188
+ uri_method: :put,
189
+ uri_template: "/v1beta1/{group.name}",
190
+ body: "group",
191
+ matches: [
192
+ ["group.name", %r{^projects/[^/]+/locations/[^/]+/groups/[^/]+/?$}, false]
193
+ ]
194
+ )
180
195
  transcoder.transcode request_pb
181
196
  end
182
197
  end
@@ -31,6 +31,9 @@ module Google
31
31
  # individual events.
32
32
  #
33
33
  class Client
34
+ # @private
35
+ API_VERSION = ""
36
+
34
37
  # @private
35
38
  DEFAULT_ENDPOINT_TEMPLATE = "clouderrorreporting.$UNIVERSE_DOMAIN$"
36
39
 
@@ -186,29 +189,54 @@ module Google
186
189
  #
187
190
  # @param project_name [::String]
188
191
  # Required. The resource name of the Google Cloud Platform project. Written
189
- # as `projects/{projectID}` or `projects/{projectNumber}`, where `{projectID}`
190
- # and `{projectNumber}` can be found in the
191
- # [Google Cloud Console](https://support.google.com/cloud/answer/6158840).
192
- #
193
- # Examples: `projects/my-project-123`, `projects/5551234`.
192
+ # as `projects/{projectID}` or `projects/{projectNumber}`, where
193
+ # `{projectID}` and `{projectNumber}` can be found in the
194
+ # [Google Cloud console](https://support.google.com/cloud/answer/6158840).
195
+ # It may also include a location, such as
196
+ # `projects/{projectID}/locations/{location}` where `{location}` is a cloud
197
+ # region.
198
+ #
199
+ # Examples: `projects/my-project-123`, `projects/5551234`,
200
+ # `projects/my-project-123/locations/us-central1`,
201
+ # `projects/5551234/locations/us-central1`.
202
+ #
203
+ # For a list of supported locations, see [Supported
204
+ # Regions](https://cloud.google.com/logging/docs/region-support). `global` is
205
+ # the default when unspecified. Use `-` as a wildcard to request group stats
206
+ # from all regions.
194
207
  # @param group_id [::Array<::String>]
195
- # Optional. List all <code>ErrorGroupStats</code> with these IDs.
208
+ # Optional. List all [ErrorGroupStats]
209
+ # [google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats] with these
210
+ # IDs. The `group_id` is a unique identifier for a particular error group.
211
+ # The identifier is derived from key parts of the error-log content and is
212
+ # treated as Service Data. For information about how Service Data
213
+ # is handled, see [Google Cloud Privacy Notice]
214
+ # (https://cloud.google.com/terms/cloud-privacy-notice).
196
215
  # @param service_filter [::Google::Cloud::ErrorReporting::V1beta1::ServiceContextFilter, ::Hash]
197
- # Optional. List only <code>ErrorGroupStats</code> which belong to a service
198
- # context that matches the filter.
199
- # Data for all service contexts is returned if this field is not specified.
216
+ # Optional. List only [ErrorGroupStats]
217
+ # [google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats] which belong
218
+ # to a service context that matches the filter. Data for all service contexts
219
+ # is returned if this field is not specified.
200
220
  # @param time_range [::Google::Cloud::ErrorReporting::V1beta1::QueryTimeRange, ::Hash]
201
221
  # Optional. List data for the given time range.
202
222
  # If not set, a default time range is used. The field
203
- # <code>time_range_begin</code> in the response will specify the beginning
204
- # of this time range.
205
- # Only <code>ErrorGroupStats</code> with a non-zero count in the given time
206
- # range are returned, unless the request contains an explicit
207
- # <code>group_id</code> list. If a <code>group_id</code> list is given, also
208
- # <code>ErrorGroupStats</code> with zero occurrences are returned.
223
+ # [time_range_begin]
224
+ # [google.devtools.clouderrorreporting.v1beta1.ListGroupStatsResponse.time_range_begin]
225
+ # in the response will specify the beginning of this time range. Only
226
+ # [ErrorGroupStats]
227
+ # [google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats] with a
228
+ # non-zero count in the given time range are returned, unless the request
229
+ # contains an explicit [group_id]
230
+ # [google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.group_id]
231
+ # list. If a [group_id]
232
+ # [google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.group_id]
233
+ # list is given, also [ErrorGroupStats]
234
+ # [google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats] with zero
235
+ # occurrences are returned.
209
236
  # @param timed_count_duration [::Google::Protobuf::Duration, ::Hash]
210
- # Optional. The preferred duration for a single returned `TimedCount`.
211
- # If not set, no timed counts are returned.
237
+ # Optional. The preferred duration for a single returned [TimedCount]
238
+ # [google.devtools.clouderrorreporting.v1beta1.TimedCount]. If not set, no
239
+ # timed counts are returned.
212
240
  # @param alignment [::Google::Cloud::ErrorReporting::V1beta1::TimedCountAlignment]
213
241
  # Optional. The alignment of the timed counts to be returned.
214
242
  # Default is `ALIGNMENT_EQUAL_AT_END`.
@@ -222,9 +250,10 @@ module Google
222
250
  # Optional. The maximum number of results to return per response.
223
251
  # Default is 20.
224
252
  # @param page_token [::String]
225
- # Optional. A `next_page_token` provided by a previous response. To view
226
- # additional results, pass this token along with the identical query
227
- # parameters as the first request.
253
+ # Optional. A [next_page_token]
254
+ # [google.devtools.clouderrorreporting.v1beta1.ListGroupStatsResponse.next_page_token]
255
+ # provided by a previous response. To view additional results, pass this
256
+ # token along with the identical query parameters as the first request.
228
257
  #
229
258
  # @yield [response, operation] Access the result along with the RPC operation
230
259
  # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ErrorReporting::V1beta1::ErrorGroupStats>]
@@ -264,10 +293,11 @@ module Google
264
293
  # Customize the options with defaults
265
294
  metadata = @config.rpcs.list_group_stats.metadata.to_h
266
295
 
267
- # Set x-goog-api-client and x-goog-user-project headers
296
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
268
297
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
269
298
  lib_name: @config.lib_name, lib_version: @config.lib_version,
270
299
  gapic_version: ::Google::Cloud::ErrorReporting::V1beta1::VERSION
300
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
271
301
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
272
302
 
273
303
  header_params = {}
@@ -315,13 +345,24 @@ module Google
315
345
  #
316
346
  # @param project_name [::String]
317
347
  # Required. The resource name of the Google Cloud Platform project. Written
318
- # as `projects/{projectID}`, where `{projectID}` is the
319
- # [Google Cloud Platform project
320
- # ID](https://support.google.com/cloud/answer/6158840).
348
+ # as `projects/{projectID}` or `projects/{projectID}/locations/{location}`,
349
+ # where `{projectID}` is the [Google Cloud Platform project
350
+ # ID](https://support.google.com/cloud/answer/6158840) and `{location}` is
351
+ # a Cloud region.
352
+ #
353
+ # Examples: `projects/my-project-123`,
354
+ # `projects/my-project-123/locations/global`.
321
355
  #
322
- # Example: `projects/my-project-123`.
356
+ # For a list of supported locations, see [Supported
357
+ # Regions](https://cloud.google.com/logging/docs/region-support). `global` is
358
+ # the default when unspecified.
323
359
  # @param group_id [::String]
324
360
  # Required. The group for which events shall be returned.
361
+ # The `group_id` is a unique identifier for a particular error group. The
362
+ # identifier is derived from key parts of the error-log content and is
363
+ # treated as Service Data. For information about how Service Data
364
+ # is handled, see [Google Cloud Privacy
365
+ # Notice](https://cloud.google.com/terms/cloud-privacy-notice).
325
366
  # @param service_filter [::Google::Cloud::ErrorReporting::V1beta1::ServiceContextFilter, ::Hash]
326
367
  # Optional. List only ErrorGroups which belong to a service context that
327
368
  # matches the filter.
@@ -373,10 +414,11 @@ module Google
373
414
  # Customize the options with defaults
374
415
  metadata = @config.rpcs.list_events.metadata.to_h
375
416
 
376
- # Set x-goog-api-client and x-goog-user-project headers
417
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
377
418
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
378
419
  lib_name: @config.lib_name, lib_version: @config.lib_version,
379
420
  gapic_version: ::Google::Cloud::ErrorReporting::V1beta1::VERSION
421
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
380
422
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
381
423
 
382
424
  header_params = {}
@@ -424,11 +466,17 @@ module Google
424
466
  #
425
467
  # @param project_name [::String]
426
468
  # Required. The resource name of the Google Cloud Platform project. Written
427
- # as `projects/{projectID}`, where `{projectID}` is the
428
- # [Google Cloud Platform project
429
- # ID](https://support.google.com/cloud/answer/6158840).
469
+ # as `projects/{projectID}` or `projects/{projectID}/locations/{location}`,
470
+ # where `{projectID}` is the [Google Cloud Platform project
471
+ # ID](https://support.google.com/cloud/answer/6158840) and `{location}` is
472
+ # a Cloud region.
473
+ #
474
+ # Examples: `projects/my-project-123`,
475
+ # `projects/my-project-123/locations/global`.
430
476
  #
431
- # Example: `projects/my-project-123`.
477
+ # For a list of supported locations, see [Supported
478
+ # Regions](https://cloud.google.com/logging/docs/region-support). `global` is
479
+ # the default when unspecified.
432
480
  #
433
481
  # @yield [response, operation] Access the result along with the RPC operation
434
482
  # @yieldparam response [::Google::Cloud::ErrorReporting::V1beta1::DeleteEventsResponse]
@@ -464,10 +512,11 @@ module Google
464
512
  # Customize the options with defaults
465
513
  metadata = @config.rpcs.delete_events.metadata.to_h
466
514
 
467
- # Set x-goog-api-client and x-goog-user-project headers
515
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
468
516
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
469
517
  lib_name: @config.lib_name, lib_version: @config.lib_version,
470
518
  gapic_version: ::Google::Cloud::ErrorReporting::V1beta1::VERSION
519
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
471
520
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
472
521
 
473
522
  header_params = {}
@@ -33,6 +33,9 @@ module Google
33
33
  # individual events.
34
34
  #
35
35
  class Client
36
+ # @private
37
+ API_VERSION = ""
38
+
36
39
  # @private
37
40
  DEFAULT_ENDPOINT_TEMPLATE = "clouderrorreporting.$UNIVERSE_DOMAIN$"
38
41
 
@@ -179,29 +182,54 @@ module Google
179
182
  #
180
183
  # @param project_name [::String]
181
184
  # Required. The resource name of the Google Cloud Platform project. Written
182
- # as `projects/{projectID}` or `projects/{projectNumber}`, where `{projectID}`
183
- # and `{projectNumber}` can be found in the
184
- # [Google Cloud Console](https://support.google.com/cloud/answer/6158840).
185
- #
186
- # Examples: `projects/my-project-123`, `projects/5551234`.
185
+ # as `projects/{projectID}` or `projects/{projectNumber}`, where
186
+ # `{projectID}` and `{projectNumber}` can be found in the
187
+ # [Google Cloud console](https://support.google.com/cloud/answer/6158840).
188
+ # It may also include a location, such as
189
+ # `projects/{projectID}/locations/{location}` where `{location}` is a cloud
190
+ # region.
191
+ #
192
+ # Examples: `projects/my-project-123`, `projects/5551234`,
193
+ # `projects/my-project-123/locations/us-central1`,
194
+ # `projects/5551234/locations/us-central1`.
195
+ #
196
+ # For a list of supported locations, see [Supported
197
+ # Regions](https://cloud.google.com/logging/docs/region-support). `global` is
198
+ # the default when unspecified. Use `-` as a wildcard to request group stats
199
+ # from all regions.
187
200
  # @param group_id [::Array<::String>]
188
- # Optional. List all <code>ErrorGroupStats</code> with these IDs.
201
+ # Optional. List all [ErrorGroupStats]
202
+ # [google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats] with these
203
+ # IDs. The `group_id` is a unique identifier for a particular error group.
204
+ # The identifier is derived from key parts of the error-log content and is
205
+ # treated as Service Data. For information about how Service Data
206
+ # is handled, see [Google Cloud Privacy Notice]
207
+ # (https://cloud.google.com/terms/cloud-privacy-notice).
189
208
  # @param service_filter [::Google::Cloud::ErrorReporting::V1beta1::ServiceContextFilter, ::Hash]
190
- # Optional. List only <code>ErrorGroupStats</code> which belong to a service
191
- # context that matches the filter.
192
- # Data for all service contexts is returned if this field is not specified.
209
+ # Optional. List only [ErrorGroupStats]
210
+ # [google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats] which belong
211
+ # to a service context that matches the filter. Data for all service contexts
212
+ # is returned if this field is not specified.
193
213
  # @param time_range [::Google::Cloud::ErrorReporting::V1beta1::QueryTimeRange, ::Hash]
194
214
  # Optional. List data for the given time range.
195
215
  # If not set, a default time range is used. The field
196
- # <code>time_range_begin</code> in the response will specify the beginning
197
- # of this time range.
198
- # Only <code>ErrorGroupStats</code> with a non-zero count in the given time
199
- # range are returned, unless the request contains an explicit
200
- # <code>group_id</code> list. If a <code>group_id</code> list is given, also
201
- # <code>ErrorGroupStats</code> with zero occurrences are returned.
216
+ # [time_range_begin]
217
+ # [google.devtools.clouderrorreporting.v1beta1.ListGroupStatsResponse.time_range_begin]
218
+ # in the response will specify the beginning of this time range. Only
219
+ # [ErrorGroupStats]
220
+ # [google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats] with a
221
+ # non-zero count in the given time range are returned, unless the request
222
+ # contains an explicit [group_id]
223
+ # [google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.group_id]
224
+ # list. If a [group_id]
225
+ # [google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.group_id]
226
+ # list is given, also [ErrorGroupStats]
227
+ # [google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats] with zero
228
+ # occurrences are returned.
202
229
  # @param timed_count_duration [::Google::Protobuf::Duration, ::Hash]
203
- # Optional. The preferred duration for a single returned `TimedCount`.
204
- # If not set, no timed counts are returned.
230
+ # Optional. The preferred duration for a single returned [TimedCount]
231
+ # [google.devtools.clouderrorreporting.v1beta1.TimedCount]. If not set, no
232
+ # timed counts are returned.
205
233
  # @param alignment [::Google::Cloud::ErrorReporting::V1beta1::TimedCountAlignment]
206
234
  # Optional. The alignment of the timed counts to be returned.
207
235
  # Default is `ALIGNMENT_EQUAL_AT_END`.
@@ -215,9 +243,10 @@ module Google
215
243
  # Optional. The maximum number of results to return per response.
216
244
  # Default is 20.
217
245
  # @param page_token [::String]
218
- # Optional. A `next_page_token` provided by a previous response. To view
219
- # additional results, pass this token along with the identical query
220
- # parameters as the first request.
246
+ # Optional. A [next_page_token]
247
+ # [google.devtools.clouderrorreporting.v1beta1.ListGroupStatsResponse.next_page_token]
248
+ # provided by a previous response. To view additional results, pass this
249
+ # token along with the identical query parameters as the first request.
221
250
  # @yield [result, operation] Access the result along with the TransportOperation object
222
251
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ErrorReporting::V1beta1::ErrorGroupStats>]
223
252
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -256,12 +285,13 @@ module Google
256
285
  # Customize the options with defaults
257
286
  call_metadata = @config.rpcs.list_group_stats.metadata.to_h
258
287
 
259
- # Set x-goog-api-client and x-goog-user-project headers
288
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
260
289
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
261
290
  lib_name: @config.lib_name, lib_version: @config.lib_version,
262
291
  gapic_version: ::Google::Cloud::ErrorReporting::V1beta1::VERSION,
263
292
  transports_version_send: [:rest]
264
293
 
294
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
265
295
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
266
296
 
267
297
  options.apply_defaults timeout: @config.rpcs.list_group_stats.timeout,
@@ -301,13 +331,24 @@ module Google
301
331
  #
302
332
  # @param project_name [::String]
303
333
  # Required. The resource name of the Google Cloud Platform project. Written
304
- # as `projects/{projectID}`, where `{projectID}` is the
305
- # [Google Cloud Platform project
306
- # ID](https://support.google.com/cloud/answer/6158840).
334
+ # as `projects/{projectID}` or `projects/{projectID}/locations/{location}`,
335
+ # where `{projectID}` is the [Google Cloud Platform project
336
+ # ID](https://support.google.com/cloud/answer/6158840) and `{location}` is
337
+ # a Cloud region.
338
+ #
339
+ # Examples: `projects/my-project-123`,
340
+ # `projects/my-project-123/locations/global`.
307
341
  #
308
- # Example: `projects/my-project-123`.
342
+ # For a list of supported locations, see [Supported
343
+ # Regions](https://cloud.google.com/logging/docs/region-support). `global` is
344
+ # the default when unspecified.
309
345
  # @param group_id [::String]
310
346
  # Required. The group for which events shall be returned.
347
+ # The `group_id` is a unique identifier for a particular error group. The
348
+ # identifier is derived from key parts of the error-log content and is
349
+ # treated as Service Data. For information about how Service Data
350
+ # is handled, see [Google Cloud Privacy
351
+ # Notice](https://cloud.google.com/terms/cloud-privacy-notice).
311
352
  # @param service_filter [::Google::Cloud::ErrorReporting::V1beta1::ServiceContextFilter, ::Hash]
312
353
  # Optional. List only ErrorGroups which belong to a service context that
313
354
  # matches the filter.
@@ -358,12 +399,13 @@ module Google
358
399
  # Customize the options with defaults
359
400
  call_metadata = @config.rpcs.list_events.metadata.to_h
360
401
 
361
- # Set x-goog-api-client and x-goog-user-project headers
402
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
362
403
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
363
404
  lib_name: @config.lib_name, lib_version: @config.lib_version,
364
405
  gapic_version: ::Google::Cloud::ErrorReporting::V1beta1::VERSION,
365
406
  transports_version_send: [:rest]
366
407
 
408
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
367
409
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
368
410
 
369
411
  options.apply_defaults timeout: @config.rpcs.list_events.timeout,
@@ -403,11 +445,17 @@ module Google
403
445
  #
404
446
  # @param project_name [::String]
405
447
  # Required. The resource name of the Google Cloud Platform project. Written
406
- # as `projects/{projectID}`, where `{projectID}` is the
407
- # [Google Cloud Platform project
408
- # ID](https://support.google.com/cloud/answer/6158840).
448
+ # as `projects/{projectID}` or `projects/{projectID}/locations/{location}`,
449
+ # where `{projectID}` is the [Google Cloud Platform project
450
+ # ID](https://support.google.com/cloud/answer/6158840) and `{location}` is
451
+ # a Cloud region.
452
+ #
453
+ # Examples: `projects/my-project-123`,
454
+ # `projects/my-project-123/locations/global`.
409
455
  #
410
- # Example: `projects/my-project-123`.
456
+ # For a list of supported locations, see [Supported
457
+ # Regions](https://cloud.google.com/logging/docs/region-support). `global` is
458
+ # the default when unspecified.
411
459
  # @yield [result, operation] Access the result along with the TransportOperation object
412
460
  # @yieldparam result [::Google::Cloud::ErrorReporting::V1beta1::DeleteEventsResponse]
413
461
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -442,12 +490,13 @@ module Google
442
490
  # Customize the options with defaults
443
491
  call_metadata = @config.rpcs.delete_events.metadata.to_h
444
492
 
445
- # Set x-goog-api-client and x-goog-user-project headers
493
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
446
494
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
447
495
  lib_name: @config.lib_name, lib_version: @config.lib_version,
448
496
  gapic_version: ::Google::Cloud::ErrorReporting::V1beta1::VERSION,
449
497
  transports_version_send: [:rest]
450
498
 
499
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
451
500
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
452
501
 
453
502
  options.apply_defaults timeout: @config.rpcs.delete_events.timeout,
@@ -193,6 +193,13 @@ module Google
193
193
  ["project_name", %r{^projects/[^/]+/?$}, false]
194
194
  ]
195
195
  )
196
+ .with_bindings(
197
+ uri_method: :get,
198
+ uri_template: "/v1beta1/{project_name}/groupStats",
199
+ matches: [
200
+ ["project_name", %r{^projects/[^/]+/locations/[^/]+/?$}, false]
201
+ ]
202
+ )
196
203
  transcoder.transcode request_pb
197
204
  end
198
205
 
@@ -214,6 +221,13 @@ module Google
214
221
  ["project_name", %r{^projects/[^/]+/?$}, false]
215
222
  ]
216
223
  )
224
+ .with_bindings(
225
+ uri_method: :get,
226
+ uri_template: "/v1beta1/{project_name}/events",
227
+ matches: [
228
+ ["project_name", %r{^projects/[^/]+/locations/[^/]+/?$}, false]
229
+ ]
230
+ )
217
231
  transcoder.transcode request_pb
218
232
  end
219
233
 
@@ -235,6 +249,13 @@ module Google
235
249
  ["project_name", %r{^projects/[^/]+/?$}, false]
236
250
  ]
237
251
  )
252
+ .with_bindings(
253
+ uri_method: :delete,
254
+ uri_template: "/v1beta1/{project_name}/events",
255
+ matches: [
256
+ ["project_name", %r{^projects/[^/]+/locations/[^/]+/?$}, false]
257
+ ]
258
+ )
238
259
  transcoder.transcode request_pb
239
260
  end
240
261
  end
@@ -30,6 +30,9 @@ module Google
30
30
  # An API for reporting error events.
31
31
  #
32
32
  class Client
33
+ # @private
34
+ API_VERSION = ""
35
+
33
36
  # @private
34
37
  DEFAULT_ENDPOINT_TEMPLATE = "clouderrorreporting.$UNIVERSE_DOMAIN$"
35
38
 
@@ -173,9 +176,16 @@ module Google
173
176
  # `POST
174
177
  # https://clouderrorreporting.googleapis.com/v1beta1/\\{projectName}/events:report?key=123ABC456`
175
178
  #
176
- # **Note:** [Error Reporting](/error-reporting) is a global service built
177
- # on Cloud Logging and doesn't analyze logs stored
178
- # in regional log buckets or logs routed to other Google Cloud projects.
179
+ # **Note:** [Error Reporting] (https://cloud.google.com/error-reporting)
180
+ # is a service built on Cloud Logging and can analyze log entries when all of
181
+ # the following are true:
182
+ #
183
+ # * Customer-managed encryption keys (CMEK) are disabled on the log bucket.
184
+ # * The log bucket satisfies one of the following:
185
+ # * The log bucket is stored in the same project where the logs
186
+ # originated.
187
+ # * The logs were routed to a project, and then that project stored those
188
+ # logs in a log bucket that it owns.
179
189
  #
180
190
  # @overload report_error_event(request, options = nil)
181
191
  # Pass arguments to `report_error_event` via a request object, either of type
@@ -236,10 +246,11 @@ module Google
236
246
  # Customize the options with defaults
237
247
  metadata = @config.rpcs.report_error_event.metadata.to_h
238
248
 
239
- # Set x-goog-api-client and x-goog-user-project headers
249
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
240
250
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
241
251
  lib_name: @config.lib_name, lib_version: @config.lib_version,
242
252
  gapic_version: ::Google::Cloud::ErrorReporting::V1beta1::VERSION
253
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
243
254
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
244
255
 
245
256
  header_params = {}
@@ -32,6 +32,9 @@ module Google
32
32
  # An API for reporting error events.
33
33
  #
34
34
  class Client
35
+ # @private
36
+ API_VERSION = ""
37
+
35
38
  # @private
36
39
  DEFAULT_ENDPOINT_TEMPLATE = "clouderrorreporting.$UNIVERSE_DOMAIN$"
37
40
 
@@ -166,9 +169,16 @@ module Google
166
169
  # `POST
167
170
  # https://clouderrorreporting.googleapis.com/v1beta1/\\{projectName}/events:report?key=123ABC456`
168
171
  #
169
- # **Note:** [Error Reporting](/error-reporting) is a global service built
170
- # on Cloud Logging and doesn't analyze logs stored
171
- # in regional log buckets or logs routed to other Google Cloud projects.
172
+ # **Note:** [Error Reporting] (https://cloud.google.com/error-reporting)
173
+ # is a service built on Cloud Logging and can analyze log entries when all of
174
+ # the following are true:
175
+ #
176
+ # * Customer-managed encryption keys (CMEK) are disabled on the log bucket.
177
+ # * The log bucket satisfies one of the following:
178
+ # * The log bucket is stored in the same project where the logs
179
+ # originated.
180
+ # * The logs were routed to a project, and then that project stored those
181
+ # logs in a log bucket that it owns.
172
182
  #
173
183
  # @overload report_error_event(request, options = nil)
174
184
  # Pass arguments to `report_error_event` via a request object, either of type
@@ -228,12 +238,13 @@ module Google
228
238
  # Customize the options with defaults
229
239
  call_metadata = @config.rpcs.report_error_event.metadata.to_h
230
240
 
231
- # Set x-goog-api-client and x-goog-user-project headers
241
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
232
242
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
233
243
  lib_name: @config.lib_name, lib_version: @config.lib_version,
234
244
  gapic_version: ::Google::Cloud::ErrorReporting::V1beta1::VERSION,
235
245
  transports_version_send: [:rest]
236
246
 
247
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
237
248
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
238
249
 
239
250
  options.apply_defaults timeout: @config.rpcs.report_error_event.timeout,
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module ErrorReporting
23
23
  module V1beta1
24
- VERSION = "0.10.0"
24
+ VERSION = "0.11.0"
25
25
  end
26
26
  end
27
27
  end
@@ -11,7 +11,7 @@ require 'google/api/resource_pb'
11
11
  require 'google/devtools/clouderrorreporting/v1beta1/common_pb'
12
12
 
13
13
 
14
- descriptor_data = "\nEgoogle/devtools/clouderrorreporting/v1beta1/error_group_service.proto\x12+google.devtools.clouderrorreporting.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x38google/devtools/clouderrorreporting/v1beta1/common.proto\"\\\n\x0fGetGroupRequest\x12I\n\ngroup_name\x18\x01 \x01(\tB5\xe0\x41\x02\xfa\x41/\n-clouderrorreporting.googleapis.com/ErrorGroup\"a\n\x12UpdateGroupRequest\x12K\n\x05group\x18\x01 \x01(\x0b\x32\x37.google.devtools.clouderrorreporting.v1beta1.ErrorGroupB\x03\xe0\x41\x02\x32\xfb\x03\n\x11\x45rrorGroupService\x12\xc1\x01\n\x08GetGroup\x12<.google.devtools.clouderrorreporting.v1beta1.GetGroupRequest\x1a\x37.google.devtools.clouderrorreporting.v1beta1.ErrorGroup\">\xda\x41\ngroup_name\x82\xd3\xe4\x93\x02+\x12)/v1beta1/{group_name=projects/*/groups/*}\x12\xc9\x01\n\x0bUpdateGroup\x12?.google.devtools.clouderrorreporting.v1beta1.UpdateGroupRequest\x1a\x37.google.devtools.clouderrorreporting.v1beta1.ErrorGroup\"@\xda\x41\x05group\x82\xd3\xe4\x93\x02\x32\x1a)/v1beta1/{group.name=projects/*/groups/*}:\x05group\x1aV\xca\x41\"clouderrorreporting.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\x94\x02\n/com.google.devtools.clouderrorreporting.v1beta1B\x16\x45rrorGroupServiceProtoP\x01ZOcloud.google.com/go/errorreporting/apiv1beta1/errorreportingpb;errorreportingpb\xf8\x01\x01\xaa\x02#Google.Cloud.ErrorReporting.V1Beta1\xca\x02#Google\\Cloud\\ErrorReporting\\V1beta1\xea\x02&Google::Cloud::ErrorReporting::V1beta1b\x06proto3"
14
+ descriptor_data = "\nEgoogle/devtools/clouderrorreporting/v1beta1/error_group_service.proto\x12+google.devtools.clouderrorreporting.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x38google/devtools/clouderrorreporting/v1beta1/common.proto\"\\\n\x0fGetGroupRequest\x12I\n\ngroup_name\x18\x01 \x01(\tB5\xe0\x41\x02\xfa\x41/\n-clouderrorreporting.googleapis.com/ErrorGroup\"a\n\x12UpdateGroupRequest\x12K\n\x05group\x18\x01 \x01(\x0b\x32\x37.google.devtools.clouderrorreporting.v1beta1.ErrorGroupB\x03\xe0\x41\x02\x32\xf5\x04\n\x11\x45rrorGroupService\x12\xfa\x01\n\x08GetGroup\x12<.google.devtools.clouderrorreporting.v1beta1.GetGroupRequest\x1a\x37.google.devtools.clouderrorreporting.v1beta1.ErrorGroup\"w\xda\x41\ngroup_name\x82\xd3\xe4\x93\x02\x64\x12)/v1beta1/{group_name=projects/*/groups/*}Z7\x12\x35/v1beta1/{group_name=projects/*/locations/*/groups/*}\x12\x8a\x02\n\x0bUpdateGroup\x12?.google.devtools.clouderrorreporting.v1beta1.UpdateGroupRequest\x1a\x37.google.devtools.clouderrorreporting.v1beta1.ErrorGroup\"\x80\x01\xda\x41\x05group\x82\xd3\xe4\x93\x02r\x1a)/v1beta1/{group.name=projects/*/groups/*}:\x05groupZ>\x1a\x35/v1beta1/{group.name=projects/*/locations/*/groups/*}:\x05group\x1aV\xca\x41\"clouderrorreporting.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\x94\x02\n/com.google.devtools.clouderrorreporting.v1beta1B\x16\x45rrorGroupServiceProtoP\x01ZOcloud.google.com/go/errorreporting/apiv1beta1/errorreportingpb;errorreportingpb\xf8\x01\x01\xaa\x02#Google.Cloud.ErrorReporting.V1Beta1\xca\x02#Google\\Cloud\\ErrorReporting\\V1beta1\xea\x02&Google::Cloud::ErrorReporting::V1beta1b\x06proto3"
15
15
 
16
16
  pool = Google::Protobuf::DescriptorPool.generated_pool
17
17
 
@@ -13,7 +13,7 @@ require 'google/protobuf/duration_pb'
13
13
  require 'google/protobuf/timestamp_pb'
14
14
 
15
15
 
16
- descriptor_data = "\nEgoogle/devtools/clouderrorreporting/v1beta1/error_stats_service.proto\x12+google.devtools.clouderrorreporting.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x38google/devtools/clouderrorreporting/v1beta1/common.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\x83\x05\n\x15ListGroupStatsRequest\x12I\n\x0cproject_name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+cloudresourcemanager.googleapis.com/Project\x12\x15\n\x08group_id\x18\x02 \x03(\tB\x03\xe0\x41\x01\x12^\n\x0eservice_filter\x18\x03 \x01(\x0b\x32\x41.google.devtools.clouderrorreporting.v1beta1.ServiceContextFilterB\x03\xe0\x41\x01\x12T\n\ntime_range\x18\x05 \x01(\x0b\x32;.google.devtools.clouderrorreporting.v1beta1.QueryTimeRangeB\x03\xe0\x41\x01\x12<\n\x14timed_count_duration\x18\x06 \x01(\x0b\x32\x19.google.protobuf.DurationB\x03\xe0\x41\x01\x12X\n\talignment\x18\x07 \x01(\x0e\x32@.google.devtools.clouderrorreporting.v1beta1.TimedCountAlignmentB\x03\xe0\x41\x01\x12\x37\n\x0e\x61lignment_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x01\x12P\n\x05order\x18\t \x01(\x0e\x32<.google.devtools.clouderrorreporting.v1beta1.ErrorGroupOrderB\x03\xe0\x41\x01\x12\x16\n\tpage_size\x18\x0b \x01(\x05\x42\x03\xe0\x41\x01\x12\x17\n\npage_token\x18\x0c \x01(\tB\x03\xe0\x41\x01\"\xc0\x01\n\x16ListGroupStatsResponse\x12W\n\x11\x65rror_group_stats\x18\x01 \x03(\x0b\x32<.google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x34\n\x10time_range_begin\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\x86\x04\n\x0f\x45rrorGroupStats\x12\x46\n\x05group\x18\x01 \x01(\x0b\x32\x37.google.devtools.clouderrorreporting.v1beta1.ErrorGroup\x12\r\n\x05\x63ount\x18\x02 \x01(\x03\x12\x1c\n\x14\x61\x66\x66\x65\x63ted_users_count\x18\x03 \x01(\x03\x12M\n\x0ctimed_counts\x18\x04 \x03(\x0b\x32\x37.google.devtools.clouderrorreporting.v1beta1.TimedCount\x12\x33\n\x0f\x66irst_seen_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x32\n\x0elast_seen_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12V\n\x11\x61\x66\x66\x65\x63ted_services\x18\x07 \x03(\x0b\x32;.google.devtools.clouderrorreporting.v1beta1.ServiceContext\x12\x1d\n\x15num_affected_services\x18\x08 \x01(\x05\x12O\n\x0erepresentative\x18\t \x01(\x0b\x32\x37.google.devtools.clouderrorreporting.v1beta1.ErrorEvent\"y\n\nTimedCount\x12\r\n\x05\x63ount\x18\x01 \x01(\x03\x12.\n\nstart_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xdc\x02\n\x11ListEventsRequest\x12I\n\x0cproject_name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+cloudresourcemanager.googleapis.com/Project\x12\x15\n\x08group_id\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12^\n\x0eservice_filter\x18\x03 \x01(\x0b\x32\x41.google.devtools.clouderrorreporting.v1beta1.ServiceContextFilterB\x03\xe0\x41\x01\x12T\n\ntime_range\x18\x04 \x01(\x0b\x32;.google.devtools.clouderrorreporting.v1beta1.QueryTimeRangeB\x03\xe0\x41\x01\x12\x16\n\tpage_size\x18\x06 \x01(\x05\x42\x03\xe0\x41\x01\x12\x17\n\npage_token\x18\x07 \x01(\tB\x03\xe0\x41\x01\"\xb2\x01\n\x12ListEventsResponse\x12M\n\x0c\x65rror_events\x18\x01 \x03(\x0b\x32\x37.google.devtools.clouderrorreporting.v1beta1.ErrorEvent\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x34\n\x10time_range_begin\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xe7\x01\n\x0eQueryTimeRange\x12R\n\x06period\x18\x01 \x01(\x0e\x32\x42.google.devtools.clouderrorreporting.v1beta1.QueryTimeRange.Period\"\x80\x01\n\x06Period\x12\x16\n\x12PERIOD_UNSPECIFIED\x10\x00\x12\x11\n\rPERIOD_1_HOUR\x10\x01\x12\x12\n\x0ePERIOD_6_HOURS\x10\x02\x12\x10\n\x0cPERIOD_1_DAY\x10\x03\x12\x11\n\rPERIOD_1_WEEK\x10\x04\x12\x12\n\x0ePERIOD_30_DAYS\x10\x05\"^\n\x14ServiceContextFilter\x12\x14\n\x07service\x18\x02 \x01(\tB\x03\xe0\x41\x01\x12\x14\n\x07version\x18\x03 \x01(\tB\x03\xe0\x41\x01\x12\x1a\n\rresource_type\x18\x04 \x01(\tB\x03\xe0\x41\x01\"`\n\x13\x44\x65leteEventsRequest\x12I\n\x0cproject_name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+cloudresourcemanager.googleapis.com/Project\"\x16\n\x14\x44\x65leteEventsResponse*u\n\x13TimedCountAlignment\x12%\n!ERROR_COUNT_ALIGNMENT_UNSPECIFIED\x10\x00\x12\x1b\n\x17\x41LIGNMENT_EQUAL_ROUNDED\x10\x01\x12\x1a\n\x16\x41LIGNMENT_EQUAL_AT_END\x10\x02*}\n\x0f\x45rrorGroupOrder\x12\x1b\n\x17GROUP_ORDER_UNSPECIFIED\x10\x00\x12\x0e\n\nCOUNT_DESC\x10\x01\x12\x12\n\x0eLAST_SEEN_DESC\x10\x02\x12\x10\n\x0c\x43REATED_DESC\x10\x03\x12\x17\n\x13\x41\x46\x46\x45\x43TED_USERS_DESC\x10\x04\x32\x8b\x06\n\x11\x45rrorStatsService\x12\xea\x01\n\x0eListGroupStats\x12\x42.google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest\x1a\x43.google.devtools.clouderrorreporting.v1beta1.ListGroupStatsResponse\"O\xda\x41\x17project_name,time_range\x82\xd3\xe4\x93\x02/\x12-/v1beta1/{project_name=projects/*}/groupStats\x12\xd8\x01\n\nListEvents\x12>.google.devtools.clouderrorreporting.v1beta1.ListEventsRequest\x1a?.google.devtools.clouderrorreporting.v1beta1.ListEventsResponse\"I\xda\x41\x15project_name,group_id\x82\xd3\xe4\x93\x02+\x12)/v1beta1/{project_name=projects/*}/events\x12\xd5\x01\n\x0c\x44\x65leteEvents\x12@.google.devtools.clouderrorreporting.v1beta1.DeleteEventsRequest\x1a\x41.google.devtools.clouderrorreporting.v1beta1.DeleteEventsResponse\"@\xda\x41\x0cproject_name\x82\xd3\xe4\x93\x02+*)/v1beta1/{project_name=projects/*}/events\x1aV\xca\x41\"clouderrorreporting.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\x94\x02\n/com.google.devtools.clouderrorreporting.v1beta1B\x16\x45rrorStatsServiceProtoP\x01ZOcloud.google.com/go/errorreporting/apiv1beta1/errorreportingpb;errorreportingpb\xf8\x01\x01\xaa\x02#Google.Cloud.ErrorReporting.V1Beta1\xca\x02#Google\\Cloud\\ErrorReporting\\V1beta1\xea\x02&Google::Cloud::ErrorReporting::V1beta1b\x06proto3"
16
+ descriptor_data = "\nEgoogle/devtools/clouderrorreporting/v1beta1/error_stats_service.proto\x12+google.devtools.clouderrorreporting.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x38google/devtools/clouderrorreporting/v1beta1/common.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\x83\x05\n\x15ListGroupStatsRequest\x12I\n\x0cproject_name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+cloudresourcemanager.googleapis.com/Project\x12\x15\n\x08group_id\x18\x02 \x03(\tB\x03\xe0\x41\x01\x12^\n\x0eservice_filter\x18\x03 \x01(\x0b\x32\x41.google.devtools.clouderrorreporting.v1beta1.ServiceContextFilterB\x03\xe0\x41\x01\x12T\n\ntime_range\x18\x05 \x01(\x0b\x32;.google.devtools.clouderrorreporting.v1beta1.QueryTimeRangeB\x03\xe0\x41\x01\x12<\n\x14timed_count_duration\x18\x06 \x01(\x0b\x32\x19.google.protobuf.DurationB\x03\xe0\x41\x01\x12X\n\talignment\x18\x07 \x01(\x0e\x32@.google.devtools.clouderrorreporting.v1beta1.TimedCountAlignmentB\x03\xe0\x41\x01\x12\x37\n\x0e\x61lignment_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x01\x12P\n\x05order\x18\t \x01(\x0e\x32<.google.devtools.clouderrorreporting.v1beta1.ErrorGroupOrderB\x03\xe0\x41\x01\x12\x16\n\tpage_size\x18\x0b \x01(\x05\x42\x03\xe0\x41\x01\x12\x17\n\npage_token\x18\x0c \x01(\tB\x03\xe0\x41\x01\"\xc0\x01\n\x16ListGroupStatsResponse\x12W\n\x11\x65rror_group_stats\x18\x01 \x03(\x0b\x32<.google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x34\n\x10time_range_begin\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\x86\x04\n\x0f\x45rrorGroupStats\x12\x46\n\x05group\x18\x01 \x01(\x0b\x32\x37.google.devtools.clouderrorreporting.v1beta1.ErrorGroup\x12\r\n\x05\x63ount\x18\x02 \x01(\x03\x12\x1c\n\x14\x61\x66\x66\x65\x63ted_users_count\x18\x03 \x01(\x03\x12M\n\x0ctimed_counts\x18\x04 \x03(\x0b\x32\x37.google.devtools.clouderrorreporting.v1beta1.TimedCount\x12\x33\n\x0f\x66irst_seen_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x32\n\x0elast_seen_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12V\n\x11\x61\x66\x66\x65\x63ted_services\x18\x07 \x03(\x0b\x32;.google.devtools.clouderrorreporting.v1beta1.ServiceContext\x12\x1d\n\x15num_affected_services\x18\x08 \x01(\x05\x12O\n\x0erepresentative\x18\t \x01(\x0b\x32\x37.google.devtools.clouderrorreporting.v1beta1.ErrorEvent\"y\n\nTimedCount\x12\r\n\x05\x63ount\x18\x01 \x01(\x03\x12.\n\nstart_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xdc\x02\n\x11ListEventsRequest\x12I\n\x0cproject_name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+cloudresourcemanager.googleapis.com/Project\x12\x15\n\x08group_id\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12^\n\x0eservice_filter\x18\x03 \x01(\x0b\x32\x41.google.devtools.clouderrorreporting.v1beta1.ServiceContextFilterB\x03\xe0\x41\x01\x12T\n\ntime_range\x18\x04 \x01(\x0b\x32;.google.devtools.clouderrorreporting.v1beta1.QueryTimeRangeB\x03\xe0\x41\x01\x12\x16\n\tpage_size\x18\x06 \x01(\x05\x42\x03\xe0\x41\x01\x12\x17\n\npage_token\x18\x07 \x01(\tB\x03\xe0\x41\x01\"\xb2\x01\n\x12ListEventsResponse\x12M\n\x0c\x65rror_events\x18\x01 \x03(\x0b\x32\x37.google.devtools.clouderrorreporting.v1beta1.ErrorEvent\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x34\n\x10time_range_begin\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xe7\x01\n\x0eQueryTimeRange\x12R\n\x06period\x18\x01 \x01(\x0e\x32\x42.google.devtools.clouderrorreporting.v1beta1.QueryTimeRange.Period\"\x80\x01\n\x06Period\x12\x16\n\x12PERIOD_UNSPECIFIED\x10\x00\x12\x11\n\rPERIOD_1_HOUR\x10\x01\x12\x12\n\x0ePERIOD_6_HOURS\x10\x02\x12\x10\n\x0cPERIOD_1_DAY\x10\x03\x12\x11\n\rPERIOD_1_WEEK\x10\x04\x12\x12\n\x0ePERIOD_30_DAYS\x10\x05\"^\n\x14ServiceContextFilter\x12\x14\n\x07service\x18\x02 \x01(\tB\x03\xe0\x41\x01\x12\x14\n\x07version\x18\x03 \x01(\tB\x03\xe0\x41\x01\x12\x1a\n\rresource_type\x18\x04 \x01(\tB\x03\xe0\x41\x01\"`\n\x13\x44\x65leteEventsRequest\x12I\n\x0cproject_name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+cloudresourcemanager.googleapis.com/Project\"\x16\n\x14\x44\x65leteEventsResponse*u\n\x13TimedCountAlignment\x12%\n!ERROR_COUNT_ALIGNMENT_UNSPECIFIED\x10\x00\x12\x1b\n\x17\x41LIGNMENT_EQUAL_ROUNDED\x10\x01\x12\x1a\n\x16\x41LIGNMENT_EQUAL_AT_END\x10\x02*}\n\x0f\x45rrorGroupOrder\x12\x1b\n\x17GROUP_ORDER_UNSPECIFIED\x10\x00\x12\x0e\n\nCOUNT_DESC\x10\x01\x12\x12\n\x0eLAST_SEEN_DESC\x10\x02\x12\x10\n\x0c\x43REATED_DESC\x10\x03\x12\x17\n\x13\x41\x46\x46\x45\x43TED_USERS_DESC\x10\x04\x32\xbc\x07\n\x11\x45rrorStatsService\x12\xa8\x02\n\x0eListGroupStats\x12\x42.google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest\x1a\x43.google.devtools.clouderrorreporting.v1beta1.ListGroupStatsResponse\"\x8c\x01\xda\x41\x17project_name,time_range\x82\xd3\xe4\x93\x02l\x12-/v1beta1/{project_name=projects/*}/groupStatsZ;\x12\x39/v1beta1/{project_name=projects/*/locations/*}/groupStats\x12\x92\x02\n\nListEvents\x12>.google.devtools.clouderrorreporting.v1beta1.ListEventsRequest\x1a?.google.devtools.clouderrorreporting.v1beta1.ListEventsResponse\"\x82\x01\xda\x41\x15project_name,group_id\x82\xd3\xe4\x93\x02\x64\x12)/v1beta1/{project_name=projects/*}/eventsZ7\x12\x35/v1beta1/{project_name=projects/*/locations/*}/events\x12\x8e\x02\n\x0c\x44\x65leteEvents\x12@.google.devtools.clouderrorreporting.v1beta1.DeleteEventsRequest\x1a\x41.google.devtools.clouderrorreporting.v1beta1.DeleteEventsResponse\"y\xda\x41\x0cproject_name\x82\xd3\xe4\x93\x02\x64*)/v1beta1/{project_name=projects/*}/eventsZ7*5/v1beta1/{project_name=projects/*/locations/*}/events\x1aV\xca\x41\"clouderrorreporting.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\x94\x02\n/com.google.devtools.clouderrorreporting.v1beta1B\x16\x45rrorStatsServiceProtoP\x01ZOcloud.google.com/go/errorreporting/apiv1beta1/errorreportingpb;errorreportingpb\xf8\x01\x01\xaa\x02#Google.Cloud.ErrorReporting.V1Beta1\xca\x02#Google\\Cloud\\ErrorReporting\\V1beta1\xea\x02&Google::Cloud::ErrorReporting::V1beta1b\x06proto3"
17
17
 
18
18
  pool = Google::Protobuf::DescriptorPool.generated_pool
19
19
 
@@ -43,10 +43,16 @@ module Google
43
43
  # `POST
44
44
  # https://clouderrorreporting.googleapis.com/v1beta1/{projectName}/events:report?key=123ABC456`
45
45
  #
46
- # **Note:** [Error Reporting](/error-reporting) is a global service built
47
- # on Cloud Logging and doesn't analyze logs stored
48
- # in regional log buckets or logs routed to other Google Cloud projects.
46
+ # **Note:** [Error Reporting] (https://cloud.google.com/error-reporting)
47
+ # is a service built on Cloud Logging and can analyze log entries when all of
48
+ # the following are true:
49
49
  #
50
+ # * Customer-managed encryption keys (CMEK) are disabled on the log bucket.
51
+ # * The log bucket satisfies one of the following:
52
+ # * The log bucket is stored in the same project where the logs
53
+ # originated.
54
+ # * The logs were routed to a project, and then that project stored those
55
+ # logs in a log bucket that it owns.
50
56
  rpc :ReportErrorEvent, ::Google::Cloud::ErrorReporting::V1beta1::ReportErrorEventRequest, ::Google::Cloud::ErrorReporting::V1beta1::ReportErrorEventResponse
51
57
  end
52
58
 
@@ -118,6 +118,10 @@ module Google
118
118
  # @return [::String]
119
119
  # Optional link to proto reference documentation. Example:
120
120
  # https://cloud.google.com/pubsub/lite/docs/reference/rpc
121
+ # @!attribute [rw] rest_reference_documentation_uri
122
+ # @return [::String]
123
+ # Optional link to REST reference documentation. Example:
124
+ # https://cloud.google.com/pubsub/lite/docs/reference/rest
121
125
  class Publishing
122
126
  include ::Google::Protobuf::MessageExts
123
127
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -286,6 +290,13 @@ module Google
286
290
  # @return [::String]
287
291
  # The fully qualified name of the method, for which the options below apply.
288
292
  # This is used to find the method to apply the options.
293
+ #
294
+ # Example:
295
+ #
296
+ # publishing:
297
+ # method_settings:
298
+ # - selector: google.storage.control.v2.StorageControl.CreateFolder
299
+ # # method settings for CreateFolder...
289
300
  # @!attribute [rw] long_running
290
301
  # @return [::Google::Api::MethodSettings::LongRunning]
291
302
  # Describes settings to use for long-running operations when generating
@@ -294,17 +305,14 @@ module Google
294
305
  #
295
306
  # Example of a YAML configuration::
296
307
  #
297
- # publishing:
298
- # method_settings:
308
+ # publishing:
309
+ # method_settings:
299
310
  # - selector: google.cloud.speech.v2.Speech.BatchRecognize
300
311
  # long_running:
301
- # initial_poll_delay:
302
- # seconds: 60 # 1 minute
312
+ # initial_poll_delay: 60s # 1 minute
303
313
  # poll_delay_multiplier: 1.5
304
- # max_poll_delay:
305
- # seconds: 360 # 6 minutes
306
- # total_poll_timeout:
307
- # seconds: 54000 # 90 minutes
314
+ # max_poll_delay: 360s # 6 minutes
315
+ # total_poll_timeout: 54000s # 90 minutes
308
316
  # @!attribute [rw] auto_populated_fields
309
317
  # @return [::Array<::String>]
310
318
  # List of top-level fields of the request message, that should be
@@ -313,8 +321,8 @@ module Google
313
321
  #
314
322
  # Example of a YAML configuration:
315
323
  #
316
- # publishing:
317
- # method_settings:
324
+ # publishing:
325
+ # method_settings:
318
326
  # - selector: google.example.v1.ExampleService.CreateExample
319
327
  # auto_populated_fields:
320
328
  # - request_id
@@ -124,8 +124,13 @@ module Google
124
124
  # @return [::String]
125
125
  # The plural name used in the resource name and permission names, such as
126
126
  # 'projects' for the resource name of 'projects/\\{project}' and the permission
127
- # name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
128
- # concept of the `plural` field in k8s CRD spec
127
+ # name of 'cloudresourcemanager.googleapis.com/projects.get'. One exception
128
+ # to this is for Nested Collections that have stuttering names, as defined
129
+ # in [AIP-122](https://google.aip.dev/122#nested-collections), where the
130
+ # collection ID in the resource name pattern does not necessarily directly
131
+ # match the `plural` value.
132
+ #
133
+ # It is the same concept of the `plural` field in k8s CRD spec
129
134
  # https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
130
135
  #
131
136
  # Note: The plural form is required even for singleton resources. See
@@ -25,17 +25,38 @@ module Google
25
25
  # @!attribute [rw] name
26
26
  # @return [::String]
27
27
  # The group resource name.
28
- # Example: <code>projects/my-project-123/groups/CNSgkpnppqKCUw</code>
28
+ # Written as `projects/{projectID}/groups/{group_id}` or
29
+ # `projects/{projectID}/locations/{location}/groups/{group_id}`
30
+ #
31
+ # Examples: `projects/my-project-123/groups/my-group`,
32
+ # `projects/my-project-123/locations/us-central1/groups/my-group`
33
+ #
34
+ # In the group resource name, the `group_id` is a unique identifier for a
35
+ # particular error group. The identifier is derived from key parts of the
36
+ # error-log content and is treated as Service Data. For information about
37
+ # how Service Data is handled, see [Google Cloud Privacy
38
+ # Notice](https://cloud.google.com/terms/cloud-privacy-notice).
39
+ #
40
+ # For a list of supported locations, see [Supported
41
+ # Regions](https://cloud.google.com/logging/docs/region-support). `global` is
42
+ # the default when unspecified.
29
43
  # @!attribute [rw] group_id
30
44
  # @return [::String]
31
- # Group IDs are unique for a given project. If the same kind of error
32
- # occurs in different service contexts, it will receive the same group ID.
45
+ # An opaque identifier of the group. This field is assigned by the Error
46
+ # Reporting system and always populated.
47
+ #
48
+ # In the group resource name, the `group_id` is a unique identifier for a
49
+ # particular error group. The identifier is derived from key parts of the
50
+ # error-log content and is treated as Service Data. For information about
51
+ # how Service Data is handled, see [Google Cloud Privacy
52
+ # Notice](https://cloud.google.com/terms/cloud-privacy-notice).
33
53
  # @!attribute [rw] tracking_issues
34
54
  # @return [::Array<::Google::Cloud::ErrorReporting::V1beta1::TrackingIssue>]
35
55
  # Associated tracking issues.
36
56
  # @!attribute [rw] resolution_status
37
57
  # @return [::Google::Cloud::ErrorReporting::V1beta1::ResolutionStatus]
38
58
  # Error group's resolution status.
59
+ #
39
60
  # An unspecified resolution status will be interpreted as OPEN
40
61
  class ErrorGroup
41
62
  include ::Google::Protobuf::MessageExts
@@ -24,12 +24,25 @@ module Google
24
24
  # A request to return an individual group.
25
25
  # @!attribute [rw] group_name
26
26
  # @return [::String]
27
- # Required. The group resource name. Written as
28
- # `projects/{projectID}/groups/{group_name}`. Call
29
- # [`groupStats.list`](https://cloud.google.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list)
27
+ # Required. The group resource name. Written as either
28
+ # `projects/{projectID}/groups/{group_id}` or
29
+ # `projects/{projectID}/locations/{location}/groups/{group_id}`. Call
30
+ # [groupStats.list]
31
+ # [google.devtools.clouderrorreporting.v1beta1.ErrorStatsService.ListGroupStats]
30
32
  # to return a list of groups belonging to this project.
31
33
  #
32
- # Example: `projects/my-project-123/groups/my-group`
34
+ # Examples: `projects/my-project-123/groups/my-group`,
35
+ # `projects/my-project-123/locations/global/groups/my-group`
36
+ #
37
+ # In the group resource name, the `group_id` is a unique identifier for a
38
+ # particular error group. The identifier is derived from key parts of the
39
+ # error-log content and is treated as Service Data. For information about
40
+ # how Service Data is handled, see [Google Cloud Privacy
41
+ # Notice](https://cloud.google.com/terms/cloud-privacy-notice).
42
+ #
43
+ # For a list of supported locations, see [Supported
44
+ # Regions](https://cloud.google.com/logging/docs/region-support). `global` is
45
+ # the default when unspecified.
33
46
  class GetGroupRequest
34
47
  include ::Google::Protobuf::MessageExts
35
48
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -25,33 +25,58 @@ module Google
25
25
  # @!attribute [rw] project_name
26
26
  # @return [::String]
27
27
  # Required. The resource name of the Google Cloud Platform project. Written
28
- # as `projects/{projectID}` or `projects/{projectNumber}`, where `{projectID}`
29
- # and `{projectNumber}` can be found in the
30
- # [Google Cloud Console](https://support.google.com/cloud/answer/6158840).
28
+ # as `projects/{projectID}` or `projects/{projectNumber}`, where
29
+ # `{projectID}` and `{projectNumber}` can be found in the
30
+ # [Google Cloud console](https://support.google.com/cloud/answer/6158840).
31
+ # It may also include a location, such as
32
+ # `projects/{projectID}/locations/{location}` where `{location}` is a cloud
33
+ # region.
31
34
  #
32
- # Examples: `projects/my-project-123`, `projects/5551234`.
35
+ # Examples: `projects/my-project-123`, `projects/5551234`,
36
+ # `projects/my-project-123/locations/us-central1`,
37
+ # `projects/5551234/locations/us-central1`.
38
+ #
39
+ # For a list of supported locations, see [Supported
40
+ # Regions](https://cloud.google.com/logging/docs/region-support). `global` is
41
+ # the default when unspecified. Use `-` as a wildcard to request group stats
42
+ # from all regions.
33
43
  # @!attribute [rw] group_id
34
44
  # @return [::Array<::String>]
35
- # Optional. List all <code>ErrorGroupStats</code> with these IDs.
45
+ # Optional. List all [ErrorGroupStats]
46
+ # [google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats] with these
47
+ # IDs. The `group_id` is a unique identifier for a particular error group.
48
+ # The identifier is derived from key parts of the error-log content and is
49
+ # treated as Service Data. For information about how Service Data
50
+ # is handled, see [Google Cloud Privacy Notice]
51
+ # (https://cloud.google.com/terms/cloud-privacy-notice).
36
52
  # @!attribute [rw] service_filter
37
53
  # @return [::Google::Cloud::ErrorReporting::V1beta1::ServiceContextFilter]
38
- # Optional. List only <code>ErrorGroupStats</code> which belong to a service
39
- # context that matches the filter.
40
- # Data for all service contexts is returned if this field is not specified.
54
+ # Optional. List only [ErrorGroupStats]
55
+ # [google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats] which belong
56
+ # to a service context that matches the filter. Data for all service contexts
57
+ # is returned if this field is not specified.
41
58
  # @!attribute [rw] time_range
42
59
  # @return [::Google::Cloud::ErrorReporting::V1beta1::QueryTimeRange]
43
60
  # Optional. List data for the given time range.
44
61
  # If not set, a default time range is used. The field
45
- # <code>time_range_begin</code> in the response will specify the beginning
46
- # of this time range.
47
- # Only <code>ErrorGroupStats</code> with a non-zero count in the given time
48
- # range are returned, unless the request contains an explicit
49
- # <code>group_id</code> list. If a <code>group_id</code> list is given, also
50
- # <code>ErrorGroupStats</code> with zero occurrences are returned.
62
+ # [time_range_begin]
63
+ # [google.devtools.clouderrorreporting.v1beta1.ListGroupStatsResponse.time_range_begin]
64
+ # in the response will specify the beginning of this time range. Only
65
+ # [ErrorGroupStats]
66
+ # [google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats] with a
67
+ # non-zero count in the given time range are returned, unless the request
68
+ # contains an explicit [group_id]
69
+ # [google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.group_id]
70
+ # list. If a [group_id]
71
+ # [google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.group_id]
72
+ # list is given, also [ErrorGroupStats]
73
+ # [google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats] with zero
74
+ # occurrences are returned.
51
75
  # @!attribute [rw] timed_count_duration
52
76
  # @return [::Google::Protobuf::Duration]
53
- # Optional. The preferred duration for a single returned `TimedCount`.
54
- # If not set, no timed counts are returned.
77
+ # Optional. The preferred duration for a single returned [TimedCount]
78
+ # [google.devtools.clouderrorreporting.v1beta1.TimedCount]. If not set, no
79
+ # timed counts are returned.
55
80
  # @!attribute [rw] alignment
56
81
  # @return [::Google::Cloud::ErrorReporting::V1beta1::TimedCountAlignment]
57
82
  # Optional. The alignment of the timed counts to be returned.
@@ -70,9 +95,10 @@ module Google
70
95
  # Default is 20.
71
96
  # @!attribute [rw] page_token
72
97
  # @return [::String]
73
- # Optional. A `next_page_token` provided by a previous response. To view
74
- # additional results, pass this token along with the identical query
75
- # parameters as the first request.
98
+ # Optional. A [next_page_token]
99
+ # [google.devtools.clouderrorreporting.v1beta1.ListGroupStatsResponse.next_page_token]
100
+ # provided by a previous response. To view additional results, pass this
101
+ # token along with the identical query parameters as the first request.
76
102
  class ListGroupStatsRequest
77
103
  include ::Google::Protobuf::MessageExts
78
104
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -111,7 +137,8 @@ module Google
111
137
  # @return [::Integer]
112
138
  # Approximate number of affected users in the given group that
113
139
  # match the filter criteria.
114
- # Users are distinguished by data in the `ErrorContext` of the
140
+ # Users are distinguished by data in the [ErrorContext]
141
+ # [google.devtools.clouderrorreporting.v1beta1.ErrorContext] of the
115
142
  # individual error events, such as their login name or their remote
116
143
  # IP address in case of HTTP requests.
117
144
  # The number of affected users can be zero even if the number of
@@ -181,14 +208,25 @@ module Google
181
208
  # @!attribute [rw] project_name
182
209
  # @return [::String]
183
210
  # Required. The resource name of the Google Cloud Platform project. Written
184
- # as `projects/{projectID}`, where `{projectID}` is the
185
- # [Google Cloud Platform project
186
- # ID](https://support.google.com/cloud/answer/6158840).
211
+ # as `projects/{projectID}` or `projects/{projectID}/locations/{location}`,
212
+ # where `{projectID}` is the [Google Cloud Platform project
213
+ # ID](https://support.google.com/cloud/answer/6158840) and `{location}` is
214
+ # a Cloud region.
215
+ #
216
+ # Examples: `projects/my-project-123`,
217
+ # `projects/my-project-123/locations/global`.
187
218
  #
188
- # Example: `projects/my-project-123`.
219
+ # For a list of supported locations, see [Supported
220
+ # Regions](https://cloud.google.com/logging/docs/region-support). `global` is
221
+ # the default when unspecified.
189
222
  # @!attribute [rw] group_id
190
223
  # @return [::String]
191
224
  # Required. The group for which events shall be returned.
225
+ # The `group_id` is a unique identifier for a particular error group. The
226
+ # identifier is derived from key parts of the error-log content and is
227
+ # treated as Service Data. For information about how Service Data
228
+ # is handled, see [Google Cloud Privacy
229
+ # Notice](https://cloud.google.com/terms/cloud-privacy-notice).
192
230
  # @!attribute [rw] service_filter
193
231
  # @return [::Google::Cloud::ErrorReporting::V1beta1::ServiceContextFilter]
194
232
  # Optional. List only ErrorGroups which belong to a service context that
@@ -227,6 +265,12 @@ module Google
227
265
  extend ::Google::Protobuf::MessageExts::ClassMethods
228
266
  end
229
267
 
268
+ # A time range for which error group data shall be displayed.
269
+ # Query time ranges end at 'now'.
270
+ # When longer time ranges are selected, the resolution of the data decreases.
271
+ # The description of each time range below indicates the suggested minimum
272
+ # timed count duration for that range.
273
+ #
230
274
  # Requests might be rejected or the resulting timed count durations might be
231
275
  # adjusted for lower durations.
232
276
  # @!attribute [rw] period
@@ -288,11 +332,17 @@ module Google
288
332
  # @!attribute [rw] project_name
289
333
  # @return [::String]
290
334
  # Required. The resource name of the Google Cloud Platform project. Written
291
- # as `projects/{projectID}`, where `{projectID}` is the
292
- # [Google Cloud Platform project
293
- # ID](https://support.google.com/cloud/answer/6158840).
335
+ # as `projects/{projectID}` or `projects/{projectID}/locations/{location}`,
336
+ # where `{projectID}` is the [Google Cloud Platform project
337
+ # ID](https://support.google.com/cloud/answer/6158840) and `{location}` is
338
+ # a Cloud region.
339
+ #
340
+ # Examples: `projects/my-project-123`,
341
+ # `projects/my-project-123/locations/global`.
294
342
  #
295
- # Example: `projects/my-project-123`.
343
+ # For a list of supported locations, see [Supported
344
+ # Regions](https://cloud.google.com/logging/docs/region-support). `global` is
345
+ # the default when unspecified.
296
346
  class DeleteEventsRequest
297
347
  include ::Google::Protobuf::MessageExts
298
348
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -310,13 +360,18 @@ module Google
310
360
  ERROR_COUNT_ALIGNMENT_UNSPECIFIED = 0
311
361
 
312
362
  # The time periods shall be consecutive, have width equal to the
313
- # requested duration, and be aligned at the `alignment_time` provided in
314
- # the request.
315
- # The `alignment_time` does not have to be inside the query period but
316
- # even if it is outside, only time periods are returned which overlap
317
- # with the query period.
318
- # A rounded alignment will typically result in a
319
- # different size of the first or the last time period.
363
+ # requested duration, and be aligned at the
364
+ # [alignment_time]
365
+ # [google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.alignment_time]
366
+ # provided in the request.
367
+ #
368
+ # The [alignment_time]
369
+ # [google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.alignment_time]
370
+ # does not have to be inside the query period but even if it is outside, only
371
+ # time periods are returned which overlap with the query period.
372
+ #
373
+ # A rounded alignment will typically result in a different size of the first
374
+ # or the last time period.
320
375
  ALIGNMENT_EQUAL_ROUNDED = 1
321
376
 
322
377
  # The time periods shall be consecutive, have width equal to the
@@ -50,7 +50,11 @@ module Google
50
50
  # @return [::Google::Protobuf::Timestamp]
51
51
  # Optional. Time when the event occurred.
52
52
  # If not provided, the time when the event was received by the
53
- # Error Reporting system will be used.
53
+ # Error Reporting system is used. If provided, the time must not
54
+ # exceed the [logs retention
55
+ # period](https://cloud.google.com/logging/quotas#logs_retention_periods) in
56
+ # the past, or be more than 24 hours in the future.
57
+ # If an invalid time is provided, then an error is returned.
54
58
  # @!attribute [rw] service_context
55
59
  # @return [::Google::Cloud::ErrorReporting::V1beta1::ServiceContext]
56
60
  # Required. The service context in which this error has occurred.
@@ -75,9 +79,9 @@ module Google
75
79
  # [`Exception.backtrace`](https://ruby-doc.org/core-2.2.0/Exception.html#method-i-backtrace).
76
80
  # * **C#**: Must be the return value of
77
81
  # [`Exception.ToString()`](https://msdn.microsoft.com/en-us/library/system.exception.tostring.aspx).
78
- # * **PHP**: Must start with `PHP (Notice|Parse error|Fatal error|Warning)`
79
- # and contain the result of
80
- # [`(string)$exception`](http://php.net/manual/en/exception.tostring.php).
82
+ # * **PHP**: Must be prefixed with `"PHP (Notice|Parse error|Fatal
83
+ # error|Warning): "` and contain the result of
84
+ # [`(string)$exception`](https://php.net/manual/en/exception.tostring.php).
81
85
  # * **Go**: Must be the return value of
82
86
  # [`runtime.Stack()`](https://golang.org/pkg/runtime/debug/#Stack).
83
87
  # @!attribute [rw] context
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-error_reporting-v1beta1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.10.0
4
+ version: 0.11.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-02-26 00:00:00.000000000 Z
11
+ date: 2024-07-22 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common