Send Requests

Accounts, containers, and objects in an Oracle Cloud Infrastructure Object Storage Classic instance are represented as REST resources and are accessible through HTTP uniform resource locators (URLs).

URL for the Account

The URL for the account is also the REST API endpoint of the service instance. You can find the REST API endpoint in the Oracle Cloud My Services page, under the Additional Information section, in the REST Endpoint field.

To find the REST Endpoint URL of your Oracle Cloud Infrastructure Object Storage Classic instance:
  1. Sign in to the Oracle Cloud My Services application.

    The My Services dashboard is displayed. It lists the services that are assigned to your account.

  2. Look for Oracle Cloud Infrastructure Object Storage Classic.
  3. Select View Details from the Actions menu. Alternatively, click the Oracle Cloud Infrastructure Object Storage Classic link on the Dashboard page.

    On the resulting page, the details of your Oracle Cloud Infrastructure Object Storage Classic instance are displayed. The URL is displayed in the REST Endpoint field under the Additional Information section.

The URL for the Oracle Cloud Infrastructure Object Storage Classic REST API endpoint is in one of the following formats:
  • Global namespace URL for all customers: This is the URL that you see in My Services.
  • Data center-specific URL for all customers: https://dataCenterCode.storage.oraclecloud.com/v1/myservice-bar
  • URL in early releases of Oracle Cloud Infrastructure Object Storage Classic:
    • Metered subscription: https://storage.dataCenterCode.oraclecloud.com/v1/Storage-identityDomainID
    • Nonmetered subscription: https://storage.dataCenterCode.oraclecloud.com/v1/serviceInstanceName-identityDomainID

    Note:

    If your client applications use a URL from an early release of Oracle Cloud Infrastructure Object Storage Classic, you can update the applications to use the global namespace URL.

In the global namespace URL and the data center-specific URL formats,

  • The service name is the character string after v1/ in the REST endpoint URL, up to (but excluding) the first hyphen. Say the REST API endpoint URL for your service instance is:

    https://foo.storage.oraclecloud.com/v1/myservice-bar-23

    In this example:
    • The service name would be myservice
    • The service instance ID would be myservice-bar-23
    • foo and bar can be the same or different values, and can include one or more hyphens
  • dataCenterCode is the identifier of the data center in which the service instance is provisioned. For example, dataCenterCode is us2 for the data center in Chicago, Illinois, U.S.A. and us6 for Ashburn, Virginia, U.S.A.
In the URL formats used in the early releases of Oracle Cloud Infrastructure Object Storage Classic,
  • identityDomainID is the identity domain in which the service instance is provisioned.
  • dataCenterCode is the identifier of the data center in which the service instance is provisioned. For example, dataCenterCode is us2 for the data center in Chicago, Illinois, US and us6 for Ashburn, Virginia, US
  • serviceInstanceName is the customer-specified name of the service instance.

Examples:

For example, for a service instance named myservice-bar-23 that is provisioned in the myIdentity3 domain ID in the us2 data center, the REST API endpoint URLs would be:
  • Global namespace URL for all customers: https://foo.storage.oraclecloud.com/v1/myservice-bar-23

    The foo and bar parts in this example would be different for each account.

  • Data center-specific URLs for all customers: https://us2.storage.oraclecloud.com/v1/myservice-bar-23
  • URL in early releases of Oracle Cloud Infrastructure Object Storage Classic:
    • Metered subscription: https://storage.us2.oraclecloud.com/v1/Storage-myIdentity3
    • Nonmetered subscription: https://storage.us2.oraclecloud.com/v1/myservice-bar-23-myIdentity3

URLs for Containers

Containers are resources within an account.

Given the sample global namespace REST API endpoint URL above, the URL for a container named myContainer4 would be https://foo.storage.oraclecloud.com/v1/myservice-bar-23/myContainer4

URLs for Objects

Objects are resources within containers.

Given the sample global namespace REST API endpoint URL above, the URL for an object named myObject5 in the myContainer4 container would be https://foo.storage.oraclecloud.com/v1/myservice-bar-23/myContainer4/myObject5

Important:

These URLs are valid for any object in a Standard or Archive container. To restore an object in an Archive container and to track the progress of the restoration job, the URL for an object named myObject5 in the myArchiveContainer5 container would be https://foo.storage.oraclecloud.com/v0/myservice-bar-23/myArchiveContainer5/myObject5. Note the v0 API version in the URL.

Supported Methods

You can perform basic CRUD operations (create, read, update, and delete) on Oracle Cloud Infrastructure Object Storage Classic using standard HTTP method requests, as summarized in the following table.

HTTP Method Description
GET Retrieve information about the account, a container, or an object.
HEAD Retrieve header information about the account, a container, or an object.
POST Create, update, or delete metadata for the account, a container, or an object
PUT Create a container or an object, or replace an object.
DELETE Delete a container or object.

Supported Headers

For a list of the headers that you can pass with a specific HTTP request, see the section that describes that request method.