1. <ProductName> REST APIREST API for Identity in Oracle Cloud Infrastructure Object Storage Classic
  2. Quick Start

Quick Start

Set up your environment and start creating and managing containers and objects in Oracle Cloud Infrastructure Object Storage Classic using the REST API, by performing the steps described here.

Step 1: Subscribe to the Service

Obtain a trial or paid subscription to Oracle Cloud Infrastructure Object Storage Classic. See How to Begin with Oracle Cloud Infrastructure Object Storage Classic Subscriptions in Using Oracle Cloud Infrastructure Object Storage Classic.

Step 2: Get the Required Roles Assigned

Contact your account administrator and get the required roles assigned to your user name in Oracle Cloud My Services.

  • To be able to create containers, you would need the Storage_Administrator role.

  • To create and manage objects, the Storage_ReadWriteGroup role would suffice.

  • Users with the ReadOnlyGroup role can only get objects and containers.

For more information, see Modifying User Roles in Managing and Monitoring Oracle Cloud.

Step 3: Install cURL

You can access the REST API 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).

cURL, a command-line tool that you can use to invoke REST API calls by sending HTTP requests. The examples in this document use the cURL command-line tool to demonstrate how to access the Oracle Cloud Infrastructure Object Storage Classic REST API.

cURL is typically available by default on most UNIX-like hosts. For the instructions to install cURL on Windows, see the tutorial Installing cURL on Cygwin on Windows.

Note:

Certain web browsers can also be used to send REST API calls. Support varies across vendors. 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.

Step 3: Understand the Format of Resource URLs

See Send Requests.

You're now ready to start interacting with the REST API of Oracle Cloud Infrastructure Object Storage Classic.