Oracle Cloud Infrastructure Documentation

Deleting a Tag Key Definition

Learn how to delete a tag key definition on Private Cloud Appliance.

A tag key definition must be retired before it can be deleted. See Retiring a Tag Key Definition.

When you delete a tag key definition, tags that are based on this tag key definition are removed from all resources. Tag defaults that are based on this tag key definition are not removed from compartments.

You cannot restore a deleted tag key definition.

You can create a new tag key definition with the same name as the deleted tag key definition.

    1. In the navigation menu, select Governance, and then select Tag Namespaces.

      If the tag namespace where you want to delete a tag key definition is not listed, use the Compartment drop-down menu above the tag namespaces list to select the correct compartment.

    2. Select the name of the tag namespace where you want to delete a tag key definition.

    3. On the tag namespace details page, scroll down to the Resources section and select Tag Key Definitions.

    4. Ensure that the tag key definition that you want to delete is retired (in state Inactive).

    5. For the tag key definition that you want to delete, select the Actions menu and select the Delete option.

    6. At the Delete Tag Key Definition prompt, select Confirm.

      The tag key definition status changes to Deleting, and all tags that are based on this tag key definition are removed from resources.

      When the tag removal process is finished, the tag key definition status changes to Deleted.

  • Use the oci iam tag delete command and required parameters to delete a tag key definition.

    Example:

    oci iam tag delete --tag-name text --tag-namespace-id tag_namespace_OCID

    For a complete list of CLI commands, flags, and options, see the Command Line Reference.

  • Use the DeleteTag operation to delete a tag key definition.

    For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.