google-cloud-error_reporting-v1beta1 0.10.0 → 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 (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