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.
- 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.
- Look for Oracle Cloud Infrastructure Object Storage Classic.
- 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.
- 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. - Metered subscription:
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
andbar
can be the same or different values, and can include one or more hyphens
- The service name would be
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.
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, USserviceInstanceName
is the customer-specified name of the service instance.
Examples:
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
andbar
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
- Metered subscription:
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 aStandard
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.