REST API - list

content library item changes: list

Returns commonly used information about the content changes made to a library item. This operation was added in vSphere API 6.9.1.

Request:

HTTP request

GET https://{server}/rest/content/library/item/{library_item}/changes

Path Parameters

Name Type Description
Required
library_item string Library item identifier.

Response:

HTTP Status Code: 200

Representation:

{
    "value"[
        {
            "short_message""string",
            "time""2015-01-01T22:13:05.651Z",
            "version""obj-103",
            "user""string"
        },
        {
            "short_message""string",
            "time""2015-01-01T22:13:05.651Z",
            "version""obj-103",
            "user""string"
        }
    ]
}

Response Type:

Name Type Description
bold = required
value summary[] List of commonly used information about the library item changes.
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[].time date_time The date and time when the item content was changed. This attribute was added in vSphere API 6.9.1.

value[].user string The user who made the content change. This attribute was added in vSphere API 6.9.1.

Optional. This field will be unset if the user could not be determined.

value[].short_message string The short message describing the content change. The message is truncated to the first 80 characters or first non-leading newline character, whichever length is shorter. This attribute was added in vSphere API 6.9.1.

Optional. This field will be unset if a message was not provided when the item content was changed.

Errors:

HTTP Status Code Type Description
404 not_found if the library item is not found.
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.