lib/oci/identity/identity_client.rb
# Deletes the specified tag namespace. This operation triggers a process that removes all of the tags
# defined in the specified tag namespace from all resources in your tenancy and then deletes the tag namespace.
#
# After you start the delete operation:
#
#   * New tag key definitions cannot be created under the namespace.
#   * The state of the tag namespace changes to DELETING.
#   * Tag removal from the resources begins.
#
# This process can take up to 48 hours depending on the number of tag definitions in the namespace, the number of resources
# that are tagged, and the locations of the regions in which those resources reside.
#
# After all tags are removed, the state changes to DELETED. You cannot restore a deleted tag namespace. After the deleted tag namespace
# changes its state to DELETED, you can use the name of the deleted tag namespace again.
#
# After you start this operation, you cannot start either the {#delete_tag delete_tag} or the {#bulk_delete_tags bulk_delete_tags} operation until this process completes.
#
# To delete a tag namespace, you must first retire it. Use {#update_tag_namespace update_tag_namespace}
# to retire a tag namespace.
#
# @param [String] tag_namespace_id The OCID of the tag namespace.
#
# @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 Oracle-assigned identifier for the request. If you need to contact Oracle about a
#   particular request, please provide the request ID.
#
# @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 nil
# @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/cascade_delete_tag_namespace.rb.html) to see an example of how to use cascade_delete_tag_namespace API.
Deletes the specified tag namespace. This operation triggers a process that removes all of the tags
defined in the specified tag namespace from all resources in your tenancy and then deletes the tag namespace.

After you start the delete operation.

New tag key definitions cannot be created under the namespace.
The state of the tag namespace changes to DELETING.
Tag removal from the resources begins.

This process can take up to 48 hours depending on the number of tag definitions in the namespace, the number of resources
that are tagged, and the locations of the regions in which those resources reside.

After all tags are removed, the state changes to DELETED. You cannot restore a deleted tag namespace. After the deleted tag namespace
changes its state to DELETED, you can use the name of the deleted tag namespace again.

After you start this operation, you cannot start either the {#delete_tag delete_tag} or the {#bulk_delete_tags bulk_delete_tags} operation until this process completes.

To delete a tag namespace, you must first retire it. Use {#update_tag_namespace update_tag_namespace}
to retire a tag namespace.
Deletes the specified tag namespace . This operation triggers a process that removes all of the tags defined in the specified tag namespace from all resources in your tenancy and then deletes the tag namespace . After you start the delete operation . New tag key definitions cannot be created under the namespace . The state of the tag namespace changes to DELETING . Tag removal from the resources begins . This process can take up to 48 hours depending on the number of tag definitions in the namespace the number of resources that are tagged and the locations of the regions in which those resources reside . After all tags are removed the state changes to DELETED . You cannot restore a deleted tag namespace . After the deleted tag namespace changes its state to DELETED you can use the name of the deleted tag namespace again . After you start this operation you cannot start either the { #delete_tag delete_tag } or the { #bulk_delete_tags bulk_delete_tags } operation until this process completes . To delete a tag namespace you must first retire it . Use { #update_tag_namespace update_tag_namespace } to retire a tag namespace .
def cascade_delete_tag_namespace(tag_namespace_id, opts = {})
      logger.debug 'Calling operation IdentityClient#cascade_delete_tag_namespace.' if logger
      raise "Missing the required parameter 'tag_namespace_id' when calling cascade_delete_tag_namespace." if tag_namespace_id.nil?
      raise "Parameter value for 'tag_namespace_id' must not be blank" if OCI::Internal::Util.blank_string?(tag_namespace_id)
      path = '/tagNamespaces/{tagNamespaceId}/actions/cascadeDelete'.sub('{tagNamespaceId}', tag_namespace_id.to_s)
      operation_signing_strategy = :standard
      query_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]
      header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
      post_body = nil
      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#cascade_delete_tag_namespace') 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
        )
      end
    end
def cascade_delete_tag_namespace ( tag_namespace_id , opts = { } ) logger . debug 'Calling operation IdentityClient#cascade_delete_tag_namespace.' if logger raise "Missing the required parameter 'tag_namespace_id' when calling cascade_delete_tag_namespace." if tag_namespace_id . nil? raise "Parameter value for 'tag_namespace_id' must not be blank" if OCI :: Internal :: Util . blank_string? ( tag_namespace_id ) path = '/tagNamespaces/{tagNamespaceId}/actions/cascadeDelete' . sub ( '{tagNamespaceId}' , tag_namespace_id . to_s ) operation_signing_strategy = :standard query_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 ] header_params [ :' opc-retry-token ' ] ||= OCI :: Retry . generate_opc_retry_token post_body = nil OCI :: Retry . make_retrying_call ( applicable_retry_config ( opts ) , call_name : 'IdentityClient#cascade_delete_tag_namespace' ) 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 ) end end
Deletes the specified tag namespace.
Deletes the specified tag namespace .
# 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 nil
A Response object with data of type nil
Response
tag_namespace_id
opts
: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 .
: 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 .
opts the optional parameters
opts the optional parameters
note
Click [here] to see an example of how to use cascade_delete_tag_namespace API.
Click [ here ] to see an example of how to use cascade_delete_tag_namespace API .