lib/oci/key_management/kms_vault_client.rb
# Restores a vault from an encrypted backup file stored in Oracle Cloud Infrastructure Object
# Storage. If a vault with the same OCID already exists, this operation returns
# a response with a 409 HTTP status error code.
#
# @param [String] compartment_id The OCID of the compartment.
# @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).
#
# @option opts [OCI::KeyManagement::Models::RestoreVaultFromObjectStoreDetails] :restore_vault_from_object_store_details RestoreVaultFromObjectStoreDetails
# @return [Response] A Response object with data of type {OCI::KeyManagement::Models::Vault Vault}
# @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/keymanagement/restore_vault_from_object_store.rb.html) to see an example of how to use restore_vault_from_object_store API.
Restores a vault from an encrypted backup file stored in Oracle Cloud Infrastructure Object
Storage. If a vault with the same OCID already exists, this operation returns
a response with a 409 HTTP status error code.
Restores a vault from an encrypted backup file stored in Oracle Cloud Infrastructure Object Storage . If a vault with the same OCID already exists this operation returns a response with a 409 HTTP status error code .
def restore_vault_from_object_store(compartment_id, opts = {})
      logger.debug 'Calling operation KmsVaultClient#restore_vault_from_object_store.' if logger
      raise "Missing the required parameter 'compartment_id' when calling restore_vault_from_object_store." if compartment_id.nil?
      path = '/20180608/vaults/actions/restoreFromObjectStore'
      operation_signing_strategy = :standard
      query_params = {}
      query_params[:compartmentId] = compartment_id
      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]
      header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
      post_body = @api_client.object_to_http_body(opts[:restore_vault_from_object_store_details])
      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'KmsVaultClient#restore_vault_from_object_store') 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::Vault'
        )
      end
    end
def restore_vault_from_object_store ( compartment_id , opts = { } ) logger . debug 'Calling operation KmsVaultClient#restore_vault_from_object_store.' if logger raise "Missing the required parameter 'compartment_id' when calling restore_vault_from_object_store." if compartment_id . nil? path = '/20180608/vaults/actions/restoreFromObjectStore' operation_signing_strategy = :standard query_params = { } query_params [ :compartmentId ] = compartment_id 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 ] header_params [ :' opc-retry-token ' ] ||= OCI :: Retry . generate_opc_retry_token post_body = @api_client . object_to_http_body ( opts [ :restore_vault_from_object_store_details ] ) OCI :: Retry . make_retrying_call ( applicable_retry_config ( opts ) , call_name : 'KmsVaultClient#restore_vault_from_object_store' ) 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::Vault' ) end end
Restores a vault from an encrypted backup file stored in Oracle Cloud Infrastructure Object
Storage.
Restores a vault from an encrypted backup file stored in Oracle Cloud Infrastructure Object Storage .
# rubocop:disable Style/NegatedIf # Query Params # Header Params # rubocop:enable Style/NegatedIf # rubocop:disable Metrics/BlockLength # rubocop:enable Metrics/BlockLength
A Response object with data of type {OCI::KeyManagement::Models::Vault Vault}
A Response object with data of type { OCI :: KeyManagement :: Models :: Vault Vault }
Response
compartment_id
opts
None
opts the optional parameters
opts the optional parameters
note
Click [here] to see an example of how to use restore_vault_from_object_store API.
Click [ here ] to see an example of how to use restore_vault_from_object_store API .