Quick Start

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

All documentation is applicable to using the REST API on any deployment option of Oracle Cloud unless otherwise indicated.

Using best practices will ensure that your Oracle SOA Cloud Service instances remain compatible with all product features. See About Managing Oracle SOA Cloud Service Instances in Administering Oracle SOA Cloud Service.

Account Information

The account creation e-mail you received from Oracle Cloud contains the identity domain, user name, and password for your Oracle SOA Cloud Service account. If you do not have this information, contact your Oracle Cloud account administrator or service administrator. See also Obtain Account Information.

Required Oracle Cloud Roles

Oracle SOA Cloud Service uses roles to control access to tasks and resources. When your cloud account is first set up, the service administrator is given the SOA Administrator role along with additional service roles that are required to work with Oracle SOA Cloud Service. See About Oracle SOA Cloud Service Roles and User Accounts in Administering Oracle SOA Cloud Service.

Prerequisites

Before you create your first Oracle SOA Cloud Service instance, ensure that you have completed the prerequisite tasks.

Prerequisite	More Information
Create an SSH public/private key pair	Creating SSH Keys for Use with Oracle Cloud Services (tutorial) Access a VM Through a Secure Shell (SSH) in Administering Oracle SOA Cloud Service
(Does not apply to Oracle Cloud Infrastructure) Create an object storage container for your Oracle SOA Cloud Service instance backups	(Does not apply to Oracle Cloud Infrastructure) If using new subscriptions, be sure to set a replication policy for your Oracle Cloud Infrastructure Object Storage Classic before you create the first container. See Creating Containers in Using Oracle Cloud Infrastructure Object Storage Classic or Creating Containers Using the REST API (tutorial). Creating an object storage container before creating your Oracle SOA Cloud Service instance is optional. If you do not create a container before you create your service instance, you can set the boolean parameter createStorageContainerIfMissing to true in your request, and specify a container name that does not yet exist. This enables the provisioning system to create the container for you before it provisions the service instance.
Create database deployments in Oracle Database Cloud Service to host the: Oracle Infrastructure schemas required by Oracle Java Required Files (JRF) (Optional) Application schemas	Oracle SOA Cloud Service requires access to an existing relational database that contains the standard Oracle Infrastructure schema. Create an Oracle Database Cloud Service database deployment for storing the required database schema for your Oracle SOA Cloud Service instance.
(Does not apply to Oracle Cloud Infrastructure) Create IP networks. This is optional for accounts where regions are supported.	(Does not apply to Oracle Cloud Infrastructure) Using an IP network gives you more control over the configuration of the network in which your Oracle SOA Cloud Service instance is placed. If you specify an IP network, each underlying VM is auto-assigned a public and private IP address. When you specify an IP network during provisioning, you must also specify a database deployment on Oracle Database Cloud Service that is on an IP network. If your Oracle SOA Cloud Service and Oracle Database Cloud Service are attached to different IP networks, then the two IP networks must be connected to the same IP network exchange. Access rules required for the communication between the Oracle SOA Cloud Service instance and Oracle Database Cloud Service database deployment are created automatically. See Creating an IP Network in Using Oracle Cloud Infrastructure Compute Classic.
(Does not apply to Oracle Cloud Infrastructure) Create reserved IP addresses. This is optional for accounts where regions are supported.	(Does not apply to Oracle Cloud Infrastructure) A consequence of using an IP network is that the auto-assigned IP address could change each time the service instance is started. To assign fixed public IP addresses to service instances attached to the IP network, you can create reserved IP addresses, then provision a service instance that uses persistent IP addresses. See IP Reservations REST Endpoints.
(Applies only to Oracle Cloud Infrastructure) Set up a virtual cloud network and subnets Create an object storage bucket to store your Oracle SOA Cloud Service instance backups Set up IAM policies to allow Oracle SOA Cloud Service to access the network and object storage resources Create a Swift password to use with the object storage service	(Applies only to Oracle Cloud Infrastructure) See Prerequisites for Oracle Platform Services on Oracle Cloud Infrastructure in the Oracle Cloud Infrastructure documentation.

Main Tasks

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

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.	Provision a New Service Instance