Amazon S3 Compatibility API Hosted Style Support in Object Storage

Learn how the Object Storage Amazon S3 Compatibility API supports AWS virtual-hosted style URLs.

Oracle Cloud Infrastructure (OCI) now supports the following ways to address objects:

• Path style: URLs have the following format:

  https://<namespace>.compat.objectstorage.<region>.oci.customer-oci.com/<bucket_name>/<object_name>

• Virtual-hosted style: URLs have the following format:

  https://<bucket_name>.vhcompat.objectstorage.<region>.oci.customer-oci.com/<object_name>

  Here, the bucket name is part of the domain name in the URL and only <object_name> is part of the path.

Previously, the Object Storage Amazon S3 Compatibility API only supported the path style using the following format:

https://<namespace>.compat.objectstorage.<region>.oci.customer-oci.com/<bucket_name>/<object_name>

where <namespace> represents the Object Storage namespace that serves as the top-level container for all buckets and objects.

When your OCI account is created, each OCI tenant is assigned one unique system-generated and immutable Object Storage namespace name. The namespace spans all compartments across all regions. Bucket names must be unique within a namespace. While the namespace is region-specific, the namespace name itself is the same in all regions.

OCI has added support for virtual-hosted style access, allowing you to include the bucket name as part of the subdomain in the URL. You can use virtual-hosted style URLs with the new endpoint when accessing Object Storage with the AWS SDK:

https://<bucket_name>.vhcompat.objectstorage.<region>.oci.customer-oci.com/<object_name>

Consider the following to understand the behavior of buckets:

• Buckets created with the virtual-hosted style URL are guaranteed to be unique across all tenants within the region.
• You can't create a bucket with a name that's already in use within the same region using the virtual-hosted style URL.
• You can still use the path-style URL to access existing buckets, as support for path-style access will continue.
• Bucket names must contain only lowercase letters, numbers, and hyphens.
• Bucket names can't begin with a hyphen character and can't contain consecutive hyphen characters.
• Bucket names must be a minimum of 3 characters long and a maximum of 63 characters long.
• The bucket name acts as a subdomain, so it must also follow standard DNS naming rules.
• If you have existing buckets created with a path-style URL then the bucket name must not already be in use by tenants across the region and the bucket scope must be updated to REGION. For more information, see Updating a Bucket to Support Virtual-hosted Style URLs.

The following table shows the bucket access: