google-cloud-logging 1.9.5 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 91218db71bcf0f6192d7f93d9727fbfdfdc1e93a178d699f339af36c66762b4b
-  data.tar.gz: 3f06add4df2396e67067ef4a08c429fe8cb4ddb7a75ab337697a8ba2c1a17d8a
+  metadata.gz: f907333eb71ca0574dea284bd95c437fa9f2faa1b3737dd230079c5a736e5852
+  data.tar.gz: 95583c9ce2da5d19514b7a05853e485c0b0d0929c0f8370f0612a31803bdc5b8
 SHA512:
-  metadata.gz: b304bd0c18732eb582d3a0f083da1400d1b4d60620a9d3f649df38459763023b048c67df3aa0276cea41c004016e1dc328318c4ca6fe0bdb83394ced32a7fc66
-  data.tar.gz: ed07fdc87513ee53070dd2245748b100f2f7d5b6486badcae4128aa0e049938f4dd3e9caa4d6e52336f8039367bb608bac71f8a3f98e2dc94b5d4f098674cce7
+  metadata.gz: 0d1cb61244ff92539afaac04e52e147374d09aa294f63ae35aec878210838cc359b5ea33bc1b8f27c2ec7f7cfaee720b66a2f4a3249741a432e38bbb7ec18df8
+  data.tar.gz: 9dc94fd5183d3c1e4b29a11f88bf644f33971a9680e3c68c9fba79c9bb95297557ed555b23a6053ca4efbd929f65054f3eca878935cc159cc1fa1e28ed4c8ac6

data/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Release History
 
+### 1.10.0 / 2020-03-16
+
+#### Features
+
+* support separate project setting for quota/billing
+
+#### Low-level interface updates
+
+* Add LogBucket
+* Add ConfigServiceV2Client#list_buckets
+* Add ConfigServiceV2Client#get_bucket
+* Add ConfigServiceV2Client#update_bucket
+* Add LifecycleState enum
+* Change name to positional param in ConfigServiceV2Client#get_cmek_settings
+* Change name and cmek_settings to positional params in ConfigServiceV2Client#update_cmek_settings
+* Remove billing, folder, and organization path helpers from ConfigServiceV2Client
+* Remove LogEntry#metadata
+* Remove previously deprecated project_ids from LoggingServiceV2Client#list_log_entries
+* Remove log_path helpers from LoggingServiceV2Client
+* Rename ConfigServiceV2Client#billing_path to #billing_account_path
+* Rename LoggingServiceV2Client#billing_path to #billing_account_path
+* Rename MetricsServiceV2Client#metric_path to #log_metric_path
+* Update network configuration settings
+
 ### 1.9.5 / 2020-02-24
 
 #### Documentation

data/lib/google/cloud/logging/sink.rb

@@ -25,10 +25,7 @@ module Google
       # a sink, new log entries are exported. Stackdriver Logging does not send
       # previously-ingested log entries to the sink's destination.
       #
-      # A logs filter controls which log entries are exported. Sinks can have a
-      # start time and an end time; these can be used to place log entries from
-      # an exact time range into a particular destination.  If both `start_at`
-      # and `end_at` are present, then `start_at` must be less than `end_at`.
+      # A logs filter controls which log entries are exported.
       #
       # Before creating the sink, ensure that you have granted
       # `cloud-logs@google.com` permission to write logs to the destination. See

data/lib/google/cloud/logging/v2/config_service_v2_client.rb

@@ -53,6 +53,10 @@ module Google
           DEFAULT_TIMEOUT = 30
 
           PAGE_DESCRIPTORS = {
+            "list_buckets" => Google::Gax::PageDescriptor.new(
+              "page_token",
+              "next_page_token",
+              "buckets"),
             "list_sinks" => Google::Gax::PageDescriptor.new(
               "page_token",
               "next_page_token",
@@ -76,29 +80,11 @@ module Google
           ].freeze
 
 
-          BILLING_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+          BILLING_ACCOUNT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
             "billingAccounts/{billing_account}"
           )
 
-          private_constant :BILLING_PATH_TEMPLATE
-
-          BILLING_EXCLUSION_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-            "billingAccounts/{billing_account}/exclusions/{exclusion}"
-          )
-
-          private_constant :BILLING_EXCLUSION_PATH_TEMPLATE
-
-          BILLING_SINK_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-            "billingAccounts/{billing_account}/sinks/{sink}"
-          )
-
-          private_constant :BILLING_SINK_PATH_TEMPLATE
-
-          EXCLUSION_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-            "projects/{project}/exclusions/{exclusion}"
-          )
-
-          private_constant :EXCLUSION_PATH_TEMPLATE
+          private_constant :BILLING_ACCOUNT_PATH_TEMPLATE
 
           FOLDER_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
             "folders/{folder}"
@@ -106,90 +92,27 @@ module Google
 
           private_constant :FOLDER_PATH_TEMPLATE
 
-          FOLDER_EXCLUSION_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-            "folders/{folder}/exclusions/{exclusion}"
-          )
-
-          private_constant :FOLDER_EXCLUSION_PATH_TEMPLATE
-
-          FOLDER_SINK_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-            "folders/{folder}/sinks/{sink}"
-          )
-
-          private_constant :FOLDER_SINK_PATH_TEMPLATE
-
           ORGANIZATION_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
             "organizations/{organization}"
           )
 
           private_constant :ORGANIZATION_PATH_TEMPLATE
 
-          ORGANIZATION_EXCLUSION_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-            "organizations/{organization}/exclusions/{exclusion}"
-          )
-
-          private_constant :ORGANIZATION_EXCLUSION_PATH_TEMPLATE
-
-          ORGANIZATION_SINK_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-            "organizations/{organization}/sinks/{sink}"
-          )
-
-          private_constant :ORGANIZATION_SINK_PATH_TEMPLATE
-
           PROJECT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
             "projects/{project}"
           )
 
           private_constant :PROJECT_PATH_TEMPLATE
 
-          SINK_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-            "projects/{project}/sinks/{sink}"
-          )
-
-          private_constant :SINK_PATH_TEMPLATE
-
-          # Returns a fully-qualified billing resource name string.
+          # Returns a fully-qualified billing_account resource name string.
           # @param billing_account [String]
           # @return [String]
-          def self.billing_path billing_account
-            BILLING_PATH_TEMPLATE.render(
+          def self.billing_account_path billing_account
+            BILLING_ACCOUNT_PATH_TEMPLATE.render(
               :"billing_account" => billing_account
             )
           end
 
-          # Returns a fully-qualified billing_exclusion resource name string.
-          # @param billing_account [String]
-          # @param exclusion [String]
-          # @return [String]
-          def self.billing_exclusion_path billing_account, exclusion
-            BILLING_EXCLUSION_PATH_TEMPLATE.render(
-              :"billing_account" => billing_account,
-              :"exclusion" => exclusion
-            )
-          end
-
-          # Returns a fully-qualified billing_sink resource name string.
-          # @param billing_account [String]
-          # @param sink [String]
-          # @return [String]
-          def self.billing_sink_path billing_account, sink
-            BILLING_SINK_PATH_TEMPLATE.render(
-              :"billing_account" => billing_account,
-              :"sink" => sink
-            )
-          end
-
-          # Returns a fully-qualified exclusion resource name string.
-          # @param project [String]
-          # @param exclusion [String]
-          # @return [String]
-          def self.exclusion_path project, exclusion
-            EXCLUSION_PATH_TEMPLATE.render(
-              :"project" => project,
-              :"exclusion" => exclusion
-            )
-          end
-
           # Returns a fully-qualified folder resource name string.
           # @param folder [String]
           # @return [String]
@@ -199,28 +122,6 @@ module Google
             )
           end
 
-          # Returns a fully-qualified folder_exclusion resource name string.
-          # @param folder [String]
-          # @param exclusion [String]
-          # @return [String]
-          def self.folder_exclusion_path folder, exclusion
-            FOLDER_EXCLUSION_PATH_TEMPLATE.render(
-              :"folder" => folder,
-              :"exclusion" => exclusion
-            )
-          end
-
-          # Returns a fully-qualified folder_sink resource name string.
-          # @param folder [String]
-          # @param sink [String]
-          # @return [String]
-          def self.folder_sink_path folder, sink
-            FOLDER_SINK_PATH_TEMPLATE.render(
-              :"folder" => folder,
-              :"sink" => sink
-            )
-          end
-
           # Returns a fully-qualified organization resource name string.
           # @param organization [String]
           # @return [String]
@@ -230,28 +131,6 @@ module Google
             )
           end
 
-          # Returns a fully-qualified organization_exclusion resource name string.
-          # @param organization [String]
-          # @param exclusion [String]
-          # @return [String]
-          def self.organization_exclusion_path organization, exclusion
-            ORGANIZATION_EXCLUSION_PATH_TEMPLATE.render(
-              :"organization" => organization,
-              :"exclusion" => exclusion
-            )
-          end
-
-          # Returns a fully-qualified organization_sink resource name string.
-          # @param organization [String]
-          # @param sink [String]
-          # @return [String]
-          def self.organization_sink_path organization, sink
-            ORGANIZATION_SINK_PATH_TEMPLATE.render(
-              :"organization" => organization,
-              :"sink" => sink
-            )
-          end
-
           # Returns a fully-qualified project resource name string.
           # @param project [String]
           # @return [String]
@@ -261,17 +140,6 @@ module Google
             )
           end
 
-          # Returns a fully-qualified sink resource name string.
-          # @param project [String]
-          # @param sink [String]
-          # @return [String]
-          def self.sink_path project, sink
-            SINK_PATH_TEMPLATE.render(
-              :"project" => project,
-              :"sink" => sink
-            )
-          end
-
           # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
           #   Provides the means for authenticating requests made by the client. This parameter can
           #   be many types.
@@ -349,6 +217,9 @@ module Google
             google_api_client.freeze
 
             headers = { :"x-goog-api-client" => google_api_client }
+            if credentials.respond_to?(:quota_project_id) && credentials.quota_project_id
+              headers[:"x-goog-user-project"] = credentials.quota_project_id
+            end
             headers.merge!(metadata) unless metadata.nil?
             client_config_file = Pathname.new(__dir__).join(
               "config_service_v2_client_config.json"
@@ -381,6 +252,30 @@ module Google
               &Google::Logging::V2::ConfigServiceV2::Stub.method(:new)
             )
 
+            @list_buckets = Google::Gax.create_api_call(
+              @config_service_v2_stub.method(:list_buckets),
+              defaults["list_buckets"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
+            )
+            @get_bucket = Google::Gax.create_api_call(
+              @config_service_v2_stub.method(:get_bucket),
+              defaults["get_bucket"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
+            )
+            @update_bucket = Google::Gax.create_api_call(
+              @config_service_v2_stub.method(:update_bucket),
+              defaults["update_bucket"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
+            )
             @list_sinks = Google::Gax.create_api_call(
               @config_service_v2_stub.method(:list_sinks),
               defaults["list_sinks"],
@@ -481,6 +376,188 @@ module Google
 
           # Service calls
 
+          # Lists buckets (Beta).
+          #
+          # @param parent [String]
+          #   Required. The parent resource whose buckets are to be listed:
+          #
+          #       "projects/[PROJECT_ID]/locations/[LOCATION_ID]"
+          #       "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]"
+          #       "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]"
+          #       "folders/[FOLDER_ID]/locations/[LOCATION_ID]"
+          #
+          #   Note: The locations portion of the resource must be specified, but
+          #   supplying the character `-` in place of [LOCATION_ID] will return all
+          #   buckets.
+          # @param page_size [Integer]
+          #   The maximum number of resources contained in the underlying API
+          #   response. If page streaming is performed per-resource, this
+          #   parameter does not affect the return value. If page streaming is
+          #   performed per-page, this determines the maximum number of
+          #   resources in a page.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Gax::PagedEnumerable<Google::Logging::V2::LogBucket>]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Gax::PagedEnumerable<Google::Logging::V2::LogBucket>]
+          #   An enumerable of Google::Logging::V2::LogBucket instances.
+          #   See Google::Gax::PagedEnumerable documentation for other
+          #   operations such as per-page iteration or access to the response
+          #   object.
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/logging/v2"
+          #
+          #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
+          #
+          #   # TODO: Initialize `parent`:
+          #   parent = ''
+          #
+          #   # Iterate over all results.
+          #   config_client.list_buckets(parent).each do |element|
+          #     # Process element.
+          #   end
+          #
+          #   # Or iterate over results one page at a time.
+          #   config_client.list_buckets(parent).each_page do |page|
+          #     # Process each page at a time.
+          #     page.each do |element|
+          #       # Process element.
+          #     end
+          #   end
+
+          def list_buckets \
+              parent,
+              page_size: nil,
+              options: nil,
+              &block
+            req = {
+              parent: parent,
+              page_size: page_size
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Logging::V2::ListBucketsRequest)
+            @list_buckets.call(req, options, &block)
+          end
+
+          # Gets a bucket (Beta).
+          #
+          # @param name [String]
+          #   Required. The resource name of the bucket:
+          #
+          #       "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+          #       "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+          #       "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"`.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Logging::V2::LogBucket]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Logging::V2::LogBucket]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/logging/v2"
+          #
+          #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
+          #
+          #   # TODO: Initialize `name`:
+          #   name = ''
+          #   response = config_client.get_bucket(name)
+
+          def get_bucket \
+              name,
+              options: nil,
+              &block
+            req = {
+              name: name
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Logging::V2::GetBucketRequest)
+            @get_bucket.call(req, options, &block)
+          end
+
+          # Updates a 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.
+          #
+          # If the bucket has a LifecycleState of DELETE_REQUESTED, FAILED_PRECONDITION
+          # will be returned.
+          #
+          # A buckets region may not be modified after it is created.
+          # This method is in Beta.
+          #
+          # @param name [String]
+          #   Required. The full resource name of the bucket to update.
+          #
+          #       "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+          #       "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+          #       "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
+          # @param bucket [Google::Logging::V2::LogBucket | Hash]
+          #   Required. The updated bucket.
+          #   A hash of the same form as `Google::Logging::V2::LogBucket`
+          #   can also be provided.
+          # @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.
+          #
+          #   For a detailed `FieldMask` definition, see
+          #   https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
+          #
+          #   Example: `updateMask=retention_days`.
+          #   A hash of the same form as `Google::Protobuf::FieldMask`
+          #   can also be provided.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Logging::V2::LogBucket]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Logging::V2::LogBucket]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/logging/v2"
+          #
+          #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
+          #
+          #   # TODO: Initialize `name`:
+          #   name = ''
+          #
+          #   # TODO: Initialize `bucket`:
+          #   bucket = {}
+          #
+          #   # TODO: Initialize `update_mask`:
+          #   update_mask = {}
+          #   response = config_client.update_bucket(name, bucket, update_mask)
+
+          def update_bucket \
+              name,
+              bucket,
+              update_mask,
+              options: nil,
+              &block
+            req = {
+              name: name,
+              bucket: bucket,
+              update_mask: update_mask
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Logging::V2::UpdateBucketRequest)
+            @update_bucket.call(req, options, &block)
+          end
+
           # Lists sinks.
           #
           # @param parent [String]
@@ -563,8 +640,10 @@ module Google
           #   require "google/cloud/logging/v2"
           #
           #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
-          #   formatted_sink_name = Google::Cloud::Logging::V2::ConfigServiceV2Client.sink_path("[PROJECT]", "[SINK]")
-          #   response = config_client.get_sink(formatted_sink_name)
+          #
+          #   # TODO: Initialize `sink_name`:
+          #   sink_name = ''
+          #   response = config_client.get_sink(sink_name)
 
           def get_sink \
               sink_name,
@@ -648,8 +727,8 @@ module Google
           # `unique_writer_identity` field.
           #
           # @param sink_name [String]
-          #   Required. The full resource name of the sink to update, including the
-          #   parent resource and the sink identifier:
+          #   Required. The full resource name of the sink to update, including the parent
+          #   resource and the sink identifier:
           #
           #       "projects/[PROJECT_ID]/sinks/[SINK_ID]"
           #       "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
@@ -658,8 +737,8 @@ module Google
           #
           #   Example: `"projects/my-project-id/sinks/my-sink-id"`.
           # @param sink [Google::Logging::V2::LogSink | Hash]
-          #   Required. The updated sink, whose name is the same identifier that appears
-          #   as part of `sink_name`.
+          #   Required. The updated sink, whose name is the same identifier that appears as part
+          #   of `sink_name`.
           #   A hash of the same form as `Google::Logging::V2::LogSink`
           #   can also be provided.
           # @param unique_writer_identity [true, false]
@@ -703,11 +782,13 @@ module Google
           #   require "google/cloud/logging/v2"
           #
           #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
-          #   formatted_sink_name = Google::Cloud::Logging::V2::ConfigServiceV2Client.sink_path("[PROJECT]", "[SINK]")
+          #
+          #   # TODO: Initialize `sink_name`:
+          #   sink_name = ''
           #
           #   # TODO: Initialize `sink`:
           #   sink = {}
-          #   response = config_client.update_sink(formatted_sink_name, sink)
+          #   response = config_client.update_sink(sink_name, sink)
 
           def update_sink \
               sink_name,
@@ -730,8 +811,8 @@ module Google
           # service account is also deleted.
           #
           # @param sink_name [String]
-          #   Required. The full resource name of the sink to delete, including the
-          #   parent resource and the sink identifier:
+          #   Required. The full resource name of the sink to delete, including the parent
+          #   resource and the sink identifier:
           #
           #       "projects/[PROJECT_ID]/sinks/[SINK_ID]"
           #       "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
@@ -750,8 +831,10 @@ module Google
           #   require "google/cloud/logging/v2"
           #
           #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
-          #   formatted_sink_name = Google::Cloud::Logging::V2::ConfigServiceV2Client.sink_path("[PROJECT]", "[SINK]")
-          #   config_client.delete_sink(formatted_sink_name)
+          #
+          #   # TODO: Initialize `sink_name`:
+          #   sink_name = ''
+          #   config_client.delete_sink(sink_name)
 
           def delete_sink \
               sink_name,
@@ -847,8 +930,10 @@ module Google
           #   require "google/cloud/logging/v2"
           #
           #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
-          #   formatted_name = Google::Cloud::Logging::V2::ConfigServiceV2Client.exclusion_path("[PROJECT]", "[EXCLUSION]")
-          #   response = config_client.get_exclusion(formatted_name)
+          #
+          #   # TODO: Initialize `name`:
+          #   name = ''
+          #   response = config_client.get_exclusion(name)
 
           def get_exclusion \
               name,
@@ -922,13 +1007,13 @@ module Google
           #
           #   Example: `"projects/my-project-id/exclusions/my-exclusion-id"`.
           # @param exclusion [Google::Logging::V2::LogExclusion | Hash]
-          #   Required. New values for the existing exclusion. Only the fields specified
-          #   in `update_mask` are relevant.
+          #   Required. New values for the existing exclusion. Only the fields specified in
+          #   `update_mask` are relevant.
           #   A hash of the same form as `Google::Logging::V2::LogExclusion`
           #   can also be provided.
           # @param update_mask [Google::Protobuf::FieldMask | Hash]
-          #   Required. A non-empty list of fields to change in the existing exclusion.
-          #   New values for the fields are taken from the corresponding fields in the
+          #   Required. A non-empty list of fields to change in the existing exclusion. New values
+          #   for the fields are taken from the corresponding fields in the
           #   {Google::Logging::V2::LogExclusion LogExclusion} included in this request. Fields not mentioned in
           #   `update_mask` are not changed and are ignored in the request.
           #
@@ -948,14 +1033,16 @@ module Google
           #   require "google/cloud/logging/v2"
           #
           #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
-          #   formatted_name = Google::Cloud::Logging::V2::ConfigServiceV2Client.exclusion_path("[PROJECT]", "[EXCLUSION]")
+          #
+          #   # TODO: Initialize `name`:
+          #   name = ''
           #
           #   # TODO: Initialize `exclusion`:
           #   exclusion = {}
           #
           #   # TODO: Initialize `update_mask`:
           #   update_mask = {}
-          #   response = config_client.update_exclusion(formatted_name, exclusion, update_mask)
+          #   response = config_client.update_exclusion(name, exclusion, update_mask)
 
           def update_exclusion \
               name,
@@ -994,8 +1081,10 @@ module Google
           #   require "google/cloud/logging/v2"
           #
           #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
-          #   formatted_name = Google::Cloud::Logging::V2::ConfigServiceV2Client.exclusion_path("[PROJECT]", "[EXCLUSION]")
-          #   config_client.delete_exclusion(formatted_name)
+          #
+          #   # TODO: Initialize `name`:
+          #   name = ''
+          #   config_client.delete_exclusion(name)
 
           def delete_exclusion \
               name,
@@ -1043,10 +1132,13 @@ module Google
           #   require "google/cloud/logging/v2"
           #
           #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
-          #   response = config_client.get_cmek_settings
+          #
+          #   # TODO: Initialize `name`:
+          #   name = ''
+          #   response = config_client.get_cmek_settings(name)
 
           def get_cmek_settings \
-              name: nil,
+              name,
               options: nil,
               &block
             req = {
@@ -1113,11 +1205,17 @@ module Google
           #   require "google/cloud/logging/v2"
           #
           #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
-          #   response = config_client.update_cmek_settings
+          #
+          #   # TODO: Initialize `name`:
+          #   name = ''
+          #
+          #   # TODO: Initialize `cmek_settings`:
+          #   cmek_settings = {}
+          #   response = config_client.update_cmek_settings(name, cmek_settings)
 
           def update_cmek_settings \
-              name: nil,
-              cmek_settings: nil,
+              name,
+              cmek_settings,
               update_mask: nil,
               options: nil,
               &block