Accessing Object Storage Classic

Accessing Oracle Cloud Infrastructure Object Storage Classic Using the Web Console

Not Oracle Cloud at Customer This topic does not apply to Oracle Cloud at Customer.

  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 Cloud Infrastructure Object Storage Classic 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 Cloud Infrastructure Object Storage Classic 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.

  • 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 Cloud Infrastructure Object Storage Classic Resources

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

The REST API endpoint in the Oracle Cloud My Services page is the global namespace URL.

Note:

Depending on when your account was created, you may find multiple REST API Endpoint URLs for your account.

REST Endpoint URL Formats in Oracle Cloud Accounts

When you sign in to your Oracle Cloud account, you’ll have access to the following types of Cloud accounts:
  • Cloud accounts with Identity Cloud Service
  • Traditional Cloud accounts (also known as Cloud Service accounts)

To know more about the types of Oracle Cloud accounts, see Types of Oracle Cloud Accounts.

The following table describes the REST Endpoint URL formats in Oracle Cloud accounts.

See Using Your Account Details to access your account using your sign-in credentials.

Finding the REST Endpoint URL for Your Cloud Account

The REST Endpoint URL is also the URL for the account.

To find the REST Endpoint URL of your Oracle Cloud Infrastructure Object Storage Classic account:

  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 Storage Classic.
  3. Select View Details from the Actions menu. Alternatively, click the Storage Classic link on the Dashboard page.
    On the resulting page, the details of your Oracle Cloud Infrastructure Object Storage Classic account are displayed.
    • For accounts created before November 2017

      The URL is displayed in the REST Endpoint field under the Additional Information section.

    • For accounts created after November 2017

      The following REST Endpoint URLs are displayed under the Additional Information section.

      REST Endpoint URL Type Description When to Use? Example
      Service Permanent REST Endpoint URL This URL is displayed in the REST Endpoint (Permanent) field.

      This URL contains the auto-generated GUID for the account and remains constant for your account.

      Use this REST Endpoint URL:
      • To set a replication policy for a container in your account.

        See Setting a Container-Specific Policy Using the REST API.

      • To ensure that the URL remains constant under all circumstances.

        For example, you can hard-code the permanent URL in your code scripts to perform any operation on the Storage Classic resources.

      .
      https://storage-7b16fede61e1417ab83eb52e06f0e365.storage.oraclecloud.com/v1/Storage-7b16fede61e1417ab83eb52e06f0e365
      Service Friendly REST Endpoint URL This URL is displayed in the REST Endpoint field.

      Note:

      If you change the Storage Classic account name, then the Service Friendly REST Endpoint URL and the authentication URL will also change.

      Ensure that you are using the appropriate and latest URL.

      Use this URL to perform any operation on the Storage Classic resources through the desired interface. https://acme.storage.oraclecloud.com/v1/Storage-acme

Using Your Account Details

You’ll need your sign-in credentials to access your account and perform any operation using the desired interface.

When you sign up for the account, you’ll receive a Welcome mail with your sign-in credentials.

Make a note of your sign-in credentials, as shown in the following example:
Description of new_account_information_email-2017.jpg follows
Description of the illustration new_account_information_email-2017.jpg

If you don't have your Welcome mail, ask your account administrator for your sign-in credentials.

Note:

For traditional accounts, you can request Oracle Cloud to send the email to the administrator again. See Resending Welcome Email with Administrator Sign-in Credentials.

REST Endpoint URL Formats in Cloud Accounts with Identity Cloud Service (Created after November 2017)

Make a note of the following details of your account from the Welcome email:
  • IDCS GUID
  • Account name
  • User name
For example - Sample Cloud account with the following details:
  • IDCS GUID: idcs-b75f75ed2528447fb59a798c1f08a38d
  • Account name: acme
  • User name: john.doe@example.com
URL Format
REST Endpoint URLs:
  • Service Permanent REST Endpoint
  • Service Friendly REST Endpoint
Check in the following fields under Additional Information in My Services .
  • REST Endpoint URL (Permanent)

    Format:

    https://storage-GUID.storage.oraclecloud.com/v1/Storage-GUID

    REST Endpoint URL (Permanent) URL for the sample account:

    https://storage-7b16fede61e1417ab83eb52e06f0e365.storage.oraclecloud.com/v1/Storage-7b16fede61e1417ab83eb52e06f0e365

  • REST Endpoint

    Format:

    https://account_name.storage.oraclecloud.com/v1/Storage-account_name

    Service Friendly REST Endpoint URL for the sample account:

    https://acme.storage.oraclecloud.com/v1/Storage-acme

Authentication URL

Check in Auth V1 Endpoint field under Additional Information in My Services .

Format:

https://account_name.storage.oraclecloud.com/auth/v1.0

Note:

If the authentication URL is not available in the My Services page, then you must construct the authentication URL. See Authenticating Access to Object Storage Classic.

Auth URL for the sample account:

https://acme.storage.oraclecloud.com/auth/v1.0

Example: cURL command and output - Authentication token request for the above sample Cloud account

cURL command:

  • Using the account name in the header X-Storage-User:

    curl -v -X GET -H "X-Storage-User: Storage-acme:john.doe@example.com" -H "X-Storage-Pass: Welcome1" http://acme.storage.oraclecloud.com/auth/v1.0

    Output:


    Description of auth-token-idcs-acct-wo-guid.gif follows
    Description of the illustration auth-token-idcs-acct-wo-guid.gif

  • Using the GUID from the Service Permanent REST Endpoint in the header X-Storage-User:

    curl -v -X GET -H "X-Storage-User: Storage-7b16fede61e1417ab83eb52e06f0e365:john.doe@example.com" -H "X-Storage-Pass: Welcome1" http://acme.storage.oraclecloud.com/auth/v1.0

Output:


Description of auth-token-idcs-guid.gif follows
Description of the illustration auth-token-idcs-guid.gif

REST Endpoint URL Formats in Cloud Accounts with Identity Cloud Service (Created before November 2017)

Make a note of the following details of your account from the Welcome email:
  • IDCS GUID
  • Account name
  • User name
For example - Sample Cloud account with the following details:
  • IDCS GUID: idcs-b75f75ed2528447fb59a798c1f08a38d
  • Account name: acme
  • User name: john.doe@example.com
URL Format

REST Endpoint URL

Check in REST Endpoint field under Additional Information in My Services .

Format:

https://account_name.storage.oraclecloud.com/v1/Storage-account_name

REST Endpoint URL for the sample account:

https://acme.storage.oraclecloud.com/v1/Storage-acme

Authentication URL

Check in Auth V1 Endpoint field under Additional Information in My Services .

Format:

https://account_name.storage.oraclecloud.com/auth/v1.0

Note:

If the authentication URL is not available in the My Services page, then you must construct the authentication URL. See Authenticating Access to Object Storage Classic.

Auth URL for the sample account:

https://acme.storage.oraclecloud.com/auth/v1.0

Example: cURL command and output - Authentication token request for the above sample Cloud account

cURL command:

curl -v -X GET -H "X-Storage-User: Storage-acme:john.doe@example.com" -H "X-Storage-Pass: Welcome1" http://acme.storage.oraclecloud.com/auth/v1.0

Output:


Description of auth-token-idcs-acct-wo-guid.gif follows
Description of the illustration auth-token-idcs-acct-wo-guid.gif

REST Endpoint URL Formats in Traditional Accounts (Created after November 2017)

Make a note of the following details of your account from the Welcome email:
  • Identity domain
  • Account name
  • User name
For example - Sample traditional account with the following details:
  • Identity domain: acme
  • Account name: acme
  • User name: john.doe@example.com

Note:

In traditional accounts, the identity domain name and account name are the same.
URL Format
REST Endpoint URLs
  • Service Permanent REST Endpoint
  • Service Friendly REST Endpoint
Check in the following fields under Additional Information in My Services .
  • REST Endpoint URL (Permanent)

    Format:

    https://storage-GUID.storage.oraclecloud.com/v1/Storage-GUID

    REST Endpoint URL (Permanent) URL for the sample account:

    https://storage-7b16fede61e1417ab83eb52e06f0e365.storage.oraclecloud.com/v1/Storage-7b16fede61e1417ab83eb52e06f0e365

  • REST Endpoint

    Format:

    https://account_name.storage.oraclecloud.com/v1/Storage-account_name

    Service Friendly REST Endpoint URL for the sample account:

    https://acme.storage.oraclecloud.com/v1/Storage-acme

Authentication URL

Check in Auth V1 Endpoint field under Additional Information in My Services .

Format:

https://account_name.oraclecloud.com/auth/v1.0

Note:

If the authentication URL is not available in the My Services page, then you must construct the authentication URL. See Authenticating Access to Object Storage Classic.

Auth URL for the sample account:

https://acme.storage.oraclecloud.com/auth/v1.0

Example: cURL command and output - Authentication token request for the above sample traditional account

cURL command:

  • Using the identity domain name in the header X-Storage-User:

    curl -v -X GET -H "X-Storage-User: Storage-acme:john.doe@example.com" -H "X-Storage-Pass: Welcome1" http://acme.storage.oraclecloud.com/auth/v1.0

    Output:


    Description of trad-acct-auth-token-v2.gif follows
    Description of the illustration trad-acct-auth-token-v2.gif

  • Using the GUID from the Service Permanent REST Endpoint in the header X-Storage-User:

    curl -v -X GET -H "X-Storage-User: Storage-7b16fede61e1417ab83eb52e06f0e365:john.doe@example.com" -H "X-Storage-Pass: Welcome1" http://acme.storage.oraclecloud.com/auth/v1.0

Output:


Description of auth-token-idcs-guid.gif follows
Description of the illustration auth-token-idcs-guid.gif

REST Endpoint URL Formats in Traditional Accounts (Created before November 2017)

Make a note of the following details of your account from the Welcome email:
  • Identity domain
  • Account name
  • User name
For example - Sample traditional account with the following details:
  • Identity domain: acme
  • Account name: acme
  • User name: john.doe@example.com

Note:

In traditional accounts, the identity domain name and account name are the same.
URL Format

REST Endpoint URL

Check in REST Endpoint field under Additional Information in My Services .

Format:

https://account_name.storage.oraclecloud.com/v1/Storage-account_name

REST Endpoint URL for the sample account:

https://acme.storage.oraclecloud.com/v1/Storage-acme

Authentication URL

Check in Auth V1 Endpoint field under Additional Information in My Services .

Format:

https://account_name.oraclecloud.com/auth/v1.0

Note:

If the authentication URL is not available under Additional Information, then you must construct the authentication URL. See Authenticating Access to Object Storage Classic.

Auth URL for the sample account:

https://acme.storage.oraclecloud.com/auth/v1.0

Example: cURL command and output - Authentication token request for the above sample traditional account

cURL command:

curl -v -X GET -H "X-Storage-User: Storage-acme:john.doe@example.com" -H "X-Storage-Pass: Welcome1" http://acme.storage.oraclecloud.com/auth/v1.0

Output:


Description of trad-acct-auth-token-v2.gif follows
Description of the illustration trad-acct-auth-token-v2.gif

Accessing Oracle Cloud Infrastructure Object Storage Classic 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 Cloud Infrastructure Object Storage Classic 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 Cloud Infrastructure Object Storage Classic and Managing Objects in Oracle Cloud Infrastructure Object Storage Classic.

Accessing Oracle Cloud Infrastructure Object Storage Classic Using Oracle Cloud Infrastructure Storage Software Appliance

Not Oracle Cloud at Customer This topic does not apply to Oracle Cloud at Customer.

Oracle Cloud Infrastructure Storage 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 Cloud Infrastructure Object Storage Classic.

Using Oracle Cloud Infrastructure Storage Software Appliance, your applications can interact with Oracle Cloud Infrastructure Object Storage Classic 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 Cloud Infrastructure Object Storage Classic account using Oracle Cloud Infrastructure Storage Software Appliance, see Tasks Supported by the Interfaces of Object Storage Classic.

Accessing Oracle Cloud Infrastructure Object Storage Classic 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 Infrastructure Object Storage Classic.

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 Cloud Infrastructure Object Storage Classic Using the FTM CLI

The Oracle Cloud Infrastructure Object Storage Classic 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 Cloud Infrastructure Object Storage Classic.

Accessing Objects in Oracle Cloud Infrastructure Object Storage Classic 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 Cloud Infrastructure Object Storage Classic account. Users who do not have access to Oracle Cloud Infrastructure Object Storage Classic can download an object from the service using a temporary URL that you provide.