REST API for Oracle SOA Cloud Service on Oracle Public Cloud Machine

Quick Start

Set up your environment and create your first instance of Oracle SOA Cloud Service on Oracle Public Cloud Machine using the REST API by performing the tasks described below.

Prerequisites

First, ensure that you have completed the prerequisite tasks.

This table describes the prerequisite tasks.

Prerequisite	More Information
Create an SSH public/private key pair	Creating SSH Keys for Use with Oracle Cloud Services (tutorial) Accessing a VM Through Secure Shell (SSH) in Using Oracle SOA Cloud Service
Obtain connection details to a database	Contact your account administrator for the following: Connection string to a database in one of the following formats: `host:port:SID` or `host:port/PDB_Name` User name for the database administrator Password for the database administrator
Obtain connection details to an external backup storage disk	Contact your account administrator for the URI to a remote networked disk share in one of the following formats: `host_name:absolute_path_to_remote_backup_disk` `host_ip:absolute_path_to_remote_backup_disk`
Obtain database network and public access network details	Contact your account administrator for the following networks: Public Access Network: Path to the network that will be used to access the service instance, in the format `/tenant_name/public/EoIB_vNet_name`. Database Network: Path to the network through which the service instance will access the database that contains the Oracle Fusion Middleware component schemas. For example, `/mytenant/public/IPoIB_dbaccess`.

Main Tasks

Next, perform the following tasks to create your first Oracle SOA Cloud Service instance using the REST API.

This table describes the main tasks.

Main Task	More Information
Obtain the appropriate account credentials from your account administrator.	Obtain Account Information
Install cURL, the open source, command-line tool for transferring data with URL syntax, supporting various protocols including HTTP and HTTPs. The examples within this document use cURL to demonstrate how to access the Oracle SOA Cloud Service REST API.	Install cURL
Create the request document, in JSON format, to define the details of your create service instance request.	Create the Request Document
Create your first Oracle SOA Cloud Service instance, passing the request document defined previously.	Create Your First Service Instance
After the service instance is created, view the service instance details.	Review the Details of Your First Service Instance