Oracle Cloud Infrastructure Documentation

Understanding Object Storage Namespaces

Each Oracle Cloud Infrastructure tenant is assigned one unique and uneditable Object Storage namespace that is global (spanning all regions and compartments). The Object Storage namespace serves as a top-level container for all buckets and objects and allows you to control bucket naming within your tenancy. While bucket names must be unique within your tenancy, your tenancy's bucket names can duplicate the bucket names chosen by other tenants. 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 string.