google-cloud-security-private_ca-v1 0.1.2 → 0.1.6

data/lib/google/cloud/security/private_ca/v1/certificate_authority_service/client.rb

@@ -43,13 +43,12 @@ module Google
               # See {::Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client::Configuration}
               # for a description of the configuration fields.
               #
-              # ## Example
+              # @example
               #
-              # To modify the configuration for all CertificateAuthorityService clients:
-              #
-              #     ::Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.configure do |config|
-              #       config.timeout = 10.0
-              #     end
+              #   # Modify the configuration for all CertificateAuthorityService clients
+              #   ::Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.configure do |config|
+              #     config.timeout = 10.0
+              #   end
               #
               # @yield [config] Configure the Client client.
               # @yieldparam config [Client::Configuration]
@@ -101,19 +100,15 @@ module Google
               ##
               # Create a new CertificateAuthorityService client object.
               #
-              # ## Examples
-              #
-              # To create a new CertificateAuthorityService client with the default
-              # configuration:
+              # @example
               #
-              #     client = ::Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #   # Create a client using the default configuration
+              #   client = ::Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
               #
-              # To create a new CertificateAuthorityService client with a custom
-              # configuration:
-              #
-              #     client = ::Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new do |config|
-              #       config.timeout = 10.0
-              #     end
+              #   # Create a client using a custom configuration
+              #   client = ::Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new do |config|
+              #     config.timeout = 10.0
+              #   end
               #
               # @yield [config] Configure the CertificateAuthorityService client.
               # @yieldparam config [Client::Configuration]
@@ -133,10 +128,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
@@ -148,6 +142,7 @@ module Google
 
                 @operations_client = Operations.new do |config|
                   config.credentials = credentials
+                  config.quota_project = @quota_project_id
                   config.endpoint = @config.endpoint
                 end
 
@@ -204,11 +199,11 @@ module Google
               #     already been completed. The server will guarantee that for at least 60
               #     minutes since the first request.
               #
-              #     For example, consider a situation where you make an initial request and t
-              #     he request times out. If you make the request again with the same request
-              #     ID, the server can check if original operation with the same request ID
-              #     was received, and if so, will ignore the second request. This prevents
-              #     clients from accidentally creating duplicate commitments.
+              #     For example, consider a situation where you make an initial request and the
+              #     request times out. If you make the request again with the same request ID,
+              #     the server can check if original operation with the same request ID was
+              #     received, and if so, will ignore the second request. This prevents clients
+              #     from accidentally creating duplicate commitments.
               #
               #     The request ID must be a valid UUID with the exception that zero UUID is
               #     not supported (00000000-0000-0000-0000-000000000000).
@@ -237,6 +232,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::CreateCertificateRequest.new
+              #
+              #   # Call the create_certificate method.
+              #   result = client.create_certificate request
+              #
+              #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1::Certificate.
+              #   p result
+              #
               def create_certificate request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -254,16 +264,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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_certificate.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.create_certificate.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :create_certificate, request, options: options do |response, operation|
@@ -303,6 +317,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::GetCertificateRequest.new
+              #
+              #   # Call the get_certificate method.
+              #   result = client.get_certificate request
+              #
+              #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1::Certificate.
+              #   p result
+              #
               def get_certificate request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -320,16 +349,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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_certificate.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.get_certificate.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :get_certificate, request, options: options do |response, operation|
@@ -389,6 +422,27 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::ListCertificatesRequest.new
+              #
+              #   # Call the list_certificates method.
+              #   result = client.list_certificates 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::Security::PrivateCA::V1::Certificate.
+              #     p response
+              #   end
+              #
               def list_certificates request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -406,16 +460,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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_certificates.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.list_certificates.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :list_certificates, request, options: options do |response, operation|
@@ -474,6 +532,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::RevokeCertificateRequest.new
+              #
+              #   # Call the revoke_certificate method.
+              #   result = client.revoke_certificate request
+              #
+              #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1::Certificate.
+              #   p result
+              #
               def revoke_certificate request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -491,16 +564,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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.revoke_certificate.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.revoke_certificate.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :revoke_certificate, request, options: options do |response, operation|
@@ -557,6 +634,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::UpdateCertificateRequest.new
+              #
+              #   # Call the update_certificate method.
+              #   result = client.update_certificate request
+              #
+              #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1::Certificate.
+              #   p result
+              #
               def update_certificate request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -574,16 +666,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "certificate.name" => request.certificate.name
-                }
+                header_params = {}
+                if request.certificate&.name
+                  header_params["certificate.name"] = request.certificate.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_certificate.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.update_certificate.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :update_certificate, request, options: options do |response, operation|
@@ -649,6 +745,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::ActivateCertificateAuthorityRequest.new
+              #
+              #   # Call the activate_certificate_authority method.
+              #   result = client.activate_certificate_authority 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 activate_certificate_authority request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -666,16 +784,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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.activate_certificate_authority.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.activate_certificate_authority.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :activate_certificate_authority, request, options: options do |response, operation|
@@ -737,6 +859,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::CreateCertificateAuthorityRequest.new
+              #
+              #   # Call the create_certificate_authority method.
+              #   result = client.create_certificate_authority 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 create_certificate_authority request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -754,16 +898,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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_certificate_authority.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.create_certificate_authority.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :create_certificate_authority, request, options: options do |response, operation|
@@ -819,6 +967,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::DisableCertificateAuthorityRequest.new
+              #
+              #   # Call the disable_certificate_authority method.
+              #   result = client.disable_certificate_authority 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 disable_certificate_authority request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -836,16 +1006,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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.disable_certificate_authority.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.disable_certificate_authority.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :disable_certificate_authority, request, options: options do |response, operation|
@@ -901,6 +1075,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::EnableCertificateAuthorityRequest.new
+              #
+              #   # Call the enable_certificate_authority method.
+              #   result = client.enable_certificate_authority 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 enable_certificate_authority request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -918,16 +1114,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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.enable_certificate_authority.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.enable_certificate_authority.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :enable_certificate_authority, request, options: options do |response, operation|
@@ -975,6 +1175,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::FetchCertificateAuthorityCsrRequest.new
+              #
+              #   # Call the fetch_certificate_authority_csr method.
+              #   result = client.fetch_certificate_authority_csr request
+              #
+              #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1::FetchCertificateAuthorityCsrResponse.
+              #   p result
+              #
               def fetch_certificate_authority_csr request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -992,16 +1207,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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.fetch_certificate_authority_csr.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.fetch_certificate_authority_csr.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :fetch_certificate_authority_csr, request, options: options do |response, operation|
@@ -1042,6 +1261,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::GetCertificateAuthorityRequest.new
+              #
+              #   # Call the get_certificate_authority method.
+              #   result = client.get_certificate_authority request
+              #
+              #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1::CertificateAuthority.
+              #   p result
+              #
               def get_certificate_authority request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1059,16 +1293,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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_certificate_authority.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.get_certificate_authority.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :get_certificate_authority, request, options: options do |response, operation|
@@ -1124,6 +1362,27 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::ListCertificateAuthoritiesRequest.new
+              #
+              #   # Call the list_certificate_authorities method.
+              #   result = client.list_certificate_authorities 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::Security::PrivateCA::V1::CertificateAuthority.
+              #     p response
+              #   end
+              #
               def list_certificate_authorities request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1141,16 +1400,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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_certificate_authorities.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.list_certificate_authorities.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :list_certificate_authorities, request, options: options do |response, operation|
@@ -1206,6 +1469,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::UndeleteCertificateAuthorityRequest.new
+              #
+              #   # Call the undelete_certificate_authority method.
+              #   result = client.undelete_certificate_authority 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 undelete_certificate_authority request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1223,16 +1508,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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.undelete_certificate_authority.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.undelete_certificate_authority.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :undelete_certificate_authority, request, options: options do |response, operation|
@@ -1291,6 +1580,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::DeleteCertificateAuthorityRequest.new
+              #
+              #   # Call the delete_certificate_authority method.
+              #   result = client.delete_certificate_authority 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 delete_certificate_authority request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1308,16 +1619,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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_certificate_authority.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.delete_certificate_authority.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :delete_certificate_authority, request, options: options do |response, operation|
@@ -1374,6 +1689,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::UpdateCertificateAuthorityRequest.new
+              #
+              #   # Call the update_certificate_authority method.
+              #   result = client.update_certificate_authority 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 update_certificate_authority request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1391,16 +1728,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "certificate_authority.name" => request.certificate_authority.name
-                }
+                header_params = {}
+                if request.certificate_authority&.name
+                  header_params["certificate_authority.name"] = request.certificate_authority.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_certificate_authority.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.update_certificate_authority.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :update_certificate_authority, request, options: options do |response, operation|
@@ -1461,6 +1802,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::CreateCaPoolRequest.new
+              #
+              #   # Call the create_ca_pool method.
+              #   result = client.create_ca_pool 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 create_ca_pool request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1478,16 +1841,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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_ca_pool.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.create_ca_pool.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :create_ca_pool, request, options: options do |response, operation|
@@ -1544,6 +1911,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::UpdateCaPoolRequest.new
+              #
+              #   # Call the update_ca_pool method.
+              #   result = client.update_ca_pool 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 update_ca_pool request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1561,16 +1950,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "ca_pool.name" => request.ca_pool.name
-                }
+                header_params = {}
+                if request.ca_pool&.name
+                  header_params["ca_pool.name"] = request.ca_pool.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_ca_pool.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.update_ca_pool.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :update_ca_pool, request, options: options do |response, operation|
@@ -1611,6 +2004,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::GetCaPoolRequest.new
+              #
+              #   # Call the get_ca_pool method.
+              #   result = client.get_ca_pool request
+              #
+              #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1::CaPool.
+              #   p result
+              #
               def get_ca_pool request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1628,16 +2036,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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_ca_pool.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.get_ca_pool.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :get_ca_pool, request, options: options do |response, operation|
@@ -1693,6 +2105,27 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::ListCaPoolsRequest.new
+              #
+              #   # Call the list_ca_pools method.
+              #   result = client.list_ca_pools 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::Security::PrivateCA::V1::CaPool.
+              #     p response
+              #   end
+              #
               def list_ca_pools request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1710,16 +2143,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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_ca_pools.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.list_ca_pools.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :list_ca_pools, request, options: options do |response, operation|
@@ -1775,6 +2212,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::DeleteCaPoolRequest.new
+              #
+              #   # Call the delete_ca_pool method.
+              #   result = client.delete_ca_pool 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 delete_ca_pool request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1792,16 +2251,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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_ca_pool.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.delete_ca_pool.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :delete_ca_pool, request, options: options do |response, operation|
@@ -1859,6 +2322,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::FetchCaCertsRequest.new
+              #
+              #   # Call the fetch_ca_certs method.
+              #   result = client.fetch_ca_certs request
+              #
+              #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1::FetchCaCertsResponse.
+              #   p result
+              #
               def fetch_ca_certs request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1876,16 +2354,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "ca_pool" => request.ca_pool
-                }
+                header_params = {}
+                if request.ca_pool
+                  header_params["ca_pool"] = request.ca_pool
+                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.fetch_ca_certs.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.fetch_ca_certs.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :fetch_ca_certs, request, options: options do |response, operation|
@@ -1926,6 +2408,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::GetCertificateRevocationListRequest.new
+              #
+              #   # Call the get_certificate_revocation_list method.
+              #   result = client.get_certificate_revocation_list request
+              #
+              #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1::CertificateRevocationList.
+              #   p result
+              #
               def get_certificate_revocation_list request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1943,16 +2440,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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_certificate_revocation_list.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.get_certificate_revocation_list.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :get_certificate_revocation_list, request, options: options do |response, operation|
@@ -2008,6 +2509,27 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::ListCertificateRevocationListsRequest.new
+              #
+              #   # Call the list_certificate_revocation_lists method.
+              #   result = client.list_certificate_revocation_lists 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::Security::PrivateCA::V1::CertificateRevocationList.
+              #     p response
+              #   end
+              #
               def list_certificate_revocation_lists request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2025,16 +2547,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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_certificate_revocation_lists.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.list_certificate_revocation_lists.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :list_certificate_revocation_lists, request, options: options do |response, operation|
@@ -2091,6 +2617,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::UpdateCertificateRevocationListRequest.new
+              #
+              #   # Call the update_certificate_revocation_list method.
+              #   result = client.update_certificate_revocation_list 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 update_certificate_revocation_list request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2108,16 +2656,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "certificate_revocation_list.name" => request.certificate_revocation_list.name
-                }
+                header_params = {}
+                if request.certificate_revocation_list&.name
+                  header_params["certificate_revocation_list.name"] = request.certificate_revocation_list.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_certificate_revocation_list.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.update_certificate_revocation_list.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :update_certificate_revocation_list, request, options: options do |response, operation|
@@ -2179,6 +2731,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::CreateCertificateTemplateRequest.new
+              #
+              #   # Call the create_certificate_template method.
+              #   result = client.create_certificate_template 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 create_certificate_template request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2196,16 +2770,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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_certificate_template.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.create_certificate_template.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :create_certificate_template, request, options: options do |response, operation|
@@ -2261,6 +2839,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::DeleteCertificateTemplateRequest.new
+              #
+              #   # Call the delete_certificate_template method.
+              #   result = client.delete_certificate_template 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 delete_certificate_template request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2278,16 +2878,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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_certificate_template.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.delete_certificate_template.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :delete_certificate_template, request, options: options do |response, operation|
@@ -2329,6 +2933,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::GetCertificateTemplateRequest.new
+              #
+              #   # Call the get_certificate_template method.
+              #   result = client.get_certificate_template request
+              #
+              #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1::CertificateTemplate.
+              #   p result
+              #
               def get_certificate_template request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2346,16 +2965,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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_certificate_template.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.get_certificate_template.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :get_certificate_template, request, options: options do |response, operation|
@@ -2411,6 +3034,27 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::ListCertificateTemplatesRequest.new
+              #
+              #   # Call the list_certificate_templates method.
+              #   result = client.list_certificate_templates 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::Security::PrivateCA::V1::CertificateTemplate.
+              #     p response
+              #   end
+              #
               def list_certificate_templates request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2428,16 +3072,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::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_certificate_templates.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.list_certificate_templates.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :list_certificate_templates, request, options: options do |response, operation|
@@ -2494,6 +3142,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1::UpdateCertificateTemplateRequest.new
+              #
+              #   # Call the update_certificate_template method.
+              #   result = client.update_certificate_template 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 update_certificate_template request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2511,16 +3181,20 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "certificate_template.name" => request.certificate_template.name
-                }
+                header_params = {}
+                if request.certificate_template&.name
+                  header_params["certificate_template.name"] = request.certificate_template.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_certificate_template.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.update_certificate_template.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @certificate_authority_service_stub.call_rpc :update_certificate_template, request, options: options do |response, operation|
@@ -2545,22 +3219,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 create_certificate
-              # to 20 seconds, and all remaining timeouts to 10 seconds:
-              #
-              #     ::Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.configure do |config|
-              #       config.timeout = 10.0
-              #       config.rpcs.create_certificate.timeout = 20.0
-              #     end
-              #
-              # To apply the above configuration only to a new client:
-              #
-              #     client = ::Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new do |config|
-              #       config.timeout = 10.0
-              #       config.rpcs.create_certificate.timeout = 20.0
-              #     end
+              # @example
+              #
+              #   # Modify the global config, setting the timeout for
+              #   # create_certificate to 20 seconds,
+              #   # and all remaining timeouts to 10 seconds.
+              #   ::Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.configure do |config|
+              #     config.timeout = 10.0
+              #     config.rpcs.create_certificate.timeout = 20.0
+              #   end
+              #
+              #   # Apply the above configuration only to a new client.
+              #   client = ::Google::Cloud::Security::PrivateCA::V1::CertificateAuthorityService::Client.new do |config|
+              #     config.timeout = 10.0
+              #     config.rpcs.create_certificate.timeout = 20.0
+              #   end
               #
               # @!attribute [rw] endpoint
               #   The hostname or hostname:port of the service endpoint.