google-cloud-error_reporting-v1beta1 0.9.2 → 0.11.0

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 (22) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +1 -1
  3. data/lib/google/cloud/error_reporting/v1beta1/error_group_service/client.rb +24 -6
  4. data/lib/google/cloud/error_reporting/v1beta1/error_group_service/rest/client.rb +24 -6
  5. data/lib/google/cloud/error_reporting/v1beta1/error_group_service/rest/service_stub.rb +15 -0
  6. data/lib/google/cloud/error_reporting/v1beta1/error_stats_service/client.rb +80 -31
  7. data/lib/google/cloud/error_reporting/v1beta1/error_stats_service/rest/client.rb +80 -31
  8. data/lib/google/cloud/error_reporting/v1beta1/error_stats_service/rest/service_stub.rb +21 -0
  9. data/lib/google/cloud/error_reporting/v1beta1/report_errors_service/client.rb +15 -4
  10. data/lib/google/cloud/error_reporting/v1beta1/report_errors_service/rest/client.rb +15 -4
  11. data/lib/google/cloud/error_reporting/v1beta1/version.rb +1 -1
  12. data/lib/google/devtools/clouderrorreporting/v1beta1/error_group_service_pb.rb +1 -1
  13. data/lib/google/devtools/clouderrorreporting/v1beta1/error_stats_service_pb.rb +1 -1
  14. data/lib/google/devtools/clouderrorreporting/v1beta1/report_errors_service_pb.rb +1 -1
  15. data/lib/google/devtools/clouderrorreporting/v1beta1/report_errors_service_services_pb.rb +9 -3
  16. data/proto_docs/google/api/client.rb +18 -10
  17. data/proto_docs/google/api/resource.rb +7 -2
  18. data/proto_docs/google/devtools/clouderrorreporting/v1beta1/common.rb +24 -3
  19. data/proto_docs/google/devtools/clouderrorreporting/v1beta1/error_group_service.rb +17 -4
  20. data/proto_docs/google/devtools/clouderrorreporting/v1beta1/error_stats_service.rb +90 -35
  21. data/proto_docs/google/devtools/clouderrorreporting/v1beta1/report_errors_service.rb +8 -4
  22. metadata +4 -116
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 45836a23637f074f29ab44bf050f55043acfcc1054ce8f054135b706030975a7
4
- data.tar.gz: aec9b95ea12095a905f9ee67bd19568dc8f0796e43b602512a3103990b2c3107
3
+ metadata.gz: 8a256b2998f89e129d2d6e63002f6e1a6320dd827719d06eb2cc79089f2aa021
4
+ data.tar.gz: 101cddfec1e4a6310f442f7a1675ae7f155e158e4b4f1d1bc271b5c6f096898e
5
5
  SHA512:
6
- metadata.gz: 06d314a49643493e8c38deca24f1182657a33e03804bcbfeacdeead7236f1bcf89ad1fbe97e4c7c6b3d6c1a9215c2c63122fee2aa9f62d80ac007eca564d3549
7
- data.tar.gz: a426b1ba85882d137c33bea7fb828490b2146aa6c64881ae9928e0dee153fc445e63ab234e3db4228b1c72dc6dcc5f8e1c85e599c85f2d00c2b38e1bd6c59ee6
6
+ metadata.gz: e042118779cad7a1eb13618cfd6fa7d64295c6a5b0131ce4cf32cf38f3039f9c26ad22408b4da8d7c88f219bd4710c20966f3c9eb8db1b03e0080a4e23c3a000
7
+ data.tar.gz: 626c30d34e9efbbc7a174b58e24156196ae555a64267431fc3d9866b1bb76c47488eca9557c8ba85b503c9e55d418055d8b324a5a49c273a8ccc289d34e25bfd
data/README.md CHANGED
@@ -76,7 +76,7 @@ To browse ready to use code samples check [Google Cloud Samples](https://cloud.g
76
76
 
77
77
  ## Supported Ruby Versions
78
78
 
79
- This library is supported on Ruby 2.6+.
79
+ This library is supported on Ruby 2.7+.
80
80
 
81
81
  Google provides official support for Ruby versions that are actively supported
82
82
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or
@@ -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