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
@@ -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.9.2"
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\x12J\n\ngroup_name\x18\x01 \x01(\tB6\xe2\x41\x01\x02\xfa\x41/\n-clouderrorreporting.googleapis.com/ErrorGroup\"b\n\x12UpdateGroupRequest\x12L\n\x05group\x18\x01 \x01(\x0b\x32\x37.google.devtools.clouderrorreporting.v1beta1.ErrorGroupB\x04\xe2\x41\x01\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\"\x8d\x05\n\x15ListGroupStatsRequest\x12J\n\x0cproject_name\x18\x01 \x01(\tB4\xe2\x41\x01\x02\xfa\x41-\n+cloudresourcemanager.googleapis.com/Project\x12\x16\n\x08group_id\x18\x02 \x03(\tB\x04\xe2\x41\x01\x01\x12_\n\x0eservice_filter\x18\x03 \x01(\x0b\x32\x41.google.devtools.clouderrorreporting.v1beta1.ServiceContextFilterB\x04\xe2\x41\x01\x01\x12U\n\ntime_range\x18\x05 \x01(\x0b\x32;.google.devtools.clouderrorreporting.v1beta1.QueryTimeRangeB\x04\xe2\x41\x01\x01\x12=\n\x14timed_count_duration\x18\x06 \x01(\x0b\x32\x19.google.protobuf.DurationB\x04\xe2\x41\x01\x01\x12Y\n\talignment\x18\x07 \x01(\x0e\x32@.google.devtools.clouderrorreporting.v1beta1.TimedCountAlignmentB\x04\xe2\x41\x01\x01\x12\x38\n\x0e\x61lignment_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x04\xe2\x41\x01\x01\x12Q\n\x05order\x18\t \x01(\x0e\x32<.google.devtools.clouderrorreporting.v1beta1.ErrorGroupOrderB\x04\xe2\x41\x01\x01\x12\x17\n\tpage_size\x18\x0b \x01(\x05\x42\x04\xe2\x41\x01\x01\x12\x18\n\npage_token\x18\x0c \x01(\tB\x04\xe2\x41\x01\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\"\xe2\x02\n\x11ListEventsRequest\x12J\n\x0cproject_name\x18\x01 \x01(\tB4\xe2\x41\x01\x02\xfa\x41-\n+cloudresourcemanager.googleapis.com/Project\x12\x16\n\x08group_id\x18\x02 \x01(\tB\x04\xe2\x41\x01\x02\x12_\n\x0eservice_filter\x18\x03 \x01(\x0b\x32\x41.google.devtools.clouderrorreporting.v1beta1.ServiceContextFilterB\x04\xe2\x41\x01\x01\x12U\n\ntime_range\x18\x04 \x01(\x0b\x32;.google.devtools.clouderrorreporting.v1beta1.QueryTimeRangeB\x04\xe2\x41\x01\x01\x12\x17\n\tpage_size\x18\x06 \x01(\x05\x42\x04\xe2\x41\x01\x01\x12\x18\n\npage_token\x18\x07 \x01(\tB\x04\xe2\x41\x01\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\"a\n\x14ServiceContextFilter\x12\x15\n\x07service\x18\x02 \x01(\tB\x04\xe2\x41\x01\x01\x12\x15\n\x07version\x18\x03 \x01(\tB\x04\xe2\x41\x01\x01\x12\x1b\n\rresource_type\x18\x04 \x01(\tB\x04\xe2\x41\x01\x01\"a\n\x13\x44\x65leteEventsRequest\x12J\n\x0cproject_name\x18\x01 \x01(\tB4\xe2\x41\x01\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
 
@@ -12,7 +12,7 @@ require 'google/devtools/clouderrorreporting/v1beta1/common_pb'
12
12
  require 'google/protobuf/timestamp_pb'
13
13
 
14
14
 
15
- descriptor_data = "\nGgoogle/devtools/clouderrorreporting/v1beta1/report_errors_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\x1fgoogle/protobuf/timestamp.proto\"\xbb\x01\n\x17ReportErrorEventRequest\x12J\n\x0cproject_name\x18\x01 \x01(\tB4\xe2\x41\x01\x02\xfa\x41-\n+cloudresourcemanager.googleapis.com/Project\x12T\n\x05\x65vent\x18\x02 \x01(\x0b\x32?.google.devtools.clouderrorreporting.v1beta1.ReportedErrorEventB\x04\xe2\x41\x01\x02\"\x1a\n\x18ReportErrorEventResponse\"\x8f\x02\n\x12ReportedErrorEvent\x12\x34\n\nevent_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x04\xe2\x41\x01\x01\x12Z\n\x0fservice_context\x18\x02 \x01(\x0b\x32;.google.devtools.clouderrorreporting.v1beta1.ServiceContextB\x04\xe2\x41\x01\x02\x12\x15\n\x07message\x18\x03 \x01(\tB\x04\xe2\x41\x01\x02\x12P\n\x07\x63ontext\x18\x04 \x01(\x0b\x32\x39.google.devtools.clouderrorreporting.v1beta1.ErrorContextB\x04\xe2\x41\x01\x01\x32\xe5\x02\n\x13ReportErrorsService\x12\xf5\x01\n\x10ReportErrorEvent\x12\x44.google.devtools.clouderrorreporting.v1beta1.ReportErrorEventRequest\x1a\x45.google.devtools.clouderrorreporting.v1beta1.ReportErrorEventResponse\"T\xda\x41\x12project_name,event\x82\xd3\xe4\x93\x02\x39\"0/v1beta1/{project_name=projects/*}/events:report:\x05\x65vent\x1aV\xca\x41\"clouderrorreporting.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\x96\x02\n/com.google.devtools.clouderrorreporting.v1beta1B\x18ReportErrorsServiceProtoP\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
+ descriptor_data = "\nGgoogle/devtools/clouderrorreporting/v1beta1/report_errors_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\x1fgoogle/protobuf/timestamp.proto\"\xb9\x01\n\x17ReportErrorEventRequest\x12I\n\x0cproject_name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+cloudresourcemanager.googleapis.com/Project\x12S\n\x05\x65vent\x18\x02 \x01(\x0b\x32?.google.devtools.clouderrorreporting.v1beta1.ReportedErrorEventB\x03\xe0\x41\x02\"\x1a\n\x18ReportErrorEventResponse\"\x8b\x02\n\x12ReportedErrorEvent\x12\x33\n\nevent_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x01\x12Y\n\x0fservice_context\x18\x02 \x01(\x0b\x32;.google.devtools.clouderrorreporting.v1beta1.ServiceContextB\x03\xe0\x41\x02\x12\x14\n\x07message\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12O\n\x07\x63ontext\x18\x04 \x01(\x0b\x32\x39.google.devtools.clouderrorreporting.v1beta1.ErrorContextB\x03\xe0\x41\x01\x32\xe5\x02\n\x13ReportErrorsService\x12\xf5\x01\n\x10ReportErrorEvent\x12\x44.google.devtools.clouderrorreporting.v1beta1.ReportErrorEventRequest\x1a\x45.google.devtools.clouderrorreporting.v1beta1.ReportErrorEventResponse\"T\xda\x41\x12project_name,event\x82\xd3\xe4\x93\x02\x39\"0/v1beta1/{project_name=projects/*}/events:report:\x05\x65vent\x1aV\xca\x41\"clouderrorreporting.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\x96\x02\n/com.google.devtools.clouderrorreporting.v1beta1B\x18ReportErrorsServiceProtoP\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
16
 
17
17
  pool = Google::Protobuf::DescriptorPool.generated_pool
18
18
 
@@ -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