REST API - list
  1. Operations
  2. vcenter
  3. vm template
  4. library items
  5. versions

vcenter vm template library items versions: list

Returns commonly used information about the live versions of a virtual machine template library item. This operation was added in vSphere API 6.9.1.

Request:

HTTP request

GET https://{server}/rest/vcenter/vm-template/library-items/{template_library_item}/versions

Path Parameters

Name Type Description
Required
template_library_item string Identifier of the VM template library item.

Response:

HTTP Status Code: 200

Representation:

{
    "value" : [
        {
            "version" : "obj-103",
            "vm_template" : "string"
        },
        {
            "version" : "obj-103",
            "vm_template" : "string"
        }
    ]
}

Response Type:

Name Type Description
bold = required
value summary[] List of commonly used information about the library item versions.
value[].version string The version of the library item. This attribute was added in vSphere API 6.9.1.

When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: com.vmware.content.library.item.Version. When operations return a value of this structure as a result, the field will be an identifier for the resource type: com.vmware.content.library.item.Version.
value[].vm_template string Identifier of the virtual machine template associated with the library item version. This field is the managed object identifier used to identify the virtual machine template in the vSphere Management (SOAP) API. This attribute was added in vSphere API 6.9.1.

Errors:

HTTP Status Code Type Description
404 not_found if the library item is not found.
400 invalid_argument if the library item does not contain a virtual machine template.
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.