Oracle Cloud Infrastructure Documentation

Creating a Tag Namespace

Learn how to create a tag namespace on Private Cloud Appliance to group related tags.

After you create a tag namespace in any compartment, that tag namespace is available in every compartment in the tenancy.

A tenancy can have at most 100 tag namespaces.

Tag namespace names have the following characteristics:

  • Must be unique within the tenancy.

  • Are case insensitive.

  • Cannot be changed later.

  • Can be no more than 100 characters.

  • Cannot contain period (.) or space characters.

The tag namespace description can be no more than 256 characters.

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

    2. Select the Create Namespace Definitions button.

    3. In the Create Namespace Definition dialog box, scroll down to the Tagging section and select the Tag Namespace field to verify that the namespace definition name that you plan to use does not already exist in this tenancy.

      If the namespace is listed, then it has already been created in a different compartment and is available to all compartments in the tenancy. You will receive an error message if you try to create this tag namespace when it is already available.

    4. In the Create Namespace Definition dialog box, enter the following information:

      • Compartment: The compartment in which you want to create the namespace definition.

      • Namespace Definition Name: A name for this tag namespace. See the preceding list of characteristics.

      • Description: A description for this set of tags.

      • Tagging: (Optional) Add defined or free-form tags for this tag namespace as described in Adding Tags at Resource Creation. Tags can also be applied later.

    5. Select the Create Namespace Definition button in the dialog box.

      The details page for the new tag namespace definition is displayed.

  • Use the oci iam tag-namespace create command and required parameters to create a new tag namespace.

    Use the following command to verify that the namespace name you plan to use is unique in the tenancy. If the namespace is listed, then it has already been created in a different compartment and is available to all compartments in the tenancy. You will receive an error message if you try to create this tag namespace when it is already available.

    oci iam tag-namespace list --compartment-id tenancy_OCID

    Example:

    oci iam tag-namespace create --compartment-id compartment_OCID --name tag_namespace_name --description "text"

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

  • Use the CreateTagNamespace operation to create a new tag namespace.

    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.