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
-
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 |
---|---|
|
A set of natural languages that are preferred as a response to a request. Examples:
|
|
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:
|
|
The Oracle Cloud identity domain associated with the credentials used to perform the operation. Example: |
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