You can access Oracle Storage Cloud Service using either the RESTful web service API or the Java library.
The REST API can be accessed from any application or programming platform that correctly and completely understands the Hypertext Transfer Protocol (HTTP) and has Internet connectivity. The REST API uses advanced facets of HTTP such as secure communication over HTTPS, HTTP headers, and specialized HTTP verbs (PUT, DELETE).
Some applications that meet these requirements are:
Many programming platforms (Java, Ruby, Perl, PHP, .NET, and so on) also meet these requirements, although some may require the use of third party libraries for full support. See your programming platform's documentation for guidance.
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).
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.
The My Services dashboard is displayed. It lists the services that are assigned to your account.
On the resulting page, the details of your Oracle Storage Cloud Service instance are displayed. The URL is displayed in the REST Endpoint field under the Additional Information section.
Note:If your client applications use a URL from an early release of Oracle Storage Cloud Service, you can update the applications to use the global namespace URL.
identityDomainNameis the identity domain in which the service instance is provisioned.
dataCenterCodeis the identifier of the data center in which the service instance is provisioned. For example,
dataCenterCodeis us2 for the data center in Chicago, Illinois, U.S.A. and us6 for Ashburn, Virginia, U.S.A.
serviceInstanceNameis the customer-specified name of the service instance.
myStorage2that is provisioned in the
myIdentity3domain in the
us2data center, the REST API endpoint URLs would be:
foo part in this example would be different for each account.
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
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
Note:These URLs are valid for any object in a
Archivecontainer. To restore an object in an
Archivecontainer and to track the progress of the restoration, the URL for an object named
myArchiveContainer5container would be
https://foo.storage.oraclecloud.com/v0/Storage–myIdentity3/myArchiveContainer5/myObject5. Note the
v0API version in the URL.
The Java library uses the REST API. So the Java library, too, requires Internet connectivity.
The Java library requires Java Runtime Environment (JRE) version 1.6 or later. The Java library has several runtime-dependent Java libraries, all of which are included in the downloadable Java SDK.
Note:You cannot create
archivecontainers by using the Java API.
To use the Java library in your own Java applications: