API Catalog Cloud Service

REST APIs for Oracle Cloud Services are available from
https://apicatalog.oraclecloud.com

Private Cloud : Database as a Service REST API Cookbook

The following document provides direction and requirements for the execution of a Database as a Service specific to the use of the REST API provided with the Cloud Pack for Oracle Database :
http://www.oracle.com/technetwork/oem/cloud-mgmt/dbaas-api-cookbook-030116-2925990.pdf

Oracle API Catalog Cloud Service

Oracle API Catalog Cloud Service is a collection of machine-readable (Swagger 2.0) API descriptions exposed by Oracle’s most popular SaaS and PaaS applications.

You can use these descriptions to generate code stubs, this facilitating integration between your applications and others in the Oracle Public Cloud.

DBCS REST API

Oracle DBCS REST API is officially out!
Using this API, you can create and manage Database Cloud Service instance :
http://docs.oracle.com/cloud/latest/dbcs_dbaas/CSDBI/GUID-E33EB53B-B3AC-46B8-A2D2-695A03850733.htm#CSDBI-GUID-E33EB53B-B3AC-46B8-A2D2-695A03850733

How to remove a JCS Instance using REST APIs?

The following example shows how to delete an Oracle Java Cloud Service instance using cURL :

curl -i -X PUT u user:password
-d '{ "dbaName": "SYSTEM", "dbaPassword": "system_pwd","forceDelete": true}'
-H "Content-Type:application/json"
-H "X-ID-TENANT-NAME:IdentityDomain"
https://jaas.oraclecloud.com/jaas/api/v1.1/instances/IdentityDomain/JCS_Instance_Name

REST APIs provides an alternative to using the web-based user interface to create and manage Oracle Java Cloud Service instances.

For more information: http://docs.oracle.com/cloud/latest/jcs_gs/JSRMR/toc.htm 

How to create a DBCS Instance using REST APIs? (Part 2)

To create an Oracle Database Cloud Service instance 12c, modify the previous script as below :

{

"serviceName": "DB12c-EE-REST",

"version": "12.1.0.2",

"level": "PAAS",

"edition": "EE",

"subscriptionType": "HOURLY",

"description": "DBCS REST TEST",

"shape": "oc3",

"parameters": [

{

"type": "db",

"usableStorage": "10",

"adminPassword": "Manager12#",

"sid": "ORCL",
"pdb": "PDB1",

"failoverDatabase": "no",

"backupDestination": "BOTH",

"cloudStorageContainer": "Storage-froraclejpp/backup_container",

"cloudStorageUser": "jpp_user",

"cloudStoragePwd": " JPP_PASSWORD "

}

],

"vmPublicKeyText": "ssh-rsa AAAAB3NzaC1yc2EAAAABJ= rsa-key-20150105"

}

How to remove a DBCS Instance using REST APIs?

The following example shows how to delete an Oracle Database Cloud Service instance using cURL :

curl -X DELETE
-H "X-ID-TENANT-NAME: IdentityDomain"
-u user:password
https://dbaas.oraclecloud.com/jaas/db/api/v1.1/instances/IdentityDomain/DBCS_Instance_Name

How to create a DBCS Instance using REST APIs?

The following shows how to create an Oracle Database Cloud Service instance 11g using the REST API:

1.Create a JSON script (createDB.json)
This document defines the details of the service instance.
For example : 

 {

"serviceName": "DB11g-EE-REST",

"version": "11.2.0.4",

"level": "PAAS",

"edition": "EE",

"subscriptionType": "HOURLY",

"description": "DBCS REST TEST",

"shape": "oc3",

"parameters": [

{

"type": "db",

"usableStorage": "10",

"adminPassword": "Manager12#",

"sid": "ORCL",
"failoverDatabase": "no",

"backupDestination": "BOTH",

"cloudStorageContainer": "Storage-froraclejpp/backup_container",

"cloudStorageUser": "jpp_user",

"cloudStoragePwd": " JPP_PASSWORD "

}

],

"vmPublicKeyText": "ssh-rsa AAAAB3NzaC1yc2EAAAABJ= rsa-key-20150105"
} 


2. Invoke the script 

curl -i -X POST -u user:password
-d @createDB.json
-H "X-ID-TENANT-NAME: IdentityDomain"
-H "Content-Type:application/json"
https://dbaas.oraclecloud.com/jaas/db/api/v1.1/instances/IdentityDomain


3. Check the creation process from the DBCS Overview page 

4. The new DBCS Instance is now Up and Running

 

How to create a JCS Instance using REST APIs?

The following shows how to create an Oracle Java Cloud Service instance using the REST API:

1.Create a JSON script (create.json)
This document defines the details of the service instance.
For example :

{

"serviceName" : "JCSRESTInstance",

"level" : "PAAS",

"subscriptionType" : "HOURLY",

"description" : "Example - REST APIs",

"provisionOTD" : false,

"cloudStorageContainer" : "Storage-froraclejpp/wls_container",

"cloudStorageUser" : "jpp_user",

"cloudStoragePassword" : "JPP_PASSWORD",

"parameters" : [

{

"type" : "weblogic",

"version" : "12.1.3.0.2",

"edition" : "EE",

"domainMode" : "PRODUCTION",

"managedServerCount" : "2",

"adminPort" : "7001",

"deploymentChannelPort" : "9001",

"securedAdminPort" : "7002",

"contentPort" : "7003",

"securedContentPort" : "7004",

"domainName" : "ExampleDomain",

"clusterName" : "ExampleCluster",

"adminUserName" : "weblogic",

"adminPassword" : "OracleM12#",

"nodeManagerPort" : "6555",

"nodeManagerUserName" : "nodeMangerAdmin",

"nodeManagerPassword" : "Manager12#",

"dbServiceName" : "JPP-DB12c-EE",

"dbaName" : "SYS",

"dbaPassword" : "OracleM12#",

"shape" : "oc3",

"domainVolumeSize" : "10G",

"backupVolumeSize" : "50G",

"VMsPublicKey" : "ssh-rsa AAAAB3NzaC1yc2EAAAABJ= rsa-key-20150105"

}

]

}

2. Invoke the script

curl -i -X POST -u user:password
-d @create.json -H "Content-Type:application/vnd.com.oracle.oracloud.provisioning.Service+json"
-H "X-ID-TENANT-NAME:IdentityDomain"
https://jaas.oraclecloud.com/jaas/api/v1.1/instances/IdentityDomain

3. Check the creation process from the JCS Overview page

4. the new JCS Instance is now Up and Running

Chrome Advanced REST Client

Advanced REST Client for Chrome offers a simple and easy way to test REST applications.

1. Go to Chrome Web Store to install this application
2. Add a new header "Authorization" and then click on "Construct" button

3. Add user and password



4. Send the form (using POST method)

5. Type your request; for example to obtain the list of containers available