google-cloud-logging-v2 0.5.5 → 0.7.0

data/lib/google/cloud/logging/v2/config_service/client.rb

@@ -174,6 +174,12 @@ module Google
               @quota_project_id = @config.quota_project
               @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
 
+              @operations_client = Operations.new do |config|
+                config.credentials = credentials
+                config.quota_project = @quota_project_id
+                config.endpoint = @config.endpoint
+              end
+
               @config_service_stub = ::Gapic::ServiceStub.new(
                 ::Google::Cloud::Logging::V2::ConfigServiceV2::Stub,
                 credentials:  credentials,
@@ -183,10 +189,17 @@ module Google
               )
             end
 
+            ##
+            # Get the associated client for long-running operations.
+            #
+            # @return [::Google::Cloud::Logging::V2::ConfigService::Operations]
+            #
+            attr_reader :operations_client
+
             # Service calls
 
             ##
-            # Lists buckets.
+            # Lists log buckets.
             #
             # @overload list_buckets(request, options = nil)
             #   Pass arguments to `list_buckets` via a request object, either of type
@@ -215,14 +228,14 @@ module Google
             #     supplying the character `-` in place of [LOCATION_ID] will return all
             #     buckets.
             #   @param page_token [::String]
-            #     Optional. If present, then retrieve the next batch of results from the
-            #     preceding call to this method. `pageToken` must be the value of
-            #     `nextPageToken` from the previous response. The values of other method
-            #     parameters should be identical to those in the previous call.
+            #     Optional. If present, then retrieve the next batch of results from the preceding call
+            #     to this method. `pageToken` must be the value of `nextPageToken` from the
+            #     previous response. The values of other method parameters should be
+            #     identical to those in the previous call.
             #   @param page_size [::Integer]
-            #     Optional. The maximum number of results to return from this request.
-            #     Non-positive values are ignored. The presence of `nextPageToken` in the
-            #     response indicates that more results might be available.
+            #     Optional. The maximum number of results to return from this request. Non-positive
+            #     values are ignored. The presence of `nextPageToken` in the response
+            #     indicates that more results might be available.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Logging::V2::LogBucket>]
@@ -296,7 +309,7 @@ module Google
             end
 
             ##
-            # Gets a bucket.
+            # Gets a log bucket.
             #
             # @overload get_bucket(request, options = nil)
             #   Pass arguments to `get_bucket` via a request object, either of type
@@ -321,8 +334,9 @@ module Google
             #         "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
             #         "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
             #
-            #     Example:
-            #     `"projects/my-project-id/locations/my-location/buckets/my-bucket-id"`.
+            #     For example:
+            #
+            #       `"projects/my-project/locations/global/buckets/my-bucket"`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Logging::V2::LogBucket]
@@ -389,8 +403,8 @@ module Google
             end
 
             ##
-            # Creates a bucket that can be used to store log entries. Once a bucket has
-            # been created, the region cannot be changed.
+            # Creates a log bucket that can be used to store log entries. After a bucket
+            # has been created, the bucket's location cannot be changed.
             #
             # @overload create_bucket(request, options = nil)
             #   Pass arguments to `create_bucket` via a request object, either of type
@@ -408,15 +422,17 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The resource in which to create the bucket:
+            #     Required. The resource in which to create the log bucket:
             #
             #         "projects/[PROJECT_ID]/locations/[LOCATION_ID]"
             #
-            #     Example: `"projects/my-logging-project/locations/global"`
+            #     For example:
+            #
+            #       `"projects/my-project/locations/global"`
             #   @param bucket_id [::String]
-            #     Required. A client-assigned identifier such as `"my-bucket"`. Identifiers are
-            #     limited to 100 characters and can include only letters, digits,
-            #     underscores, hyphens, and periods.
+            #     Required. A client-assigned identifier such as `"my-bucket"`. Identifiers are limited
+            #     to 100 characters and can include only letters, digits, underscores,
+            #     hyphens, and periods.
             #   @param bucket [::Google::Cloud::Logging::V2::LogBucket, ::Hash]
             #     Required. The new bucket. The region specified in the new bucket must be compliant
             #     with any Location Restriction Org Policy. The name field in the bucket is
@@ -487,16 +503,16 @@ module Google
             end
 
             ##
-            # Updates a bucket. This method replaces the following fields in the
+            # Updates a log bucket. This method replaces the following fields in the
             # existing bucket with values from the new bucket: `retention_period`
             #
             # If the retention period is decreased and the bucket is locked,
-            # FAILED_PRECONDITION will be returned.
+            # `FAILED_PRECONDITION` will be returned.
             #
-            # If the bucket has a LifecycleState of DELETE_REQUESTED, FAILED_PRECONDITION
-            # will be returned.
+            # If the bucket has a `lifecycle_state` of `DELETE_REQUESTED`, then
+            # `FAILED_PRECONDITION` will be returned.
             #
-            # A buckets region may not be modified after it is created.
+            # After a bucket has been created, the bucket's location cannot be changed.
             #
             # @overload update_bucket(request, options = nil)
             #   Pass arguments to `update_bucket` via a request object, either of type
@@ -521,21 +537,20 @@ module Google
             #         "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
             #         "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
             #
-            #     Example:
-            #     `"projects/my-project-id/locations/my-location/buckets/my-bucket-id"`. Also
-            #     requires permission "resourcemanager.projects.updateLiens" to set the
-            #     locked property
+            #     For example:
+            #
+            #       `"projects/my-project/locations/global/buckets/my-bucket"`
             #   @param bucket [::Google::Cloud::Logging::V2::LogBucket, ::Hash]
             #     Required. The updated bucket.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Required. Field mask that specifies the fields in `bucket` that need an update. A
-            #     bucket field will be overwritten if, and only if, it is in the update
-            #     mask. `name` and output only fields cannot be updated.
+            #     bucket field will be overwritten if, and only if, it is in the update mask.
+            #     `name` and output only fields cannot be updated.
             #
-            #     For a detailed `FieldMask` definition, see
+            #     For a detailed `FieldMask` definition, see:
             #     https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
             #
-            #     Example: `updateMask=retention_days`.
+            #     For example: `updateMask=retention_days`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Logging::V2::LogBucket]
@@ -602,10 +617,11 @@ module Google
             end
 
             ##
-            # Deletes a bucket.
-            # Moves the bucket to the DELETE_REQUESTED state. After 7 days, the
-            # bucket will be purged and all logs in the bucket will be permanently
-            # deleted.
+            # Deletes a log bucket.
+            #
+            # Changes the bucket's `lifecycle_state` to the `DELETE_REQUESTED` state.
+            # After 7 days, the bucket will be purged and all log entries in the bucket
+            # will be permanently deleted.
             #
             # @overload delete_bucket(request, options = nil)
             #   Pass arguments to `delete_bucket` via a request object, either of type
@@ -630,8 +646,9 @@ module Google
             #         "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
             #         "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
             #
-            #     Example:
-            #     `"projects/my-project-id/locations/my-location/buckets/my-bucket-id"`.
+            #     For example:
+            #
+            #       `"projects/my-project/locations/global/buckets/my-bucket"`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
@@ -698,8 +715,8 @@ module Google
             end
 
             ##
-            # Undeletes a bucket. A bucket that has been deleted may be undeleted within
-            # the grace period of 7 days.
+            # Undeletes a log bucket. A bucket that has been deleted can be undeleted
+            # within the grace period of 7 days.
             #
             # @overload undelete_bucket(request, options = nil)
             #   Pass arguments to `undelete_bucket` via a request object, either of type
@@ -724,8 +741,9 @@ module Google
             #         "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
             #         "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
             #
-            #     Example:
-            #     `"projects/my-project-id/locations/my-location/buckets/my-bucket-id"`.
+            #     For example:
+            #
+            #       `"projects/my-project/locations/global/buckets/my-bucket"`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
@@ -792,7 +810,7 @@ module Google
             end
 
             ##
-            # Lists views on a bucket.
+            # Lists views on a log bucket.
             #
             # @overload list_views(request, options = nil)
             #   Pass arguments to `list_views` via a request object, either of type
@@ -814,12 +832,13 @@ module Google
             #
             #         "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
             #   @param page_token [::String]
-            #     Optional. If present, then retrieve the next batch of results from the
-            #     preceding call to this method. `pageToken` must be the value of
-            #     `nextPageToken` from the previous response. The values of other method
-            #     parameters should be identical to those in the previous call.
+            #     Optional. If present, then retrieve the next batch of results from the preceding call
+            #     to this method. `pageToken` must be the value of `nextPageToken` from the
+            #     previous response. The values of other method parameters should be
+            #     identical to those in the previous call.
             #   @param page_size [::Integer]
             #     Optional. The maximum number of results to return from this request.
+            #
             #     Non-positive values are ignored. The presence of `nextPageToken` in the
             #     response indicates that more results might be available.
             #
@@ -895,7 +914,7 @@ module Google
             end
 
             ##
-            # Gets a view.
+            # Gets a view on a log bucket..
             #
             # @overload get_view(request, options = nil)
             #   Pass arguments to `get_view` via a request object, either of type
@@ -917,8 +936,9 @@ module Google
             #
             #         "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
             #
-            #     Example:
-            #     `"projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id"`.
+            #     For example:
+            #
+            #       `"projects/my-project/locations/global/buckets/my-bucket/views/my-view"`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Logging::V2::LogView]
@@ -985,8 +1005,8 @@ module Google
             end
 
             ##
-            # Creates a view over logs in a bucket. A bucket may contain a maximum of
-            # 50 views.
+            # Creates a view over log entries in a log bucket. A bucket may contain a
+            # maximum of 30 views.
             #
             # @overload create_view(request, options = nil)
             #   Pass arguments to `create_view` via a request object, either of type
@@ -1006,10 +1026,11 @@ module Google
             #   @param parent [::String]
             #     Required. The bucket in which to create the view
             #
-            #         "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+            #         `"projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"`
+            #
+            #     For example:
             #
-            #     Example:
-            #     `"projects/my-logging-project/locations/my-location/buckets/my-bucket"`
+            #       `"projects/my-project/locations/global/buckets/my-bucket"`
             #   @param view_id [::String]
             #     Required. The id to use for this view.
             #   @param view [::Google::Cloud::Logging::V2::LogView, ::Hash]
@@ -1080,8 +1101,11 @@ module Google
             end
 
             ##
-            # Updates a view. This method replaces the following fields in the existing
-            # view with values from the new view: `filter`.
+            # Updates a view on a log bucket. This method replaces the following fields
+            # in the existing view with values from the new view: `filter`.
+            # If an `UNAVAILABLE` error is returned, this indicates that system is not in
+            # a state where it can update the view. If this occurs, please try again in a
+            # few minutes.
             #
             # @overload update_view(request, options = nil)
             #   Pass arguments to `update_view` via a request object, either of type
@@ -1103,8 +1127,9 @@ module Google
             #
             #         "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
             #
-            #     Example:
-            #       `"projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id"`.
+            #     For example:
+            #
+            #       `"projects/my-project/locations/global/buckets/my-bucket/views/my-view"`
             #   @param view [::Google::Cloud::Logging::V2::LogView, ::Hash]
             #     Required. The updated view.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
@@ -1115,7 +1140,7 @@ module Google
             #     For a detailed `FieldMask` definition, see
             #     https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
             #
-            #     Example: `updateMask=filter`.
+            #     For example: `updateMask=filter`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Logging::V2::LogView]
@@ -1182,7 +1207,10 @@ module Google
             end
 
             ##
-            # Deletes a view from a bucket.
+            # Deletes a view on a log bucket.
+            # If an `UNAVAILABLE` error is returned, this indicates that system is not in
+            # a state where it can delete the view. If this occurs, please try again in a
+            # few minutes.
             #
             # @overload delete_view(request, options = nil)
             #   Pass arguments to `delete_view` via a request object, either of type
@@ -1204,8 +1232,9 @@ module Google
             #
             #         "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
             #
-            #     Example:
-            #        `"projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id"`.
+            #     For example:
+            #
+            #        `"projects/my-project/locations/global/buckets/my-bucket/views/my-view"`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
@@ -1403,7 +1432,9 @@ module Google
             #         "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
             #         "folders/[FOLDER_ID]/sinks/[SINK_ID]"
             #
-            #     Example: `"projects/my-project-id/sinks/my-sink-id"`.
+            #     For example:
+            #
+            #       `"projects/my-project/sinks/my-sink"`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Logging::V2::LogSink]
@@ -1498,7 +1529,10 @@ module Google
             #         "billingAccounts/[BILLING_ACCOUNT_ID]"
             #         "folders/[FOLDER_ID]"
             #
-            #     Examples: `"projects/my-logging-project"`, `"organizations/123456789"`.
+            #     For examples:
+            #
+            #       `"projects/my-project"`
+            #       `"organizations/123456789"`
             #   @param sink [::Google::Cloud::Logging::V2::LogSink, ::Hash]
             #     Required. The new sink, whose `name` parameter is a sink identifier that
             #     is not already in use.
@@ -1506,9 +1540,9 @@ module Google
             #     Optional. Determines the kind of IAM identity returned as `writer_identity`
             #     in the new sink. If this value is omitted or set to false, and if the
             #     sink's parent is a project, then the value returned as `writer_identity` is
-            #     the same group or service account used by Logging before the addition of
-            #     writer identities to this API. The sink's destination must be in the same
-            #     project as the sink itself.
+            #     the same group or service account used by Cloud Logging before the addition
+            #     of writer identities to this API. The sink's destination must be in the
+            #     same project as the sink itself.
             #
             #     If this field is set to true, or if the sink is owned by a non-project
             #     resource such as an organization, then the value of `writer_identity` will
@@ -1610,7 +1644,9 @@ module Google
             #         "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
             #         "folders/[FOLDER_ID]/sinks/[SINK_ID]"
             #
-            #     Example: `"projects/my-project-id/sinks/my-sink-id"`.
+            #     For example:
+            #
+            #       `"projects/my-project/sinks/my-sink"`
             #   @param sink [::Google::Cloud::Logging::V2::LogSink, ::Hash]
             #     Required. The updated sink, whose name is the same identifier that appears as part
             #     of `sink_name`.
@@ -1631,16 +1667,18 @@ module Google
             #     an update. A sink field will be overwritten if, and only if, it is
             #     in the update mask. `name` and output only fields cannot be updated.
             #
-            #     An empty updateMask is temporarily treated as using the following mask
+            #     An empty `updateMask` is temporarily treated as using the following mask
             #     for backwards compatibility purposes:
-            #       destination,filter,includeChildren
+            #
+            #       `destination,filter,includeChildren`
+            #
             #     At some point in the future, behavior will be removed and specifying an
-            #     empty updateMask will be an error.
+            #     empty `updateMask` will be an error.
             #
             #     For a detailed `FieldMask` definition, see
             #     https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
             #
-            #     Example: `updateMask=filter`.
+            #     For example: `updateMask=filter`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Logging::V2::LogSink]
@@ -1734,7 +1772,9 @@ module Google
             #         "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
             #         "folders/[FOLDER_ID]/sinks/[SINK_ID]"
             #
-            #     Example: `"projects/my-project-id/sinks/my-sink-id"`.
+            #     For example:
+            #
+            #       `"projects/my-project/sinks/my-sink"`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
@@ -1801,7 +1841,7 @@ module Google
             end
 
             ##
-            # Lists all the exclusions in a parent resource.
+            # Lists all the exclusions on the _Default sink in a parent resource.
             #
             # @overload list_exclusions(request, options = nil)
             #   Pass arguments to `list_exclusions` via a request object, either of type
@@ -1907,7 +1947,7 @@ module Google
             end
 
             ##
-            # Gets the description of an exclusion.
+            # Gets the description of an exclusion in the _Default sink.
             #
             # @overload get_exclusion(request, options = nil)
             #   Pass arguments to `get_exclusion` via a request object, either of type
@@ -1932,7 +1972,9 @@ module Google
             #         "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
             #         "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
             #
-            #     Example: `"projects/my-project-id/exclusions/my-exclusion-id"`.
+            #     For example:
+            #
+            #       `"projects/my-project/exclusions/my-exclusion"`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Logging::V2::LogExclusion]
@@ -1999,9 +2041,9 @@ module Google
             end
 
             ##
-            # Creates a new exclusion in a specified parent resource.
-            # Only log entries belonging to that resource can be excluded.
-            # You can have up to 10 exclusions in a resource.
+            # Creates a new exclusion in the _Default sink in a specified parent
+            # resource. Only log entries belonging to that resource can be excluded. You
+            # can have up to 10 exclusions in a resource.
             #
             # @overload create_exclusion(request, options = nil)
             #   Pass arguments to `create_exclusion` via a request object, either of type
@@ -2026,7 +2068,10 @@ module Google
             #         "billingAccounts/[BILLING_ACCOUNT_ID]"
             #         "folders/[FOLDER_ID]"
             #
-            #     Examples: `"projects/my-logging-project"`, `"organizations/123456789"`.
+            #     For examples:
+            #
+            #       `"projects/my-logging-project"`
+            #       `"organizations/123456789"`
             #   @param exclusion [::Google::Cloud::Logging::V2::LogExclusion, ::Hash]
             #     Required. The new exclusion, whose `name` parameter is an exclusion name
             #     that is not already used in the parent resource.
@@ -2096,7 +2141,8 @@ module Google
             end
 
             ##
-            # Changes one or more properties of an existing exclusion.
+            # Changes one or more properties of an existing exclusion in the _Default
+            # sink.
             #
             # @overload update_exclusion(request, options = nil)
             #   Pass arguments to `update_exclusion` via a request object, either of type
@@ -2121,7 +2167,9 @@ module Google
             #         "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
             #         "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
             #
-            #     Example: `"projects/my-project-id/exclusions/my-exclusion-id"`.
+            #     For example:
+            #
+            #       `"projects/my-project/exclusions/my-exclusion"`
             #   @param exclusion [::Google::Cloud::Logging::V2::LogExclusion, ::Hash]
             #     Required. New values for the existing exclusion. Only the fields specified in
             #     `update_mask` are relevant.
@@ -2199,7 +2247,7 @@ module Google
             end
 
             ##
-            # Deletes an exclusion.
+            # Deletes an exclusion in the _Default sink.
             #
             # @overload delete_exclusion(request, options = nil)
             #   Pass arguments to `delete_exclusion` via a request object, either of type
@@ -2224,7 +2272,9 @@ module Google
             #         "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
             #         "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
             #
-            #     Example: `"projects/my-project-id/exclusions/my-exclusion-id"`.
+            #     For example:
+            #
+            #       `"projects/my-project/exclusions/my-exclusion"`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
@@ -2291,13 +2341,14 @@ module Google
             end
 
             ##
-            # Gets the Logs Router CMEK settings for the given resource.
+            # Gets the Logging CMEK settings for the given resource.
             #
-            # Note: CMEK for the Logs Router can currently only be configured for GCP
-            # organizations. Once configured, it applies to all projects and folders in
-            # the GCP organization.
+            # Note: CMEK for the Log Router can be configured for Google Cloud projects,
+            # folders, organizations and billing accounts. Once configured for an
+            # organization, it applies to all projects and folders in the Google Cloud
+            # organization.
             #
-            # See [Enabling CMEK for Logs
+            # See [Enabling CMEK for Log
             # Router](https://cloud.google.com/logging/docs/routing/managed-encryption)
             # for more information.
             #
@@ -2324,11 +2375,14 @@ module Google
             #         "billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings"
             #         "folders/[FOLDER_ID]/cmekSettings"
             #
-            #     Example: `"organizations/12345/cmekSettings"`.
+            #     For example:
+            #
+            #       `"organizations/12345/cmekSettings"`
             #
-            #     Note: CMEK for the Logs Router can currently only be configured for GCP
-            #     organizations. Once configured, it applies to all projects and folders in
-            #     the GCP organization.
+            #     Note: CMEK for the Log Router can be configured for Google Cloud projects,
+            #     folders, organizations and billing accounts. Once configured for an
+            #     organization, it applies to all projects and folders in the Google Cloud
+            #     organization.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Logging::V2::CmekSettings]
@@ -2395,11 +2449,11 @@ module Google
             end
 
             ##
-            # Updates the Logs Router CMEK settings for the given resource.
+            # Updates the Log Router CMEK settings for the given resource.
             #
-            # Note: CMEK for the Logs Router can currently only be configured for GCP
-            # organizations. Once configured, it applies to all projects and folders in
-            # the GCP organization.
+            # Note: CMEK for the Log Router can currently only be configured for Google
+            # Cloud organizations. Once configured, it applies to all projects and
+            # folders in the Google Cloud organization.
             #
             # {::Google::Cloud::Logging::V2::ConfigServiceV2::Client#update_cmek_settings UpdateCmekSettings}
             # will fail if 1) `kms_key_name` is invalid, or 2) the associated service
@@ -2407,7 +2461,7 @@ module Google
             # `roles/cloudkms.cryptoKeyEncrypterDecrypter` role assigned for the key, or
             # 3) access to the key is disabled.
             #
-            # See [Enabling CMEK for Logs
+            # See [Enabling CMEK for Log
             # Router](https://cloud.google.com/logging/docs/routing/managed-encryption)
             # for more information.
             #
@@ -2434,15 +2488,17 @@ module Google
             #         "billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings"
             #         "folders/[FOLDER_ID]/cmekSettings"
             #
-            #     Example: `"organizations/12345/cmekSettings"`.
+            #     For example:
             #
-            #     Note: CMEK for the Logs Router can currently only be configured for GCP
-            #     organizations. Once configured, it applies to all projects and folders in
-            #     the GCP organization.
+            #       `"organizations/12345/cmekSettings"`
+            #
+            #     Note: CMEK for the Log Router can currently only be configured for Google
+            #     Cloud organizations. Once configured, it applies to all projects and
+            #     folders in the Google Cloud organization.
             #   @param cmek_settings [::Google::Cloud::Logging::V2::CmekSettings, ::Hash]
             #     Required. The CMEK settings to update.
             #
-            #     See [Enabling CMEK for Logs
+            #     See [Enabling CMEK for Log
             #     Router](https://cloud.google.com/logging/docs/routing/managed-encryption)
             #     for more information.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
@@ -2452,7 +2508,7 @@ module Google
             #
             #     See {::Google::Protobuf::FieldMask FieldMask} for more information.
             #
-            #     Example: `"updateMask=kmsKeyName"`
+            #     For example: `"updateMask=kmsKeyName"`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Logging::V2::CmekSettings]
@@ -2518,6 +2574,332 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Gets the Log Router settings for the given resource.
+            #
+            # Note: Settings for the Log Router can be get for Google Cloud projects,
+            # folders, organizations and billing accounts. Currently it can only be
+            # configured for organizations. Once configured for an organization, it
+            # applies to all projects and folders in the Google Cloud organization.
+            #
+            # See [Enabling CMEK for Log
+            # Router](https://cloud.google.com/logging/docs/routing/managed-encryption)
+            # for more information.
+            #
+            # @overload get_settings(request, options = nil)
+            #   Pass arguments to `get_settings` via a request object, either of type
+            #   {::Google::Cloud::Logging::V2::GetSettingsRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Logging::V2::GetSettingsRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload get_settings(name: nil)
+            #   Pass arguments to `get_settings` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param name [::String]
+            #     Required. The resource for which to retrieve settings.
+            #
+            #         "projects/[PROJECT_ID]/settings"
+            #         "organizations/[ORGANIZATION_ID]/settings"
+            #         "billingAccounts/[BILLING_ACCOUNT_ID]/settings"
+            #         "folders/[FOLDER_ID]/settings"
+            #
+            #     For example:
+            #
+            #       `"organizations/12345/settings"`
+            #
+            #     Note: Settings for the Log Router can be get for Google Cloud projects,
+            #     folders, organizations and billing accounts. Currently it can only be
+            #     configured for organizations. Once configured for an organization, it
+            #     applies to all projects and folders in the Google Cloud organization.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::Logging::V2::Settings]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::Logging::V2::Settings]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/logging/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Logging::V2::ConfigService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Logging::V2::GetSettingsRequest.new
+            #
+            #   # Call the get_settings method.
+            #   result = client.get_settings request
+            #
+            #   # The returned object is of type Google::Cloud::Logging::V2::Settings.
+            #   p result
+            #
+            def get_settings request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Logging::V2::GetSettingsRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.get_settings.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Logging::V2::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.get_settings.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.get_settings.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @config_service_stub.call_rpc :get_settings, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
+            ##
+            # Updates the Log Router settings for the given resource.
+            #
+            # Note: Settings for the Log Router can currently only be configured for
+            # Google Cloud organizations. Once configured, it applies to all projects and
+            # folders in the Google Cloud organization.
+            #
+            # {::Google::Cloud::Logging::V2::ConfigServiceV2::Client#update_settings UpdateSettings}
+            # will fail if 1) `kms_key_name` is invalid, or 2) the associated service
+            # account does not have the required
+            # `roles/cloudkms.cryptoKeyEncrypterDecrypter` role assigned for the key, or
+            # 3) access to the key is disabled. 4) `location_id` is not supported by
+            # Logging. 5) `location_id` violate OrgPolicy.
+            #
+            # See [Enabling CMEK for Log
+            # Router](https://cloud.google.com/logging/docs/routing/managed-encryption)
+            # for more information.
+            #
+            # @overload update_settings(request, options = nil)
+            #   Pass arguments to `update_settings` via a request object, either of type
+            #   {::Google::Cloud::Logging::V2::UpdateSettingsRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Logging::V2::UpdateSettingsRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload update_settings(name: nil, settings: nil, update_mask: nil)
+            #   Pass arguments to `update_settings` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param name [::String]
+            #     Required. The resource name for the settings to update.
+            #
+            #         "organizations/[ORGANIZATION_ID]/settings"
+            #
+            #     For example:
+            #
+            #       `"organizations/12345/settings"`
+            #
+            #     Note: Settings for the Log Router can currently only be configured for
+            #     Google Cloud organizations. Once configured, it applies to all projects and
+            #     folders in the Google Cloud organization.
+            #   @param settings [::Google::Cloud::Logging::V2::Settings, ::Hash]
+            #     Required. The settings to update.
+            #
+            #     See [Enabling CMEK for Log
+            #     Router](https://cloud.google.com/logging/docs/routing/managed-encryption)
+            #     for more information.
+            #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
+            #     Optional. Field mask identifying which fields from `settings` should
+            #     be updated. A field will be overwritten if and only if it is in the update
+            #     mask. Output only fields cannot be updated.
+            #
+            #     See {::Google::Protobuf::FieldMask FieldMask} for more information.
+            #
+            #     For example: `"updateMask=kmsKeyName"`
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::Logging::V2::Settings]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::Logging::V2::Settings]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/logging/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Logging::V2::ConfigService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Logging::V2::UpdateSettingsRequest.new
+            #
+            #   # Call the update_settings method.
+            #   result = client.update_settings request
+            #
+            #   # The returned object is of type Google::Cloud::Logging::V2::Settings.
+            #   p result
+            #
+            def update_settings request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Logging::V2::UpdateSettingsRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.update_settings.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Logging::V2::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.update_settings.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.update_settings.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @config_service_stub.call_rpc :update_settings, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
+            ##
+            # Copies a set of log entries from a log bucket to a Cloud Storage bucket.
+            #
+            # @overload copy_log_entries(request, options = nil)
+            #   Pass arguments to `copy_log_entries` via a request object, either of type
+            #   {::Google::Cloud::Logging::V2::CopyLogEntriesRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Logging::V2::CopyLogEntriesRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload copy_log_entries(name: nil, filter: nil, destination: nil)
+            #   Pass arguments to `copy_log_entries` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param name [::String]
+            #     Required. Log bucket from which to copy log entries.
+            #
+            #     For example:
+            #
+            #       `"projects/my-project/locations/global/buckets/my-source-bucket"`
+            #   @param filter [::String]
+            #     Optional. A filter specifying which log entries to copy. The filter must be no more
+            #     than 20k characters. An empty filter matches all log entries.
+            #   @param destination [::String]
+            #     Required. Destination to which to copy log entries.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Gapic::Operation]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Gapic::Operation]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/logging/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Logging::V2::ConfigService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Logging::V2::CopyLogEntriesRequest.new
+            #
+            #   # Call the copy_log_entries method.
+            #   result = client.copy_log_entries request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
+            def copy_log_entries request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Logging::V2::CopyLogEntriesRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.copy_log_entries.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Logging::V2::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              options.apply_defaults timeout:      @config.rpcs.copy_log_entries.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.copy_log_entries.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @config_service_stub.call_rpc :copy_log_entries, request, options: options do |response, operation|
+                response = ::Gapic::Operation.new response, @operations_client, options: options
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Configuration class for the ConfigService API.
             #
@@ -2768,6 +3150,21 @@ module Google
                 # @return [::Gapic::Config::Method]
                 #
                 attr_reader :update_cmek_settings
+                ##
+                # RPC-specific configuration for `get_settings`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :get_settings
+                ##
+                # RPC-specific configuration for `update_settings`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :update_settings
+                ##
+                # RPC-specific configuration for `copy_log_entries`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :copy_log_entries
 
                 # @private
                 def initialize parent_rpcs = nil
@@ -2817,6 +3214,12 @@ module Google
                   @get_cmek_settings = ::Gapic::Config::Method.new get_cmek_settings_config
                   update_cmek_settings_config = parent_rpcs.update_cmek_settings if parent_rpcs.respond_to? :update_cmek_settings
                   @update_cmek_settings = ::Gapic::Config::Method.new update_cmek_settings_config
+                  get_settings_config = parent_rpcs.get_settings if parent_rpcs.respond_to? :get_settings
+                  @get_settings = ::Gapic::Config::Method.new get_settings_config
+                  update_settings_config = parent_rpcs.update_settings if parent_rpcs.respond_to? :update_settings
+                  @update_settings = ::Gapic::Config::Method.new update_settings_config
+                  copy_log_entries_config = parent_rpcs.copy_log_entries if parent_rpcs.respond_to? :copy_log_entries
+                  @copy_log_entries = ::Gapic::Config::Method.new copy_log_entries_config
 
                   yield self if block_given?
                 end