google-cloud-certificate_manager-v1 1.5.0 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c0165b0a3d47be2ba1dc4c2f0ef6d08498bf2b7af03498a33f6ba0c09288da28
-  data.tar.gz: 8db73ca17934ee9d67aa0e8ca64392371657c09ba6223675c31873baca230e69
+  metadata.gz: 78b1375bc57b7d1fb9f6d31274ed7a93bc27bc1bb5dba078e9a7682763e976d7
+  data.tar.gz: ff730ad94fd3662f68303d0f02f65ad6a9a89cedc9c1c83cb50a7bcf94ecbcdc
 SHA512:
-  metadata.gz: 0bcece92efa41345963f7b17b952ca4b1b4a3f7676f56385ee827edc7559cc37ca4042bd5df4b9cc34c7ae9d44f1a33da15090c5686254078a2667aa9662e7e5
-  data.tar.gz: 04247e89600cfdb4ad43c36000a6d702a70cbdb6b41f53c1dbe7d5000fbeb0a9868376633c72fa854d45d88453d5bce9e2a0cca41ae11e746fa2f4d32a4410f7
+  metadata.gz: b9d15c1779b03df547b56a7d360a58dcd662947d44d67808ba4664d7f2bc9c184c6f81f53cf37bab81967df615300e455442787f8e87541ca3011f26ad3c4e4e
+  data.tar.gz: c8594b993a70fa1313ecbacb59789f2d2d26e1cee8b7064f35d233302375d2f9032357e00ffd15f56acda927ebf0295e6db4a5e6921dd75ecc679f6e0f720c6c

data/README.md

@@ -1,8 +1,7 @@
 # Ruby Client for the Certificate Manager V1 API
 
-API Client library for the Certificate Manager V1 API
+Certificate Manager simplifies the acquisition, deployment, and management of Transport Layer Security (TLS) certificates.
 
-Certificate Manager lets you acquire and manage Transport Layer Security (TLS) (SSL) certificates for use with classic external HTTP(S) load balancers in Google Cloud.
 
 https://github.com/googleapis/google-cloud-ruby
 
@@ -40,9 +39,6 @@ response = client.list_certificates request
 View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-certificate_manager-v1/latest)
 for class and method documentation.
 
-See also the [Product Documentation](https://cloud.google.com/certificate-manager)
-for general usage information.
-
 ## Debug Logging
 
 This library comes with opt-in Debug Logging that can help you troubleshoot

data/lib/google/cloud/certificate_manager/v1/bindings_override.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2023 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/google/cloud/certificate_manager/v1/certificate_manager/client.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2022 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -380,17 +380,17 @@ module Google
             #     Required. The project and location from which the certificate should be
             #     listed, specified in the format `projects/*/locations/*`.
             #   @param page_size [::Integer]
-            #     Maximum number of certificates to return per call.
+            #     Optional. Maximum number of certificates to return per call.
             #   @param page_token [::String]
-            #     The value returned by the last `ListCertificatesResponse`. Indicates that
-            #     this is a continuation of a prior `ListCertificates` call, and that the
-            #     system should return the next page of data.
+            #     Optional. The value returned by the last `ListCertificatesResponse`.
+            #     Indicates that this is a continuation of a prior `ListCertificates` call,
+            #     and that the system should return the next page of data.
             #   @param filter [::String]
-            #     Filter expression to restrict the Certificates returned.
+            #     Optional. Filter expression to restrict the Certificates returned.
             #   @param order_by [::String]
-            #     A list of Certificate field names used to specify the order of the returned
-            #     results. The default sorting order is ascending. To specify descending
-            #     order for a field, add a suffix `" desc"`.
+            #     Optional. A list of Certificate field names used to specify the order of
+            #     the returned results. The default sorting order is ascending. To specify
+            #     descending order for a field, add a suffix `" desc"`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::Certificate>]
@@ -862,16 +862,16 @@ module Google
             #     Required. The project and location from which the certificate maps should
             #     be listed, specified in the format `projects/*/locations/*`.
             #   @param page_size [::Integer]
-            #     Maximum number of certificate maps to return per call.
+            #     Optional. Maximum number of certificate maps to return per call.
             #   @param page_token [::String]
-            #     The value returned by the last `ListCertificateMapsResponse`. Indicates
-            #     that this is a continuation of a prior `ListCertificateMaps` call, and that
-            #     the system should return the next page of data.
+            #     Optional. The value returned by the last `ListCertificateMapsResponse`.
+            #     Indicates that this is a continuation of a prior `ListCertificateMaps`
+            #     call, and that the system should return the next page of data.
             #   @param filter [::String]
-            #     Filter expression to restrict the Certificates Maps returned.
+            #     Optional. Filter expression to restrict the Certificates Maps returned.
             #   @param order_by [::String]
-            #     A list of Certificate Map field names used to specify the order of the
-            #     returned results. The default sorting order is ascending. To specify
+            #     Optional. A list of Certificate Map field names used to specify the order
+            #     of the returned results. The default sorting order is ascending. To specify
             #     descending order for a field, add a suffix `" desc"`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -1347,19 +1347,20 @@ module Google
             #     certificate map entries should be listed, specified in the format
             #     `projects/*/locations/*/certificateMaps/*`.
             #   @param page_size [::Integer]
-            #     Maximum number of certificate map entries to return. The service may return
-            #     fewer than this value.
-            #     If unspecified, at most 50 certificate map entries will be returned.
-            #     The maximum value is 1000; values above 1000 will be coerced to 1000.
+            #     Optional. Maximum number of certificate map entries to return. The service
+            #     may return fewer than this value. If unspecified, at most 50 certificate
+            #     map entries will be returned. The maximum value is 1000; values above 1000
+            #     will be coerced to 1000.
             #   @param page_token [::String]
-            #     The value returned by the last `ListCertificateMapEntriesResponse`.
-            #     Indicates that this is a continuation of a prior
-            #     `ListCertificateMapEntries` call, and that the system should return the
-            #     next page of data.
+            #     Optional. The value returned by the last
+            #     `ListCertificateMapEntriesResponse`. Indicates that this is a continuation
+            #     of a prior `ListCertificateMapEntries` call, and that the system should
+            #     return the next page of data.
             #   @param filter [::String]
-            #     Filter expression to restrict the returned Certificate Map Entries.
+            #     Optional. Filter expression to restrict the returned Certificate Map
+            #     Entries.
             #   @param order_by [::String]
-            #     A list of Certificate Map Entry field names used to specify
+            #     Optional. A list of Certificate Map Entry field names used to specify
             #     the order of the returned results. The default sorting order is ascending.
             #     To specify descending order for a field, add a suffix `" desc"`.
             #
@@ -1833,16 +1834,16 @@ module Google
             #     Required. The project and location from which the dns authorizations should
             #     be listed, specified in the format `projects/*/locations/*`.
             #   @param page_size [::Integer]
-            #     Maximum number of dns authorizations to return per call.
+            #     Optional. Maximum number of dns authorizations to return per call.
             #   @param page_token [::String]
-            #     The value returned by the last `ListDnsAuthorizationsResponse`. Indicates
-            #     that this is a continuation of a prior `ListDnsAuthorizations` call, and
-            #     that the system should return the next page of data.
+            #     Optional. The value returned by the last `ListDnsAuthorizationsResponse`.
+            #     Indicates that this is a continuation of a prior `ListDnsAuthorizations`
+            #     call, and that the system should return the next page of data.
             #   @param filter [::String]
-            #     Filter expression to restrict the Dns Authorizations returned.
+            #     Optional. Filter expression to restrict the Dns Authorizations returned.
             #   @param order_by [::String]
-            #     A list of Dns Authorization field names used to specify the order of the
-            #     returned results. The default sorting order is ascending. To specify
+            #     Optional. A list of Dns Authorization field names used to specify the order
+            #     of the returned results. The default sorting order is ascending. To specify
             #     descending order for a field, add a suffix `" desc"`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -2315,18 +2316,18 @@ module Google
             #     Required. The project and location from which the certificate should be
             #     listed, specified in the format `projects/*/locations/*`.
             #   @param page_size [::Integer]
-            #     Maximum number of certificate configs to return per call.
+            #     Optional. Maximum number of certificate configs to return per call.
             #   @param page_token [::String]
-            #     The value returned by the last `ListCertificateIssuanceConfigsResponse`.
-            #     Indicates that this is a continuation of a prior
-            #     `ListCertificateIssuanceConfigs` call, and that the system should return
-            #     the next page of data.
+            #     Optional. The value returned by the last
+            #     `ListCertificateIssuanceConfigsResponse`. Indicates that this is a
+            #     continuation of a prior `ListCertificateIssuanceConfigs` call, and that the
+            #     system should return the next page of data.
             #   @param filter [::String]
-            #     Filter expression to restrict the Certificates Configs returned.
+            #     Optional. Filter expression to restrict the Certificates Configs returned.
             #   @param order_by [::String]
-            #     A list of Certificate Config field names used to specify the order of the
-            #     returned results. The default sorting order is ascending. To specify
-            #     descending order for a field, add a suffix `" desc"`.
+            #     Optional. A list of Certificate Config field names used to specify the
+            #     order of the returned results. The default sorting order is ascending. To
+            #     specify descending order for a field, add a suffix `" desc"`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::CertificateManager::V1::CertificateIssuanceConfig>]
@@ -2583,6 +2584,104 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Updates a CertificateIssuanceConfig.
+            #
+            # @overload update_certificate_issuance_config(request, options = nil)
+            #   Pass arguments to `update_certificate_issuance_config` via a request object, either of type
+            #   {::Google::Cloud::CertificateManager::V1::UpdateCertificateIssuanceConfigRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::CertificateManager::V1::UpdateCertificateIssuanceConfigRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload update_certificate_issuance_config(certificate_issuance_config: nil, update_mask: nil)
+            #   Pass arguments to `update_certificate_issuance_config` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param certificate_issuance_config [::Google::Cloud::CertificateManager::V1::CertificateIssuanceConfig, ::Hash]
+            #     Required. A definition of the certificate issuance config to update.
+            #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
+            #     Required. The update mask applies to the resource. For the `FieldMask`
+            #     definition, see
+            #     https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Gapic::Operation]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Gapic::Operation]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/certificate_manager/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::CertificateManager::V1::CertificateManager::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::CertificateManager::V1::UpdateCertificateIssuanceConfigRequest.new
+            #
+            #   # Call the update_certificate_issuance_config method.
+            #   result = client.update_certificate_issuance_config request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "No response received."
+            #   end
+            #
+            def update_certificate_issuance_config request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::CertificateManager::V1::UpdateCertificateIssuanceConfigRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.update_certificate_issuance_config.metadata.to_h
+
+              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::CertificateManager::V1::VERSION
+              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.certificate_issuance_config&.name
+                header_params["certificate_issuance_config.name"] = request.certificate_issuance_config.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_issuance_config.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.update_certificate_issuance_config.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @certificate_manager_stub.call_rpc :update_certificate_issuance_config, request, options: options do |response, operation|
+                response = ::Gapic::Operation.new response, @operations_client, options: options
+                yield response, operation if block_given?
+                throw :response, response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Deletes a single CertificateIssuanceConfig.
             #
@@ -2700,16 +2799,16 @@ module Google
             #     Required. The project and location from which the TrustConfigs should be
             #     listed, specified in the format `projects/*/locations/*`.
             #   @param page_size [::Integer]
-            #     Maximum number of TrustConfigs to return per call.
+            #     Optional. Maximum number of TrustConfigs to return per call.
             #   @param page_token [::String]
-            #     The value returned by the last `ListTrustConfigsResponse`. Indicates
-            #     that this is a continuation of a prior `ListTrustConfigs` call, and that
-            #     the system should return the next page of data.
+            #     Optional. The value returned by the last `ListTrustConfigsResponse`.
+            #     Indicates that this is a continuation of a prior `ListTrustConfigs` call,
+            #     and that the system should return the next page of data.
             #   @param filter [::String]
-            #     Filter expression to restrict the TrustConfigs returned.
+            #     Optional. Filter expression to restrict the TrustConfigs returned.
             #   @param order_by [::String]
-            #     A list of TrustConfig field names used to specify the order of the
-            #     returned results. The default sorting order is ascending. To specify
+            #     Optional. A list of TrustConfig field names used to specify the order of
+            #     the returned results. The default sorting order is ascending. To specify
             #     descending order for a field, add a suffix `" desc"`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -3088,7 +3187,7 @@ module Google
             #     Required. A name of the TrustConfig to delete. Must be in the format
             #     `projects/*/locations/*/trustConfigs/*`.
             #   @param etag [::String]
-            #     The current etag of the TrustConfig.
+            #     Optional. The current etag of the TrustConfig.
             #     If an etag is provided and does not match the current etag of the resource,
             #     deletion will be blocked and an ABORTED error will be returned.
             #
@@ -3466,6 +3565,11 @@ module Google
                 #
                 attr_reader :create_certificate_issuance_config
                 ##
+                # RPC-specific configuration for `update_certificate_issuance_config`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :update_certificate_issuance_config
+                ##
                 # RPC-specific configuration for `delete_certificate_issuance_config`
                 # @return [::Gapic::Config::Method]
                 #
@@ -3544,6 +3648,8 @@ module Google
                   @get_certificate_issuance_config = ::Gapic::Config::Method.new get_certificate_issuance_config_config
                   create_certificate_issuance_config_config = parent_rpcs.create_certificate_issuance_config if parent_rpcs.respond_to? :create_certificate_issuance_config
                   @create_certificate_issuance_config = ::Gapic::Config::Method.new create_certificate_issuance_config_config
+                  update_certificate_issuance_config_config = parent_rpcs.update_certificate_issuance_config if parent_rpcs.respond_to? :update_certificate_issuance_config
+                  @update_certificate_issuance_config = ::Gapic::Config::Method.new update_certificate_issuance_config_config
                   delete_certificate_issuance_config_config = parent_rpcs.delete_certificate_issuance_config if parent_rpcs.respond_to? :delete_certificate_issuance_config
                   @delete_certificate_issuance_config = ::Gapic::Config::Method.new delete_certificate_issuance_config_config
                   list_trust_configs_config = parent_rpcs.list_trust_configs if parent_rpcs.respond_to? :list_trust_configs

data/lib/google/cloud/certificate_manager/v1/certificate_manager/credentials.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2022 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/google/cloud/certificate_manager/v1/certificate_manager/operations.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2022 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/google/cloud/certificate_manager/v1/certificate_manager/paths.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2022 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.