Accessing Oracle Storage Cloud Service

Accessing Oracle Storage Cloud Service Using the Web Console

  1. Sign in to the Oracle Cloud My Services application at https://cloud.oracle.com/sign-in.

    See Signing In to the My Services Application in Managing and Monitoring Oracle Cloud.

    The Oracle Cloud My Services Dashboard page is displayed.

  2. Click the dashboard menu button near the upper left corner of the page.

    The CLOUD SERVICES menu is displayed.

  3. Select Storage.

    The Oracle Storage Cloud Service console is displayed.

Alternatively, click Storage in the Oracle Cloud My Services Dashboard page. Select Open Service Console from the Actions Select any of the actions displayed to perform the relevant corresponding activity. menu.

Accessing Oracle Storage Cloud Service Using the REST API

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:

  • cURL — cURL is a command-line tool that you can use to invoke REST API calls by sending HTTP requests.

    To use cURL, see http://curl.haxx.se and the tutorial, Installing cURL on Cygwin on Windows.

  • Web browsers — Support varies across vendors. Some browser plugins may be needed for full support.

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.

About REST URLs for Oracle Storage Cloud Service Resources

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 REST API endpoint in the Oracle Cloud My Services page is the global namespace URL. You can find the REST API endpoint in the Oracle Cloud My Services page, under the Additional Information section, in the REST Endpoint field.

URL for the Account

The URL for the account is also the REST API endpoint of the service instance.

To find the REST Endpoint URL of your Oracle Storage Cloud Service 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 Storage Cloud Service.
  3. Select View Details from the Actions menu. Alternatively, click the Oracle Storage Cloud Service link on the Dashboard page.

    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.

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

    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.

In the global namespace URL and 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 Storage Service,

  • 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, U.S.A. and us6 for Ashburn, Virginia, U.S.A.
  • serviceInstanceID 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 accounts: 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 accounts: https://us2.storage.oraclecloud.com/v1/myservice-bar-23
  • URL in early releases of Oracle Storage Cloud Service:
    • Metered subscription: https://storage.us2.oraclecloud.com/v1/Storage-myIdentity3
    • Nonmetered subscription: https://storage.us2.oraclecloud.com/v1/myservice-bar-23

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

Note:

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, 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.

Accessing Oracle Storage Cloud Service Using the Java Library

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 archive containers by using the Java API.

To use the Java library in your own Java applications:

  1. Download the Oracle Storage Cloud Service Java SDK from: http://www.oracle.com/technetwork/topics/cloud/downloads/cloud-service-java-sdk-2121032.html
  2. Extract the Java library's classes and runtime dependencies somewhere onto your Java application's class path.
  3. Import the Java library's classes and interfaces into your Java application.
For information about using the Java library to perform specific operations for containers and objects, see Managing Containers in Oracle Storage Cloud Service and Managing Objects in Oracle Storage Cloud Service.

Accessing Oracle Storage Cloud Service Using Oracle Storage Cloud Software Appliance

Oracle Storage Cloud Software Appliance is a tool that you can install on-premises and then use to easily connect your on-premises applications and workflows to Oracle Storage Cloud Service.

Using Oracle Storage Cloud Software Appliance, your applications can interact with Oracle Storage Cloud Service through standard file-based network protocols, without invoking direct REST API calls to the service.

For information on the list of tasks that you can perform in your Oracle Storage Cloud Service account using Oracle Storage Cloud Software Appliance, see Tasks Supported by the Interfaces of Oracle Storage Cloud Service.

Accessing Oracle Storage Cloud Service Using File Transfer Manager API

File Transfer Manager API is a Java library that provides a simple interface to upload or download individual and multiple objects of various sizes to standard and archive containers in Oracle Cloud Storage Service.

To use the FTM API:
  1. Download the SDK from http://www.oracle.com/technetwork/topics/cloud/downloads/file-transfer-manager-2956858.html.
  2. Extract the SDK and include the Java libraries from libs folder into the class path of your Java application.
  3. Import the Java classes and interfaces into your Java application. Before you import, see the sample code from the samples folder in the SDK.

Accessing Oracle Storage Cloud Service Using the FTM CLI

The Oracle Storage Cloud File Transfer Manager CLI (FTM CLI) is a cross-platform Java-based command line tool that you can use to upload and download objects to standard and archive containers in Oracle Storage Cloud Service.

Accessing Objects in Oracle Storage Cloud Service Using Temporary URLs

Temporary URLs are time-limited URLs that expire after a configured time period. You can create temporary URLs to provide secure, temporary access to protected resources like objects in your Oracle Storage Cloud Service account. Users who do not have access to Oracle Storage Cloud Service can download an object from the service using a temporary URL that you provide.