Send Requests

Learn about the structure of requests sent to the Oracle Cloud Stack REST API.

URL

Use the following URL structure to access the REST endpoints:

https://region-prefix.oraclecloud.com/resource-path

Where:

• region-prefix is the URL prefix based on region. Typical values include:

  • United States: psm.us

    For example: https://psm.us.oraclecloud.com/resource-path

  • Europe: psm.europe

    For example: https://psm.europe.oraclecloud.com/resource-path

• resource-path is a relative path that defines the REST endpoint. For a complete list of REST endpoints, see All REST Endpoints.

Methods

Perform basic CRUD operations (create, read, update, and delete) on your cloud stacks and templates by using standard HTTP request methods.

HTTP Method	Tasks
GET	Retrieve information about all templates and stacks in this Oracle Cloud account, or information about a specific template or stack.
POST	Create (import) a template or create a stack.
PUT	Not supported
DELETE	Delete a template or stack.

Headers

The REST API supports headers that may be passed in the header section of an HTTP request or response.

Header	Description and Example
Accept-Language	A set of natural languages that are preferred as a response to a request. Examples: Accept-Language:ja Accept-Language:da, en-gb;q=0.8, en;q=0.7
Content-Type	The media type of the request body. This header is required for POST and PUT requests, and the supported types vary with each endpoint Examples: Content-Type:application/json Content-type:multipart/form-data
X-ID-TENANT-NAME	The Oracle Cloud identity domain associated with the credentials used to perform the operation. Example: X-ID-TENANT-NAME:ExampleIdentityDomain

Form Parameters

Some REST API endpoints require a request body of type Content-type:multipart/form-data. Include one or more form parameters when using these endpoints, where each parameter has a name and a value.

For example: template=MyTemplate