REST API - create

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.


HTTP request

POST https://{server}/api/esx/settings/clusters/{cluster}/software/drafts

Path Parameters

Name Type Description
cluster string Identifier of the cluster.


HTTP Status Code: 201

Response Body Structure:





Name Type Description
bold = required
- string Identifier of the working copy of the document.


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.