1. REST API for Oracle Application Container CloudREST API for Managing Application Caches
  2. Quick Start

Quick Start

Set up your environment and create your first application cache on Oracle Application Container Cloud using the REST API by performing the following tasks.

Step 1: Obtain Account Information

From your account administrator, obtain the appropriate account credentials to enable you to use the Oracle Application Container Cloud. Specifically, you will need:

  • Username and password

  • The URL of your Oracle Application Container Cloud instance, which is listed in the welcome email you receive with your trial or purchased subscription.

  • The identity domain for your subscription to Oracle Application Container Cloud.

Step 2: Install cURL

You can use the cURL command-line tool to access the REST API for Managing Application Caches.

To install cURL:

  1. In your browser, navigate to the cURL Home Page.

  2. Locate the SSL-enabled version of the cURL software that corresponds to your operating system, download the ZIP file, and install the software.

Step 3: Create a Cache

The following example shows how to create a cache by submitting a POST request using cURL. First you need a payload file such as this one, named create-cache.json: 

{
   "serviceParameters":{
      "deploymentType":"Basic",
      "serviceDescription":"Cache creation example",
      "serviceLevel":"PAAS",
      "serviceName":"MyCache",
      "serviceVersion":"1.0",
      "size":"1",
      "subscription":"HOURLY"
   }
}

The cURL command references the payload file:

curl -i -X POST -u joe@example.com:joePassword \
 -H "X-ID-TENANT-NAME:ExampleIdentityDomain" \
 -H "Content-Type:application/vnd.com.oracle.oracloud.provisioning.Service+json" \
 -d @create-cache.json \
  https://apaas.us.oraclecloud.com/paas/api/v1.1/instancemgmt/ExampleIdentityDomain/services/caching/instances

Step 4: Review the Details of Your First Cache

The following example shows how to view the details of a cache by submitting a GET request on the REST resource using cURL:

curl -i -X GET -u joe@example.com:joePassword \
 -H "X-ID-TENANT-NAME:ExampleIdentityDomain" \
  https://apaas.us.oraclecloud.com/paas/api/v1.1/instancemgmt/ExampleIdentityDomain/services/caching/instances/MyCache