esx settings clusters software drafts: create
Creates a new software draft from the desired document. It will be deleted, when the draft is committed successfully. If a desired document is missing, then this operation will create an empty draft.
Request:
HTTP request
POST https://{server}/api/esx/settings/clusters/{cluster}/software/drafts
Path Parameters
| Name | Type | Description |
|---|---|---|
| Required | ||
| cluster | string | Identifier of the cluster. |
Response:
HTTP Status Code: 201
Response Body Structure:
"obj-103"
Headers:
NoneType:
| Name | Type | Description |
|---|---|---|
| bold = required | ||
| - | string | Identifier of the working copy of the document. |
Errors:
| HTTP Status Code | Type | Description |
|---|---|---|
| 400 | already_exists | If there is already a draft created by this user. |
| 500 | error | If there is unknown internal error. The accompanying error message will give more details about the failure. |
| 404 | not_found | If there is no cluster associated with cluster in the system. |
| 503 | service_unavailable | If the service is not available. |
| 401 | unauthenticated | If the caller is not authenticated. |