Oracle Cloud Infrastructure Documentation

Understanding Object Storage Namespaces

namespace serves as the top-level container for all buckets and objects. At account creation time, each tenant is assigned one unique system-generated and immutable namespace name. The namespace spans all compartments within a region. You control bucket names, but those bucket names must be unique within a namespace. While the namespace is region-specific, the namespace name itself is the same in all regions.

Important

You cannot customize, change, or request a namespace name change.
Tip

For some older tenancies, the namespace name string might be based on your tenancy name instead of being machine generated. If your namespace was created based on your tenancy name, your namespace uses all lower-case letters (regardless of the presence of capital letters in your tenancy name). When using the API, CLI, or SDKs, do not use capital letters in your namespace name string.

If your tenancy is assigned a namespace name of axaxnpcrorw5, that is your namespace name in all regions. You can create a bucket named MyBucket in US West (Phoenix). You cannot create another bucket named MyBucket in US West (Phoenix). You can, however, create a bucket named MyBucket in Germany Central (Frankfurt). Because the namespace name is unique to a tenant, other customers can create buckets named MyBucket in their own namespaces.

Within a namespace, buckets and objects exist in flat hierarchy, but you can simulate a directory structure to help navigate a large set of objects. See Object Naming Using Prefixes and Hierarchies for details.

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, do the following:

Open the Profile menu (User menu icon) and click Tenancy: <your_tenancy_name>.

Your namespace string is listed under Object Storage Settings.
Note

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"
}
Tip

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.