POST Method
The POST HTTP method can be used in two different ways:
- To create a new resource, for example, a new location.
- To perform an operation, for example, undo a failover plan or update a license.
All requests that create a new resource require a request body. The body must contain properties for this resource. For example, to create a new location, send the following request:
Request: POST https://<hostname>:1280/api/v3/organizations/locations
Request Header: Content-Type: application/json Authorization: Bearer <Access-Token>
Request Body: { "organizationUid": "89d3b0c2-529f-4d51-988a-d8ae92f3259b", "name": "Default location", "quotaGb": 10, "isDefault": false } |
Requests that perform an action do not require a request body. For example, to undo a failover plan, send the following request:
Request: POST https://<hostname>:1280/api/v3/failoverPlans/{planUid}/undo
Request Header: Content-Type: application/json Authorization: Bearer <Access-Token> |
In case of success, the POST HTTP method returns the 200 OK response code.