oci 2.7.0 → 2.8.0

data/lib/oci/key_management/kms_crypto_client_composite_operations.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, Oracle and/or its affiliates. All rights reserved.
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI

data/lib/oci/key_management/kms_management_client.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, Oracle and/or its affiliates. All rights reserved.
 
 require 'uri'
 require 'logger'
@@ -83,8 +83,13 @@ module OCI
 
 
     # Cancels the scheduled deletion of the specified key. Canceling
-    # a scheduled deletion restores the key to the respective
-    # states they were in before the deletion was scheduled.
+    # a scheduled deletion restores the key's lifecycle state to what
+    # it was before its scheduled deletion.
+    #
+    # As a provisioning operation, this call is subject to a Key Management limit that applies to
+    # the total number of requests across all provisioning write operations. Key Management might
+    # throttle this call to reject an otherwise valid request when the total rate of provisioning
+    # write operations exceeds 10 requests per second for a given tenancy.
     #
     # @param [String] key_id The OCID of the key.
     # @param [Hash] opts the optional parameters
@@ -157,7 +162,99 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Moves a key into a different compartment. When provided, If-Match is checked against ETag values of the key.
+    # Cancels the scheduled deletion of the specified key version. Canceling
+    # a scheduled deletion restores the key version to its lifecycle state from
+    # before its scheduled deletion.
+    #
+    # As a provisioning operation, this call is subject to a Key Management limit that applies to
+    # the total number of requests across all provisioning write operations. Key Management might
+    # throttle this call to reject an otherwise valid request when the total rate of provisioning
+    # write operations exceeds 10 requests per second for a given tenancy.
+    #
+    # @param [String] key_id The OCID of the key.
+    # @param [String] key_version_id The OCID of the key version.
+    # @param [Hash] opts the optional parameters
+    # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
+    #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @option opts [String] :if_match For optimistic concurrency control. In the PUT or DELETE call for a
+    #   resource, set the `if-match` parameter to the value of the etag from a
+    #   previous GET or POST response for that resource. The resource will be
+    #   updated or deleted only if the etag you provide matches the resource's
+    #   current etag value.
+    #
+    # @option opts [String] :opc_request_id Unique identifier for the request. If provided, the returned request ID
+    #   will include this value. Otherwise, a random request ID will be
+    #   generated by the service.
+    #
+    # @option opts [String] :opc_retry_token A token that uniquely identifies a request so it can be retried in case
+    #   of a timeout or server error without risk of executing that same action
+    #   again. Retry tokens expire after 24 hours, but can be invalidated
+    #   before then due to conflicting operations (e.g., if a resource has been
+    #   deleted and purged from the system, then a retry of the original
+    #   creation request may be rejected).
+    #
+    # @return [Response] A Response object with data of type {OCI::KeyManagement::Models::KeyVersion KeyVersion}
+    def cancel_key_version_deletion(key_id, key_version_id, opts = {})
+      logger.debug 'Calling operation KmsManagementClient#cancel_key_version_deletion.' if logger
+
+      raise "Missing the required parameter 'key_id' when calling cancel_key_version_deletion." if key_id.nil?
+      raise "Missing the required parameter 'key_version_id' when calling cancel_key_version_deletion." if key_version_id.nil?
+      raise "Parameter value for 'key_id' must not be blank" if OCI::Internal::Util.blank_string?(key_id)
+      raise "Parameter value for 'key_version_id' must not be blank" if OCI::Internal::Util.blank_string?(key_version_id)
+
+      path = '/20180608/keys/{keyId}/keyVersions/{keyVersionId}/actions/cancelDeletion'.sub('{keyId}', key_id.to_s).sub('{keyVersionId}', key_version_id.to_s)
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params[:accept] = 'application/json'
+      header_params[:'content-type'] = 'application/json'
+      header_params[:'if-match'] = opts[:if_match] if opts[:if_match]
+      header_params[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
+      header_params[:'opc-retry-token'] = opts[:opc_retry_token] if opts[:opc_retry_token]
+      # rubocop:enable Style/NegatedIf
+      header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'KmsManagementClient#cancel_key_version_deletion') do
+        @api_client.call_api(
+          :POST,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body,
+          return_type: 'OCI::KeyManagement::Models::KeyVersion'
+        )
+      end
+      # rubocop:enable Metrics/BlockLength
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:enable Metrics/MethodLength, Layout/EmptyLines
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
+
+
+    # Moves a key into a different compartment within the same tenancy. For information about
+    # moving resources between compartments, see [Moving Resources to a Different Compartment](https://docs.cloud.oracle.com/iaas/Content/Identity/Tasks/managingcompartments.htm#moveRes).
+    #
+    # When provided, if-match is checked against the ETag values of the key.
+    #
+    # As a provisioning operation, this call is subject to a Key Management limit that applies to
+    # the total number of requests across all provisioning write operations. Key Management might
+    # throttle this call to reject an otherwise valid request when the total rate of provisioning
+    # write operations exceeds 10 requests per second for a given tenancy.
+    #
     # @param [String] key_id The OCID of the key.
     # @param [OCI::KeyManagement::Models::ChangeKeyCompartmentDetails] change_key_compartment_details
     # @param [Hash] opts the optional parameters
@@ -230,7 +327,13 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Creates a new key.
+    # Creates a new master encryption key.
+    #
+    # As a management operation, this call is subject to a Key Management limit that applies to the total
+    # number of requests across all management write operations. Key Management might throttle this call
+    # to reject an otherwise valid request when the total rate of management write operations exceeds 10
+    # requests per second for a given tenancy.
+    #
     # @param [OCI::KeyManagement::Models::CreateKeyDetails] create_key_details CreateKeyDetails
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
@@ -294,8 +397,13 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Generates new cryptographic material for a key. The key must be in an `ENABLED` state to be
-    # rotated.
+    # Generates a new [KeyVersion](https://docs.cloud.oracle.com/api/#/en/key/release/KeyVersion/) resource that provides new cryptographic
+    # material for a master encryption key. The key must be in an ENABLED state to be rotated.
+    #
+    # As a management operation, this call is subject to a Key Management limit that applies to the total number
+    # of requests across all  management write operations. Key Management might throttle this call to reject an
+    # otherwise valid request when the total rate of management write operations exceeds 10 requests per second
+    # for a given tenancy.
     #
     # @param [String] key_id The OCID of the key.
     # @param [Hash] opts the optional parameters
@@ -361,8 +469,13 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Disables a key to make it unavailable for encryption
-    # or decryption.
+    # Disables a master encryption key so it can no longer be used for encryption, decryption, or
+    # generating new data encryption keys.
+    #
+    # As a management operation, this call is subject to a Key Management limit that applies to the total number
+    # of requests across all management write operations. Key Management might throttle this call to reject an
+    # otherwise valid request when the total rate of management write operations exceeds 10 requests per second
+    # for a given tenancy.
     #
     # @param [String] key_id The OCID of the key.
     # @param [Hash] opts the optional parameters
@@ -435,8 +548,13 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Enables a key to make it available for encryption or
-    # decryption.
+    # Enables a master encryption key so it can be used for encryption, decryption, or
+    # generating new data encryption keys.
+    #
+    # As a management operation, this call is subject to a Key Management limit that applies to the total number
+    # of requests across all management write operations. Key Management might throttle this call to reject an
+    # otherwise valid request when the total rate of management write operations exceeds 10 requests per second
+    # for a given tenancy.
     #
     # @param [String] key_id The OCID of the key.
     # @param [Hash] opts the optional parameters
@@ -509,7 +627,12 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets information about the specified key.
+    # Gets information about the specified master encryption key.
+    #
+    # As a management operation, this call is subject to a Key Management limit that applies to the total number
+    # of requests across all management read operations. Key Management might throttle this call to reject an
+    # otherwise valid request when the total rate of management read operations exceeds 10 requests per second for
+    # a given tenancy.
     #
     # @param [String] key_id The OCID of the key.
     # @param [Hash] opts the optional parameters
@@ -568,6 +691,11 @@ module OCI
 
     # Gets information about the specified key version.
     #
+    # As a management operation, this call is subject to a Key Management limit that applies to the total number
+    # of requests across all management read operations. Key Management might throttle this call to reject an
+    # otherwise valid request when the total rate of management read operations exceeds 10 requests per second
+    # for a given tenancy.
+    #
     # @param [String] key_id The OCID of the key.
     # @param [String] key_version_id The OCID of the key version.
     # @param [Hash] opts the optional parameters
@@ -626,7 +754,198 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Lists all key versions for the specified key.
+    # Returns the RSA wrapping key associated with the vault in the endpoint.
+    #
+    # @param [Hash] opts the optional parameters
+    # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
+    #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @option opts [String] :opc_request_id Unique identifier for the request. If provided, the returned request ID
+    #   will include this value. Otherwise, a random request ID will be
+    #   generated by the service.
+    #
+    # @return [Response] A Response object with data of type {OCI::KeyManagement::Models::WrappingKey WrappingKey}
+    def get_wrapping_key(opts = {})
+      logger.debug 'Calling operation KmsManagementClient#get_wrapping_key.' if logger
+
+
+      path = '/20180608/wrappingKeys'
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params[:accept] = 'application/json'
+      header_params[:'content-type'] = 'application/json'
+      header_params[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'KmsManagementClient#get_wrapping_key') do
+        @api_client.call_api(
+          :GET,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body,
+          return_type: 'OCI::KeyManagement::Models::WrappingKey'
+        )
+      end
+      # rubocop:enable Metrics/BlockLength
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:enable Metrics/MethodLength, Layout/EmptyLines
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
+
+
+    # Imports the given wrapped/encrypted AES key.
+    # @param [OCI::KeyManagement::Models::ImportKeyDetails] import_key_details ImportKeyDetails
+    # @param [Hash] opts the optional parameters
+    # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
+    #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @option opts [String] :opc_request_id Unique identifier for the request. If provided, the returned request ID
+    #   will include this value. Otherwise, a random request ID will be
+    #   generated by the service.
+    #
+    # @option opts [String] :opc_retry_token A token that uniquely identifies a request so it can be retried in case
+    #   of a timeout or server error without risk of executing that same action
+    #   again. Retry tokens expire after 24 hours, but can be invalidated
+    #   before then due to conflicting operations (e.g., if a resource has been
+    #   deleted and purged from the system, then a retry of the original
+    #   creation request may be rejected).
+    #
+    # @return [Response] A Response object with data of type {OCI::KeyManagement::Models::Key Key}
+    def import_key(import_key_details, opts = {})
+      logger.debug 'Calling operation KmsManagementClient#import_key.' if logger
+
+      raise "Missing the required parameter 'import_key_details' when calling import_key." if import_key_details.nil?
+
+      path = '/20180608/keys/import'
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params[:accept] = 'application/json'
+      header_params[:'content-type'] = 'application/json'
+      header_params[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
+      header_params[:'opc-retry-token'] = opts[:opc_retry_token] if opts[:opc_retry_token]
+      # rubocop:enable Style/NegatedIf
+      header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
+
+      post_body = @api_client.object_to_http_body(import_key_details)
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'KmsManagementClient#import_key') do
+        @api_client.call_api(
+          :POST,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body,
+          return_type: 'OCI::KeyManagement::Models::Key'
+        )
+      end
+      # rubocop:enable Metrics/BlockLength
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:enable Metrics/MethodLength, Layout/EmptyLines
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
+
+
+    # Imports the given key version.
+    # @param [String] key_id The OCID of the key.
+    # @param [OCI::KeyManagement::Models::ImportKeyVersionDetails] import_key_version_details ImportKeyVersionDetails
+    # @param [Hash] opts the optional parameters
+    # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
+    #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @option opts [String] :opc_request_id Unique identifier for the request. If provided, the returned request ID
+    #   will include this value. Otherwise, a random request ID will be
+    #   generated by the service.
+    #
+    # @option opts [String] :opc_retry_token A token that uniquely identifies a request so it can be retried in case
+    #   of a timeout or server error without risk of executing that same action
+    #   again. Retry tokens expire after 24 hours, but can be invalidated
+    #   before then due to conflicting operations (e.g., if a resource has been
+    #   deleted and purged from the system, then a retry of the original
+    #   creation request may be rejected).
+    #
+    # @return [Response] A Response object with data of type {OCI::KeyManagement::Models::KeyVersion KeyVersion}
+    def import_key_version(key_id, import_key_version_details, opts = {})
+      logger.debug 'Calling operation KmsManagementClient#import_key_version.' if logger
+
+      raise "Missing the required parameter 'key_id' when calling import_key_version." if key_id.nil?
+      raise "Missing the required parameter 'import_key_version_details' when calling import_key_version." if import_key_version_details.nil?
+      raise "Parameter value for 'key_id' must not be blank" if OCI::Internal::Util.blank_string?(key_id)
+
+      path = '/20180608/keys/{keyId}/keyVersions/import'.sub('{keyId}', key_id.to_s)
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params[:accept] = 'application/json'
+      header_params[:'content-type'] = 'application/json'
+      header_params[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
+      header_params[:'opc-retry-token'] = opts[:opc_retry_token] if opts[:opc_retry_token]
+      # rubocop:enable Style/NegatedIf
+      header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
+
+      post_body = @api_client.object_to_http_body(import_key_version_details)
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'KmsManagementClient#import_key_version') do
+        @api_client.call_api(
+          :POST,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body,
+          return_type: 'OCI::KeyManagement::Models::KeyVersion'
+        )
+      end
+      # rubocop:enable Metrics/BlockLength
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:enable Metrics/MethodLength, Layout/EmptyLines
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
+
+
+    # Lists all [KeyVersion](https://docs.cloud.oracle.com/api/#/en/key/release/KeyVersion/) resources for the specified
+    # master encryption key.
+    #
+    # As a management operation, this call is subject to a Key Management limit that applies to the total number
+    # of requests across all management read operations. Key Management might throttle this call to reject an
+    # otherwise valid request when the total rate of management read operations exceeds 10 requests per second
+    # for a given tenancy.
     #
     # @param [String] key_id The OCID of the key.
     # @param [Hash] opts the optional parameters
@@ -642,7 +961,7 @@ module OCI
     #   generated by the service.
     #
     # @option opts [String] :sort_by The field to sort by. You can specify only one sort order. The default
-    #   order for TIMECREATED is descending. The default order for DISPLAYNAME
+    #   order for `TIMECREATED` is descending. The default order for `DISPLAYNAME`
     #   is ascending.
     #
     #   Allowed values are: TIMECREATED, DISPLAYNAME
@@ -708,7 +1027,12 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Lists the keys in the specified vault and compartment.
+    # Lists the master encryption keys in the specified vault and compartment.
+    #
+    # As a management operation, this call is subject to a Key Management limit that applies to the total number
+    # of requests across all management read operations. Key Management might throttle this call to reject an
+    # otherwise valid request when the total rate of management read operations exceeds 10 requests per second
+    # for a given tenancy.
     #
     # @param [String] compartment_id The OCID of the compartment.
     # @param [Hash] opts the optional parameters
@@ -724,7 +1048,7 @@ module OCI
     #   generated by the service.
     #
     # @option opts [String] :sort_by The field to sort by. You can specify only one sort order. The default
-    #   order for TIMECREATED is descending. The default order for DISPLAYNAME
+    #   order for `TIMECREATED` is descending. The default order for `DISPLAYNAME`
     #   is ascending.
     #
     #   Allowed values are: TIMECREATED, DISPLAYNAME
@@ -790,8 +1114,13 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Schedules the deletion of the specified key. This sets the state of the key
-    # to `PENDING_DELETION` and then deletes it after the retention period ends.
+    # Schedules the deletion of the specified key. This sets the lifecycle state of the key
+    # to `PENDING_DELETION` and then deletes it after the specified retention period ends.
+    #
+    # As a provisioning operation, this call is subject to a Key Management limit that applies to
+    # the total number of requests across all provisioning write operations. Key Management might
+    # throttle this call to reject an otherwise valid request when the total rate of provisioning
+    # write operations exceeds 10 requests per second for a given tenancy.
     #
     # @param [String] key_id The OCID of the key.
     # @param [OCI::KeyManagement::Models::ScheduleKeyDeletionDetails] schedule_key_deletion_details ScheduleKeyDeletionDetails
@@ -866,9 +1195,98 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Updates the properties of a key. Specifically, you can update the
+    # Schedules the deletion of the specified key version. This sets the lifecycle state of the key version
+    # to `PENDING_DELETION` and then deletes it after the specified retention period ends.
+    #
+    # As a provisioning operation, this call is subject to a Key Management limit that applies to
+    # the total number of requests across all provisioning write operations. Key Management might
+    # throttle this call to reject an otherwise valid request when the total rate of provisioning
+    # write operations exceeds 10 requests per second for a given tenancy.
+    #
+    # @param [String] key_id The OCID of the key.
+    # @param [String] key_version_id The OCID of the key version.
+    # @param [OCI::KeyManagement::Models::ScheduleKeyVersionDeletionDetails] schedule_key_version_deletion_details ScheduleKeyVersionDeletionDetails
+    # @param [Hash] opts the optional parameters
+    # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
+    #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @option opts [String] :if_match For optimistic concurrency control. In the PUT or DELETE call for a
+    #   resource, set the `if-match` parameter to the value of the etag from a
+    #   previous GET or POST response for that resource. The resource will be
+    #   updated or deleted only if the etag you provide matches the resource's
+    #   current etag value.
+    #
+    # @option opts [String] :opc_request_id Unique identifier for the request. If provided, the returned request ID
+    #   will include this value. Otherwise, a random request ID will be
+    #   generated by the service.
+    #
+    # @option opts [String] :opc_retry_token A token that uniquely identifies a request so it can be retried in case
+    #   of a timeout or server error without risk of executing that same action
+    #   again. Retry tokens expire after 24 hours, but can be invalidated
+    #   before then due to conflicting operations (e.g., if a resource has been
+    #   deleted and purged from the system, then a retry of the original
+    #   creation request may be rejected).
+    #
+    # @return [Response] A Response object with data of type {OCI::KeyManagement::Models::KeyVersion KeyVersion}
+    def schedule_key_version_deletion(key_id, key_version_id, schedule_key_version_deletion_details, opts = {})
+      logger.debug 'Calling operation KmsManagementClient#schedule_key_version_deletion.' if logger
+
+      raise "Missing the required parameter 'key_id' when calling schedule_key_version_deletion." if key_id.nil?
+      raise "Missing the required parameter 'key_version_id' when calling schedule_key_version_deletion." if key_version_id.nil?
+      raise "Missing the required parameter 'schedule_key_version_deletion_details' when calling schedule_key_version_deletion." if schedule_key_version_deletion_details.nil?
+      raise "Parameter value for 'key_id' must not be blank" if OCI::Internal::Util.blank_string?(key_id)
+      raise "Parameter value for 'key_version_id' must not be blank" if OCI::Internal::Util.blank_string?(key_version_id)
+
+      path = '/20180608/keys/{keyId}/keyVersions/{keyVersionId}/actions/scheduleDeletion'.sub('{keyId}', key_id.to_s).sub('{keyVersionId}', key_version_id.to_s)
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params[:accept] = 'application/json'
+      header_params[:'content-type'] = 'application/json'
+      header_params[:'if-match'] = opts[:if_match] if opts[:if_match]
+      header_params[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
+      header_params[:'opc-retry-token'] = opts[:opc_retry_token] if opts[:opc_retry_token]
+      # rubocop:enable Style/NegatedIf
+      header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
+
+      post_body = @api_client.object_to_http_body(schedule_key_version_deletion_details)
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'KmsManagementClient#schedule_key_version_deletion') do
+        @api_client.call_api(
+          :POST,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body,
+          return_type: 'OCI::KeyManagement::Models::KeyVersion'
+        )
+      end
+      # rubocop:enable Metrics/BlockLength
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:enable Metrics/MethodLength, Layout/EmptyLines
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
+
+
+    # Updates the properties of a master encryption key. Specifically, you can update the
     # `displayName`, `freeformTags`, and `definedTags` properties. Furthermore,
-    # the key must in an `ACTIVE` or `CREATING` state to be updated.
+    # the key must in an ENABLED or CREATING state to be updated.
+    #
+    # As a management operation, this call is subject to a Key Management limit that applies to the total number
+    # of requests across all management write operations. Key Management might throttle this call to reject an
+    # otherwise valid request when the total rate of management write operations exceeds 10 requests per second
+    # for a given tenancy.
     #
     # @param [String] key_id The OCID of the key.
     # @param [OCI::KeyManagement::Models::UpdateKeyDetails] update_key_details UpdateKeyDetails