google-cloud-security-private_ca-v1beta1 0.3.4 → 0.4.0

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

@@ -142,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
 
@@ -216,6 +217,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1beta1::CreateCertificateRequest.new
+              #
+              #   # Call the create_certificate method.
+              #   result = client.create_certificate request
+              #
+              #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::Certificate.
+              #   p result
+              #
               def create_certificate request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -233,9 +249,11 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::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
 
@@ -284,6 +302,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1beta1::GetCertificateRequest.new
+              #
+              #   # Call the get_certificate method.
+              #   result = client.get_certificate request
+              #
+              #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::Certificate.
+              #   p result
+              #
               def get_certificate request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -301,9 +334,11 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::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
 
@@ -372,6 +407,27 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1beta1::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::V1beta1::Certificate.
+              #     p response
+              #   end
+              #
               def list_certificates request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -389,9 +445,11 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::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
 
@@ -458,6 +516,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1beta1::RevokeCertificateRequest.new
+              #
+              #   # Call the revoke_certificate method.
+              #   result = client.revoke_certificate request
+              #
+              #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::Certificate.
+              #   p result
+              #
               def revoke_certificate request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -475,9 +548,11 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::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
 
@@ -543,6 +618,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1beta1::UpdateCertificateRequest.new
+              #
+              #   # Call the update_certificate method.
+              #   result = client.update_certificate request
+              #
+              #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::Certificate.
+              #   p result
+              #
               def update_certificate request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -560,9 +650,11 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1beta1::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
 
@@ -637,6 +729,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1beta1::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?
 
@@ -654,9 +768,11 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::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
 
@@ -727,6 +843,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1beta1::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?
 
@@ -744,9 +882,11 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::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
 
@@ -811,6 +951,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1beta1::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?
 
@@ -828,9 +990,11 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::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
 
@@ -895,6 +1059,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1beta1::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?
 
@@ -912,9 +1098,11 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::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
 
@@ -971,6 +1159,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1beta1::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::V1beta1::FetchCertificateAuthorityCsrResponse.
+              #   p result
+              #
               def fetch_certificate_authority_csr request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -988,9 +1191,11 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::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
 
@@ -1040,6 +1245,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1beta1::GetCertificateAuthorityRequest.new
+              #
+              #   # Call the get_certificate_authority method.
+              #   result = client.get_certificate_authority request
+              #
+              #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthority.
+              #   p result
+              #
               def get_certificate_authority request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1057,9 +1277,11 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::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
 
@@ -1124,6 +1346,27 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1beta1::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::V1beta1::CertificateAuthority.
+              #     p response
+              #   end
+              #
               def list_certificate_authorities request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1141,9 +1384,11 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::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
 
@@ -1208,6 +1453,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1beta1::RestoreCertificateAuthorityRequest.new
+              #
+              #   # Call the restore_certificate_authority method.
+              #   result = client.restore_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 restore_certificate_authority request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1225,9 +1492,11 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::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
 
@@ -1292,6 +1561,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1beta1::ScheduleDeleteCertificateAuthorityRequest.new
+              #
+              #   # Call the schedule_delete_certificate_authority method.
+              #   result = client.schedule_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 schedule_delete_certificate_authority request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1309,9 +1600,11 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::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
 
@@ -1377,6 +1670,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1beta1::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?
 
@@ -1394,9 +1709,11 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1beta1::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
 
@@ -1447,6 +1764,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1beta1::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::V1beta1::CertificateRevocationList.
+              #   p result
+              #
               def get_certificate_revocation_list request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1464,9 +1796,11 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::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
 
@@ -1531,6 +1865,27 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1beta1::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::V1beta1::CertificateRevocationList.
+              #     p response
+              #   end
+              #
               def list_certificate_revocation_lists request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1548,9 +1903,11 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::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
 
@@ -1616,6 +1973,28 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1beta1::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?
 
@@ -1633,9 +2012,11 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::V1beta1::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
 
@@ -1685,6 +2066,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1beta1::GetReusableConfigRequest.new
+              #
+              #   # Call the get_reusable_config method.
+              #   result = client.get_reusable_config request
+              #
+              #   # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::ReusableConfig.
+              #   p result
+              #
               def get_reusable_config request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1702,9 +2098,11 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::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
 
@@ -1769,6 +2167,27 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/security/private_ca/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Security::PrivateCA::V1beta1::ListReusableConfigsRequest.new
+              #
+              #   # Call the list_reusable_configs method.
+              #   result = client.list_reusable_configs 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::V1beta1::ReusableConfig.
+              #     p response
+              #   end
+              #
               def list_reusable_configs request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1786,9 +2205,11 @@ module Google
                   gapic_version: ::Google::Cloud::Security::PrivateCA::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