Oracle Cloud Infrastructure Documentation

Understanding Object Storage Namespaces

Each Oracle Cloud Infrastructure tenant is assigned one unique and uneditable Object Storage namespace that spans all compartments within a region. The Object Storage namespace serves as a top-level container for all buckets and objects and lets you control bucket naming within your tenancy. Bucket names must be unique within the context of a namespace, but bucket names can be repeated across namespaces or across regions.

The Object Storage namespace is a system-generated string assigned during account creation. Note that for some older tenancies, the namespace string may be the tenancy name in all lower-case letters.

The namespace metadata stores the default compartment assignments for the Amazon S3 Compatibility API and the Swift API. For more information, see Viewing and Specifying Designated Compartments.

Using the Console

To view your Object Storage namespace string:

Open the User menu (User menu icon) and click Tenancy: <your_tenancy_name>. Your namespace string is listed under Object Storage Settings.

Note

Object Storage Namespace Is Not Editable

While the Object Storage namespace string is displayed under Object Storage Settings, you cannot edit the namespace string. The namespace string appears here for information only.

Using the Command Line Interface (CLI)

Open a command prompt and run the following command to get your Object Storage namespace:

oci os ns get

Tip

You can use -ns, --namespace, or --namespace-name for options that require you to specify the Object Storage namespace string.

For information about using the CLI, see Command Line Interface (CLI). For a complete list of flags and options available for CLI commands, see CLI Help.

Using the API

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.

Use the GetNamespace operation to get your Object Storage namespace. You can also get the namespace of a different tenancy's Object Storage namespace if you have the OBJECTSTORAGE_NAMESPACE_READ permission and supply the compartment or tenancy OCID in the optional compartmentId parameter.