google-apis-cloudkms_v1 0.36.0 → 0.38.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b5f4246318ae68edf6b31f0139bf7e8ce41a1d01c10ce4c0f258bcd46503f466
-  data.tar.gz: 50f6f8261843f08d1bd279e371a4d82015e7cb2c842b2e2629a03220549d133d
+  metadata.gz: ab0f3194236e78fd812a46360b034e9484e6b750060852f7aadcdcfa3468523c
+  data.tar.gz: '058c24a273cc04b670efedf25c91d8973905b51693181dbc3bac36d1d611c765'
 SHA512:
-  metadata.gz: 7e7d5fc1a37c068e1f624e539633dbbf9434a53a36e66a944d27338207de065b20b219465a913cb4feb973db54a8794a5c9885d11a6ac9b37061e85600410311
-  data.tar.gz: 74c4c39a8393a6f7a1c99a598157dca0a870baa4156a5bd0043ffcfa728e84ca58ba08950404646757c967311d8f6f0e1435563cdf6fff6410a5667566dd8c6f
+  metadata.gz: 97a6949b9de768a466fb09dc13b1ba9568c40f56270865099094a0b0bbed14412a2f53ec0a5f5b29518b7d8e9875f3fff8d6169fc47d8140bfeccd14ea8305ba
+  data.tar.gz: fc076620a6717f5836badcafd3fca821eb82320489445c212253883594f91212471d63570f3541a80e3d79590715f60a206ac4e27f6461e7ba6d6d1ab7ed7824

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-cloudkms_v1
 
+### v0.38.0 (2023-04-16)
+
+* Regenerated from discovery document revision 20230407
+
+### v0.37.0 (2023-03-12)
+
+* Regenerated from discovery document revision 20230307
+
 ### v0.36.0 (2023-02-19)
 
 * Regenerated using generator version 0.12.0

data/lib/google/apis/cloudkms_v1/classes.rb

@@ -649,6 +649,12 @@ module Google
         # @return [String]
         attr_accessor :destroy_time
       
+        # Output only. The root cause of the most recent external destruction failure.
+        # Only present if state is EXTERNAL_DESTRUCTION_FAILED.
+        # Corresponds to the JSON property `externalDestructionFailureReason`
+        # @return [String]
+        attr_accessor :external_destruction_failure_reason
+      
         # ExternalProtectionLevelOptions stores a group of additional fields for
         # configuring a CryptoKeyVersion that are specific to the EXTERNAL protection
         # level and EXTERNAL_VPC protection levels.
@@ -661,6 +667,12 @@ module Google
         # @return [String]
         attr_accessor :generate_time
       
+        # Output only. The root cause of the most recent generation failure. Only
+        # present if state is GENERATION_FAILED.
+        # Corresponds to the JSON property `generationFailureReason`
+        # @return [String]
+        attr_accessor :generation_failure_reason
+      
         # Output only. The root cause of the most recent import failure. Only present if
         # state is IMPORT_FAILED.
         # Corresponds to the JSON property `importFailureReason`
@@ -715,8 +727,10 @@ module Google
           @create_time = args[:create_time] if args.key?(:create_time)
           @destroy_event_time = args[:destroy_event_time] if args.key?(:destroy_event_time)
           @destroy_time = args[:destroy_time] if args.key?(:destroy_time)
+          @external_destruction_failure_reason = args[:external_destruction_failure_reason] if args.key?(:external_destruction_failure_reason)
           @external_protection_level_options = args[:external_protection_level_options] if args.key?(:external_protection_level_options)
           @generate_time = args[:generate_time] if args.key?(:generate_time)
+          @generation_failure_reason = args[:generation_failure_reason] if args.key?(:generation_failure_reason)
           @import_failure_reason = args[:import_failure_reason] if args.key?(:import_failure_reason)
           @import_job = args[:import_job] if args.key?(:import_job)
           @import_time = args[:import_time] if args.key?(:import_time)
@@ -915,6 +929,35 @@ module Google
         end
       end
       
+      # An EkmConfig is a singleton resource that represents configuration parameters
+      # that apply to all CryptoKeys and CryptoKeyVersions with a ProtectionLevel of
+      # EXTERNAL_VPC in a given project and location.
+      class EkmConfig
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Resource name of the default EkmConnection. Setting this field to
+        # the empty string removes the default.
+        # Corresponds to the JSON property `defaultEkmConnection`
+        # @return [String]
+        attr_accessor :default_ekm_connection
+      
+        # Output only. The resource name for the EkmConfig in the format `projects/*/
+        # locations/*/ekmConfig`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @default_ekm_connection = args[:default_ekm_connection] if args.key?(:default_ekm_connection)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
       # An EkmConnection represents an individual EKM connection. It can be used for
       # creating CryptoKeys and CryptoKeyVersions with a ProtectionLevel of
       # EXTERNAL_VPC, as well as performing cryptographic operations using keys
@@ -927,11 +970,23 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
+        # Optional. Identifies the EKM Crypto Space that this EkmConnection maps to.
+        # Note: This field is required if KeyManagementMode is CLOUD_KMS.
+        # Corresponds to the JSON property `cryptoSpacePath`
+        # @return [String]
+        attr_accessor :crypto_space_path
+      
         # Optional. Etag of the currently stored EkmConnection.
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
       
+        # Optional. Describes who can perform control plane operations on the EKM. If
+        # unset, this defaults to MANUAL.
+        # Corresponds to the JSON property `keyManagementMode`
+        # @return [String]
+        attr_accessor :key_management_mode
+      
         # Output only. The resource name for the EkmConnection in the format `projects/*/
         # locations/*/ekmConnections/*`.
         # Corresponds to the JSON property `name`
@@ -952,7 +1007,9 @@ module Google
         # Update properties of this object
         def update!(**args)
           @create_time = args[:create_time] if args.key?(:create_time)
+          @crypto_space_path = args[:crypto_space_path] if args.key?(:crypto_space_path)
           @etag = args[:etag] if args.key?(:etag)
+          @key_management_mode = args[:key_management_mode] if args.key?(:key_management_mode)
           @name = args[:name] if args.key?(:name)
           @service_resolvers = args[:service_resolvers] if args.key?(:service_resolvers)
         end
@@ -2283,6 +2340,19 @@ module Google
         end
       end
       
+      # Response message for EkmService.VerifyConnectivity.
+      class VerifyConnectivityResponse
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # The public key component of the wrapping key. For details of the type of key
       # this public key corresponds to, see the ImportMethod.
       class WrappingPublicKey

data/lib/google/apis/cloudkms_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module CloudkmsV1
       # Version of the google-apis-cloudkms_v1 gem
-      GEM_VERSION = "0.36.0"
+      GEM_VERSION = "0.38.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230127"
+      REVISION = "20230407"
     end
   end
 end

data/lib/google/apis/cloudkms_v1/representations.rb

@@ -118,6 +118,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class EkmConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class EkmConnection
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -304,6 +310,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class VerifyConnectivityResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class WrappingPublicKey
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -430,9 +442,11 @@ module Google
           property :create_time, as: 'createTime'
           property :destroy_event_time, as: 'destroyEventTime'
           property :destroy_time, as: 'destroyTime'
+          property :external_destruction_failure_reason, as: 'externalDestructionFailureReason'
           property :external_protection_level_options, as: 'externalProtectionLevelOptions', class: Google::Apis::CloudkmsV1::ExternalProtectionLevelOptions, decorator: Google::Apis::CloudkmsV1::ExternalProtectionLevelOptions::Representation
       
           property :generate_time, as: 'generateTime'
+          property :generation_failure_reason, as: 'generationFailureReason'
           property :import_failure_reason, as: 'importFailureReason'
           property :import_job, as: 'importJob'
           property :import_time, as: 'importTime'
@@ -486,11 +500,21 @@ module Google
         end
       end
       
+      class EkmConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :default_ekm_connection, as: 'defaultEkmConnection'
+          property :name, as: 'name'
+        end
+      end
+      
       class EkmConnection
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :create_time, as: 'createTime'
+          property :crypto_space_path, as: 'cryptoSpacePath'
           property :etag, as: 'etag'
+          property :key_management_mode, as: 'keyManagementMode'
           property :name, as: 'name'
           collection :service_resolvers, as: 'serviceResolvers', class: Google::Apis::CloudkmsV1::ServiceResolver, decorator: Google::Apis::CloudkmsV1::ServiceResolver::Representation
       
@@ -789,6 +813,12 @@ module Google
         end
       end
       
+      class VerifyConnectivityResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class WrappingPublicKey
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/cloudkms_v1/service.rb

@@ -115,6 +115,36 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Returns the EkmConfig singleton resource for a given project and location.
+        # @param [String] name
+        #   Required. The name of the EkmConfig to get.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudkmsV1::EkmConfig] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudkmsV1::EkmConfig]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_project_location_ekm_config(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::CloudkmsV1::EkmConfig::Representation
+          command.response_class = Google::Apis::CloudkmsV1::EkmConfig
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Lists information about the supported locations for this service.
         # @param [String] name
         #   The resource that owns the locations collection, if applicable.
@@ -158,6 +188,43 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Updates the EkmConfig singleton resource for a given project and location.
+        # @param [String] name
+        #   Output only. The resource name for the EkmConfig in the format `projects/*/
+        #   locations/*/ekmConfig`.
+        # @param [Google::Apis::CloudkmsV1::EkmConfig] ekm_config_object
+        # @param [String] update_mask
+        #   Required. List of fields to be updated in this request.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudkmsV1::EkmConfig] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudkmsV1::EkmConfig]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def update_project_location_ekm_config(name, ekm_config_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v1/{+name}', options)
+          command.request_representation = Google::Apis::CloudkmsV1::EkmConfig::Representation
+          command.request_object = ekm_config_object
+          command.response_representation = Google::Apis::CloudkmsV1::EkmConfig::Representation
+          command.response_class = Google::Apis::CloudkmsV1::EkmConfig
+          command.params['name'] = name unless name.nil?
+          command.query['updateMask'] = update_mask unless update_mask.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Gets the access control policy for a resource. Returns an empty policy if the
         # resource exists and does not have a policy set.
         # @param [String] resource
@@ -557,6 +624,40 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Verifies that Cloud KMS can successfully connect to the external key manager
+        # specified by an EkmConnection. If there is an error connecting to the EKM,
+        # this method returns a FAILED_PRECONDITION status containing structured
+        # information as described at https://cloud.google.com/kms/docs/reference/
+        # ekm_errors.
+        # @param [String] name
+        #   Required. The name of the EkmConnection to verify.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudkmsV1::VerifyConnectivityResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudkmsV1::VerifyConnectivityResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def verify_project_location_ekm_connection_connectivity(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}:verifyConnectivity', options)
+          command.response_representation = Google::Apis::CloudkmsV1::VerifyConnectivityResponse::Representation
+          command.response_class = Google::Apis::CloudkmsV1::VerifyConnectivityResponse
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Create a new KeyRing in a given Project and Location.
         # @param [String] parent
         #   Required. The resource name of the location associated with the KeyRings, in

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-cloudkms_v1
 version: !ruby/object:Gem::Version
-  version: 0.36.0
+  version: 0.38.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-02-19 00:00:00.000000000 Z
+date: 2023-04-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudkms_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudkms_v1/v0.36.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudkms_v1/v0.38.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudkms_v1
 post_install_message: 
 rdoc_options: []