vcenter vm template library items versions: rollback
Rollbacks a library item containing a virtual machine template to a previous version. The virtual machine template at the specified version becomes the latest virtual machine template with a new version identifier. This operation was added in vSphere API 6.9.1.
Request:
HTTP request
POST https://{server}/rest/vcenter/vm-template/library-items/{template_library_item}/versions/{version}?action=rollback
Path Parameters
| Name | Type | Description |
|---|---|---|
| Required | ||
| template_library_item | string | Identifier of the VM template library item. |
| version | string | Version of the library item to rollback. |
Request Body Structure:
{
"spec" : {
"message" : "string"
}
}
"spec" : {
"message" : "string"
}
}
Request Body Parameters:
| Name | Type | Description |
|---|---|---|
| bold = required | ||
| spec | rollback_spec | Optional. Specification to rollback the library item. |
| spec.message | string | Message describing the reason for the rollback. This attribute was added in vSphere API 6.9.1. |
Response:
HTTP Status Code: 200
Representation:
{
"value" : "obj-103"
}
"value" : "obj-103"
}
Response Type:
| Name | Type | Description |
|---|---|---|
| bold = required | ||
| value | string | The new version of the library item. |
Errors:
| HTTP Status Code | Type | Description |
|---|---|---|
| 404 | not_found | if the library item or version is not found. |
| 400 | invalid_argument | if the specified version is the latest version of the library item. |
| 400 | not_allowed_in_current_state | if a virtual machine is checked out of the library item. |
| 401 | unauthenticated | if the user that requested the operation cannot be authenticated. |
| 403 | unauthorized | if the user that requested the operation is not authorized to perform the operation. |
| 500 | error | if the system reports an error while responding to the request. |