google-cloud-binary_authorization-v1beta1 0.3.2 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: adaac8ddff97203564a021f593179daf892ed954442d1fea844cb0763beb8221
-  data.tar.gz: 5ed710b0113450819c6858e2b7b7457343882a70fc3cf6de08530ba36aa1cc8a
+  metadata.gz: b74ed6131ab9dfc91150bbb0cc27f3ad54655aff5b3fbda772e45f2cc3655fe6
+  data.tar.gz: c15c6b6fe55a063b3495aef59202ad86c86c2f6c356f8d7aaaafcb659a094dfd
 SHA512:
-  metadata.gz: 335cd9cccc6f403b4b9239ca109465cf2a52af1d160ec8de96cdcdda2e8a7816f93a47267f1e7282ee1cb9cd79d2f60f1aba6aae551ee1c75dba955e330cdd31
-  data.tar.gz: 229eb65e88652f4aad95f3174724b70b2d0131da6f39f5d319aa601b5c1a78ad78da42fe0e104dee7af223fbd4e294ceb68183a9439ed180aefc311196f7aa8f
+  metadata.gz: 854bbf403916b22aeb3df35efcf76d2a38b6ce2a80aebe4b28a3553ad5249ffc7c58f510b283029cf38a792c3dedd7b4d816c2e67e6f1cf2884bfed800d54770
+  data.tar.gz: 626f9ca89ebc17354768dc0cdee2279dd398065bf42f1253a5410e8c69737c6fd0560f74c162cc20ac831dddbff4e801ec7d7a5d8fc485bb0b70c2c049f16f23

data/lib/google/cloud/binary_authorization/v1beta1/binauthz_management_service/client.rb

@@ -47,13 +47,12 @@ module Google
             # See {::Google::Cloud::BinaryAuthorization::V1beta1::BinauthzManagementService::Client::Configuration}
             # for a description of the configuration fields.
             #
-            # ## Example
+            # @example
             #
-            # To modify the configuration for all BinauthzManagementService clients:
-            #
-            #     ::Google::Cloud::BinaryAuthorization::V1beta1::BinauthzManagementService::Client.configure do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Modify the configuration for all BinauthzManagementService clients
+            #   ::Google::Cloud::BinaryAuthorization::V1beta1::BinauthzManagementService::Client.configure do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the Client client.
             # @yieldparam config [Client::Configuration]
@@ -132,19 +131,15 @@ module Google
             ##
             # Create a new BinauthzManagementService client object.
             #
-            # ## Examples
-            #
-            # To create a new BinauthzManagementService client with the default
-            # configuration:
-            #
-            #     client = ::Google::Cloud::BinaryAuthorization::V1beta1::BinauthzManagementService::Client.new
+            # @example
             #
-            # To create a new BinauthzManagementService client with a custom
-            # configuration:
+            #   # Create a client using the default configuration
+            #   client = ::Google::Cloud::BinaryAuthorization::V1beta1::BinauthzManagementService::Client.new
             #
-            #     client = ::Google::Cloud::BinaryAuthorization::V1beta1::BinauthzManagementService::Client.new do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Create a client using a custom configuration
+            #   client = ::Google::Cloud::BinaryAuthorization::V1beta1::BinauthzManagementService::Client.new do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the BinauthzManagementService client.
             # @yieldparam config [Client::Configuration]
@@ -164,10 +159,9 @@ module Google
 
               # Create credentials
               credentials = @config.credentials
-              # Use self-signed JWT if the scope and endpoint are unchanged from default,
+              # Use self-signed JWT if the endpoint is unchanged from default,
               # but only if the default endpoint does not have a region prefix.
-              enable_self_signed_jwt = @config.scope == Client.configure.scope &&
-                                       @config.endpoint == Client.configure.endpoint &&
+              enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
                                        !@config.endpoint.split(".").first.include?("-")
               credentials ||= Credentials.default scope: @config.scope,
                                                   enable_self_signed_jwt: enable_self_signed_jwt
@@ -189,16 +183,13 @@ module Google
             # Service calls
 
             ##
-            # A {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy} specifies the
-            # {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestors} that must
-            # attest to a container image, before the project is allowed to deploy that
+            # A {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy} specifies the {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestors} that must attest to
+            # a container image, before the project is allowed to deploy that
             # image. There is at most one policy per project. All image admission
             # requests are permitted if a project has no policy.
             #
-            # Gets the {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy} for this
-            # project. Returns a default
-            # {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy} if the project
-            # does not have one.
+            # Gets the {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy} for this project. Returns a default
+            # {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy} if the project does not have one.
             #
             # @overload get_policy(request, options = nil)
             #   Pass arguments to `get_policy` via a request object, either of type
@@ -216,9 +207,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The resource name of the
-            #     {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy} to retrieve, in
-            #     the format `projects/*/policy`.
+            #     Required. The resource name of the {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy} to retrieve,
+            #     in the format `projects/*/policy`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::BinaryAuthorization::V1beta1::Policy]
@@ -228,6 +218,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/binary_authorization/v1beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::BinaryAuthorization::V1beta1::BinauthzManagementService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::BinaryAuthorization::V1beta1::GetPolicyRequest.new
+            #
+            #   # Call the get_policy method.
+            #   result = client.get_policy request
+            #
+            #   # The returned object is of type Google::Cloud::BinaryAuthorization::V1beta1::Policy.
+            #   p result
+            #
             def get_policy request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -245,16 +250,20 @@ module Google
                 gapic_version: ::Google::Cloud::BinaryAuthorization::V1beta1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              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_policy.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_policy.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @binauthz_management_service_stub.call_rpc :get_policy, request, options: options do |response, operation|
@@ -266,13 +275,11 @@ module Google
             end
 
             ##
-            # Creates or updates a project's
-            # {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy}, and returns a
-            # copy of the new {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy}.
-            # A policy is always updated as a whole, to avoid race conditions with
-            # concurrent policy enforcement (or management!) requests. Returns NOT_FOUND
-            # if the project does not exist, INVALID_ARGUMENT if the request is
-            # malformed.
+            # Creates or updates a project's {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy}, and returns a copy of the
+            # new {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy}. A policy is always updated as a whole, to avoid race
+            # conditions with concurrent policy enforcement (or management!)
+            # requests. Returns NOT_FOUND if the project does not exist, INVALID_ARGUMENT
+            # if the request is malformed.
             #
             # @overload update_policy(request, options = nil)
             #   Pass arguments to `update_policy` via a request object, either of type
@@ -290,11 +297,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param policy [::Google::Cloud::BinaryAuthorization::V1beta1::Policy, ::Hash]
-            #     Required. A new or updated
-            #     {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy} value. The
-            #     service will overwrite the [policy
-            #     name][google.cloud.binaryauthorization.v1beta1.Policy.name] field with the
-            #     resource name in the request URL, in the format `projects/*/policy`.
+            #     Required. A new or updated {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy} value. The service will
+            #     overwrite the {::Google::Cloud::BinaryAuthorization::V1beta1::Policy#name policy name} field with the resource name in
+            #     the request URL, in the format `projects/*/policy`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::BinaryAuthorization::V1beta1::Policy]
@@ -304,6 +309,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/binary_authorization/v1beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::BinaryAuthorization::V1beta1::BinauthzManagementService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::BinaryAuthorization::V1beta1::UpdatePolicyRequest.new
+            #
+            #   # Call the update_policy method.
+            #   result = client.update_policy request
+            #
+            #   # The returned object is of type Google::Cloud::BinaryAuthorization::V1beta1::Policy.
+            #   p result
+            #
             def update_policy request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -321,16 +341,20 @@ module Google
                 gapic_version: ::Google::Cloud::BinaryAuthorization::V1beta1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "policy.name" => request.policy.name
-              }
+              header_params = {}
+              if request.policy&.name
+                header_params["policy.name"] = request.policy.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_policy.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.update_policy.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @binauthz_management_service_stub.call_rpc :update_policy, request, options: options do |response, operation|
@@ -342,13 +366,10 @@ module Google
             end
 
             ##
-            # Creates an {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor},
-            # and returns a copy of the new
-            # {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor}. Returns
-            # NOT_FOUND if the project does not exist, INVALID_ARGUMENT if the request is
-            # malformed, ALREADY_EXISTS if the
-            # {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} already
-            # exists.
+            # Creates an {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor}, and returns a copy of the new
+            # {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor}. Returns NOT_FOUND if the project does not exist,
+            # INVALID_ARGUMENT if the request is malformed, ALREADY_EXISTS if the
+            # {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} already exists.
             #
             # @overload create_attestor(request, options = nil)
             #   Pass arguments to `create_attestor` via a request object, either of type
@@ -366,17 +387,13 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The parent of this
-            #     {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor}.
+            #     Required. The parent of this {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor}.
             #   @param attestor_id [::String]
-            #     Required. The
-            #     {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestors} ID.
+            #     Required. The {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestors} ID.
             #   @param attestor [::Google::Cloud::BinaryAuthorization::V1beta1::Attestor, ::Hash]
-            #     Required. The initial
-            #     {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} value. The
-            #     service will overwrite the [attestor
-            #     name][google.cloud.binaryauthorization.v1beta1.Attestor.name] field with
-            #     the resource name, in the format `projects/*/attestors/*`.
+            #     Required. The initial {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} value. The service will
+            #     overwrite the {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor#name attestor name} field with the resource name,
+            #     in the format `projects/*/attestors/*`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::BinaryAuthorization::V1beta1::Attestor]
@@ -386,6 +403,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/binary_authorization/v1beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::BinaryAuthorization::V1beta1::BinauthzManagementService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::BinaryAuthorization::V1beta1::CreateAttestorRequest.new
+            #
+            #   # Call the create_attestor method.
+            #   result = client.create_attestor request
+            #
+            #   # The returned object is of type Google::Cloud::BinaryAuthorization::V1beta1::Attestor.
+            #   p result
+            #
             def create_attestor request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -403,16 +435,20 @@ module Google
                 gapic_version: ::Google::Cloud::BinaryAuthorization::V1beta1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              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.create_attestor.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.create_attestor.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @binauthz_management_service_stub.call_rpc :create_attestor, request, options: options do |response, operation|
@@ -425,9 +461,7 @@ module Google
 
             ##
             # Gets an {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor}.
-            # Returns NOT_FOUND if the
-            # {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} does not
-            # exist.
+            # Returns NOT_FOUND if the {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} does not exist.
             #
             # @overload get_attestor(request, options = nil)
             #   Pass arguments to `get_attestor` via a request object, either of type
@@ -445,9 +479,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the
-            #     {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} to retrieve,
-            #     in the format `projects/*/attestors/*`.
+            #     Required. The name of the {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} to retrieve, in the format
+            #     `projects/*/attestors/*`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::BinaryAuthorization::V1beta1::Attestor]
@@ -457,6 +490,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/binary_authorization/v1beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::BinaryAuthorization::V1beta1::BinauthzManagementService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::BinaryAuthorization::V1beta1::GetAttestorRequest.new
+            #
+            #   # Call the get_attestor method.
+            #   result = client.get_attestor request
+            #
+            #   # The returned object is of type Google::Cloud::BinaryAuthorization::V1beta1::Attestor.
+            #   p result
+            #
             def get_attestor request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -474,16 +522,20 @@ module Google
                 gapic_version: ::Google::Cloud::BinaryAuthorization::V1beta1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              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_attestor.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_attestor.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @binauthz_management_service_stub.call_rpc :get_attestor, request, options: options do |response, operation|
@@ -496,9 +548,7 @@ module Google
 
             ##
             # Updates an {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor}.
-            # Returns NOT_FOUND if the
-            # {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} does not
-            # exist.
+            # Returns NOT_FOUND if the {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} does not exist.
             #
             # @overload update_attestor(request, options = nil)
             #   Pass arguments to `update_attestor` via a request object, either of type
@@ -516,12 +566,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param attestor [::Google::Cloud::BinaryAuthorization::V1beta1::Attestor, ::Hash]
-            #     Required. The updated
-            #     {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} value. The
-            #     service will overwrite the [attestor
-            #     name][google.cloud.binaryauthorization.v1beta1.Attestor.name] field with
-            #     the resource name in the request URL, in the format
-            #     `projects/*/attestors/*`.
+            #     Required. The updated {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} value. The service will
+            #     overwrite the {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor#name attestor name} field with the resource name
+            #     in the request URL, in the format `projects/*/attestors/*`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::BinaryAuthorization::V1beta1::Attestor]
@@ -531,6 +578,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/binary_authorization/v1beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::BinaryAuthorization::V1beta1::BinauthzManagementService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::BinaryAuthorization::V1beta1::UpdateAttestorRequest.new
+            #
+            #   # Call the update_attestor method.
+            #   result = client.update_attestor request
+            #
+            #   # The returned object is of type Google::Cloud::BinaryAuthorization::V1beta1::Attestor.
+            #   p result
+            #
             def update_attestor request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -548,16 +610,20 @@ module Google
                 gapic_version: ::Google::Cloud::BinaryAuthorization::V1beta1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "attestor.name" => request.attestor.name
-              }
+              header_params = {}
+              if request.attestor&.name
+                header_params["attestor.name"] = request.attestor.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_attestor.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.update_attestor.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @binauthz_management_service_stub.call_rpc :update_attestor, request, options: options do |response, operation|
@@ -589,16 +655,14 @@ module Google
             #
             #   @param parent [::String]
             #     Required. The resource name of the project associated with the
-            #     {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestors}, in the
-            #     format `projects/*`.
+            #     {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestors}, in the format `projects/*`.
             #   @param page_size [::Integer]
             #     Requested page size. The server may return fewer results than requested. If
             #     unspecified, the server will pick an appropriate default.
             #   @param page_token [::String]
             #     A token identifying a page of results the server should return. Typically,
-            #     this is the value of
-            #     {::Google::Cloud::BinaryAuthorization::V1beta1::ListAttestorsResponse#next_page_token ListAttestorsResponse.next_page_token}
-            #     returned from the previous call to the `ListAttestors` method.
+            #     this is the value of {::Google::Cloud::BinaryAuthorization::V1beta1::ListAttestorsResponse#next_page_token ListAttestorsResponse.next_page_token} returned
+            #     from the previous call to the `ListAttestors` method.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::BinaryAuthorization::V1beta1::Attestor>]
@@ -608,6 +672,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/binary_authorization/v1beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::BinaryAuthorization::V1beta1::BinauthzManagementService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::BinaryAuthorization::V1beta1::ListAttestorsRequest.new
+            #
+            #   # Call the list_attestors method.
+            #   result = client.list_attestors request
+            #
+            #   # The returned object is of type Gapic::PagedEnumerable. You can
+            #   # iterate over all elements by calling #each, and the enumerable
+            #   # will lazily make API calls to fetch subsequent pages. Other
+            #   # methods are also available for managing paging directly.
+            #   result.each do |response|
+            #     # Each element is of type ::Google::Cloud::BinaryAuthorization::V1beta1::Attestor.
+            #     p response
+            #   end
+            #
             def list_attestors request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -625,16 +710,20 @@ module Google
                 gapic_version: ::Google::Cloud::BinaryAuthorization::V1beta1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              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.list_attestors.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_attestors.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @binauthz_management_service_stub.call_rpc :list_attestors, request, options: options do |response, operation|
@@ -647,10 +736,8 @@ module Google
             end
 
             ##
-            # Deletes an {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor}.
-            # Returns NOT_FOUND if the
-            # {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} does not
-            # exist.
+            # Deletes an {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor}. Returns NOT_FOUND if the
+            # {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} does not exist.
             #
             # @overload delete_attestor(request, options = nil)
             #   Pass arguments to `delete_attestor` via a request object, either of type
@@ -668,9 +755,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the
-            #     {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestors} to delete,
-            #     in the format `projects/*/attestors/*`.
+            #     Required. The name of the {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestors} to delete, in the format
+            #     `projects/*/attestors/*`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
@@ -680,6 +766,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/binary_authorization/v1beta1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::BinaryAuthorization::V1beta1::BinauthzManagementService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::BinaryAuthorization::V1beta1::DeleteAttestorRequest.new
+            #
+            #   # Call the delete_attestor method.
+            #   result = client.delete_attestor request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def delete_attestor request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -697,16 +798,20 @@ module Google
                 gapic_version: ::Google::Cloud::BinaryAuthorization::V1beta1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              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.delete_attestor.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.delete_attestor.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @binauthz_management_service_stub.call_rpc :delete_attestor, request, options: options do |response, operation|
@@ -730,22 +835,21 @@ module Google
             # Configuration can be applied globally to all clients, or to a single client
             # on construction.
             #
-            # # Examples
-            #
-            # To modify the global config, setting the timeout for get_policy
-            # to 20 seconds, and all remaining timeouts to 10 seconds:
-            #
-            #     ::Google::Cloud::BinaryAuthorization::V1beta1::BinauthzManagementService::Client.configure do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.get_policy.timeout = 20.0
-            #     end
-            #
-            # To apply the above configuration only to a new client:
-            #
-            #     client = ::Google::Cloud::BinaryAuthorization::V1beta1::BinauthzManagementService::Client.new do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.get_policy.timeout = 20.0
-            #     end
+            # @example
+            #
+            #   # Modify the global config, setting the timeout for
+            #   # get_policy to 20 seconds,
+            #   # and all remaining timeouts to 10 seconds.
+            #   ::Google::Cloud::BinaryAuthorization::V1beta1::BinauthzManagementService::Client.configure do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.get_policy.timeout = 20.0
+            #   end
+            #
+            #   # Apply the above configuration only to a new client.
+            #   client = ::Google::Cloud::BinaryAuthorization::V1beta1::BinauthzManagementService::Client.new do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.get_policy.timeout = 20.0
+            #   end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.