Quick Start
Set up your environment and create your Oracle Data Hub Cloud Service using the REST API by performing the following tasks.
Prerequisites
Prerequisite | More Information |
---|---|
Learn about Oracle Cloud. | See Getting Started with Oracle Cloud for information about Oracle Cloud. |
Step 1: Obtain Account Information
The account creation e-mail from Oracle contains the identity domain name, user name, and password for your Oracle Data Hub Cloud Service instance. If you do not have this information, then contact your service administrator.
Step 2: Install cURL
Examples within this documentation use cURL to send and receive requests from the Oracle Data Hub Cloud Service.
-
Installing cURL, see Install cURL.
-
Authentication, see Authentication.
Step 3: Understand the Format of Resource URLs
-
See Send Requests.
-
You are now ready to start interacting with the Oracle Data Hub Cloud Service REST API.
Step 4: Execute your first REST API call using cURL
This assumes everything is set up, and that you already created a Oracle Data Hub Cloud Service instance.
curl -I -X GET \ -u "myusername:mypassword" \ -H "X-ID-TENANT-NAME: {identityDomainId}" \ -H "Accept: application/json" \ https://rest_server_url/paas/api/v1.1/instancemgmt/{identityDomainId}/services/cs/instances
-
myusername:mypassword
is the user name and password associated with the account, separated by a colon. -
{identityDomainId}
is the identity domain (tenant) associated with the account, which you enter when logging into the cloud. -
https://rest_server_url
is provided by your setup, as described in Send Requests.
The above will output the response header and response body, and provide information about all Oracle Data Hub Cloud Service instances associated to the account and domain id. Output will look similar to:
server: Oracle-Application-Server-11g x-oracle-dms-ecid: 005FeC1q_mm3n355RvFCvd0004t91103mD x-oracle-dms-ecid: 005FeC1q_mm3n355RvFCvd0004t91103mD x-frame-options: DENY content-language: en content-type: application/json vary: user-agent date: Wed, 12 Dec 2016 23:05:02 GMT content-length: 11274 {"services":{ "MyTestInstance":{ "serviceId":64381, "serviceName":"MyTestInstance", "serviceType":"cs", "domainName":"mydomain", "serviceVersion":"16.4", ...
Note:
The response header text was included because-i
was passed into the cURL command. Remove
-i
to only see the body response (JSON).