Cloud Documentation
Advanced Search


Using Oracle Storage Cloud Service
Close Window

Table of Contents

Show All | Collapse

Using REST URLs with Oracle Storage Cloud Service

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

The following is the format of your Oracle Storage Cloud Service instance's REST API endpoint:

https://storage.data-center-code.oraclecloud.com/v1/[service-instance-name]-[identity-domain-name]

  • data-center-code is the identifier of the data center which your service instance has been provisioned to

  • service-instance-name is the name of your service instance, defined at service activation time

  • identity-domain-name is the name of the identity domain which your service instance was provisioned into

For example, assuming the following values:

  • data-center-code = us2

  • service-instance-name = mystorage2

  • identity-domain-name = myidentity3

The service instance's REST API endpoint would be:

https://storage.us2.oraclecloud.com/v1/mystorage2-myidentity3

Note:

A service instance's REST API endpoint can be found on its My Services Applications page, service details, under Service REST Endpoint.

A service instance's REST API endpoint is also the account resource.

Containers are resources within an account. Given the example REST API endpoint above, a container named mycontainer4 would have the following URL:

https://storage.us2.oraclecloud.com/v1/mystorage2-myidentity3/mycontainer4

Objects are resources with a container. Given the example REST API endpoint above, an object named myobject5 would have the following URL:

https://storage.us2.oraclecloud.com/v1/mystorage2-myidentity3/mycontainer4/myobject5

For more information about specific operations on containers, see Creating Containers, Deleting Containers, and Updating Container Metadata. For more information about specific operations on objects, see Managing Objects in Oracle Storage Cloud Service.