Understanding Object Storage Namespaces

Each Oracle Cloud Infrastructure tenant is assigned an Object Storage namespace that spans all compartments within a region. The namespace is a unique and uneditable system-generated string assigned during account creation and applies to all regions. For some older tenancies, the namespace string might be the tenancy name in all lower-case letters.

The Object Storage namespace serves as a container for all of your buckets and objects. You control bucket names within your namespace, however, bucket names must be unique within each region. You can have a bucket named MyBucket in US West (Phoenix) and a bucket named MyBucket in Germany Central (Frankfurt).

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 Profile menu (User menu icon) and click Tenancy: <your_tenancy_name>.

Your namespace string is listed under Object Storage Settings.

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)

Run the following command get your Object Storage namespace:

oci os ns get

Your Object Storage namespace is returned:

    "data": "MyNamespace"

You can use -ns, --namespace, or --namespace-name for CLI commands 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 the Command Line Reference.

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. If you have the OBJECTSTORAGE_NAMESPACE_READ permission and supply the compartment or tenancy OCID in the optional compartmentId parameter, you can also get the namespace of a different tenancy's Object Storage namespace.