Library Item APIs

Library Item APIs

The Item service provides operations for managing library items.

Operations
POST
Copy Source Library Item Id
Copies a library item. Copying a library item allows a duplicate to be made within the same or different library. The copy occurs by first creating a new library item, whose identifier is returned. The content of the library item is then copied asynchronously. This copy can be tracked as a task. If the copy fails, Content Library Service will roll back the copy by deleting any content that was already copied, and removing the new library item. A failure during rollback may require manual cleanup by an administrator. A library item cannot be copied into a subscribed library. if you do not have all of the privileges described as follows: - The resource com.vmware.content.library.Item referenced by the parameter sourceLibraryItemId requires System.Read. - The resource com.vmware.content.Library referenced by the attribute ItemModel.library-id requires ContentLibrary.AddLibraryItem.
POST
Create Content Library Item
Creates a new library item. A new library item is created without any content. After creation, content can be added through the UpdateSession and File services. A library item cannot be created in a subscribed library. if you do not have all of the privileges described as follows: - The resource com.vmware.content.Library referenced by the attribute ItemModel.library-id requires ContentLibrary.AddLibraryItem.
DELETE
Delete Library Item Id Content
Deletes a library item. This operation will immediately remove the item from the library that owns it. The content of the item will be asynchronously removed from the storage backings. The content deletion can be tracked with a task. In the event that the task fails, an administrator may need to manually remove the files from the storage backing. This operation cannot be used to delete a library item that is a member of a subscribed library. Removing an item from a subscribed library requires deleting the item from the original published local library and syncing the subscribed library. if you do not have all of the privileges described as follows: - The resource com.vmware.content.library.Item referenced by the parameter libraryItemId requires ContentLibrary.DeleteLibraryItem.
GET
Get Library Item Id Content
Returns the ItemModel with the given identifier. if you do not have all of the privileges described as follows: - The resource com.vmware.content.library.Item referenced by the parameter libraryItemId requires System.Read.
PATCH
Update Library Item Id Content
Updates the specified properties of a library item. This is an incremental update to the library item. Fields that are unset in the update specification are left unchanged. This operation cannot update a library item that is a member of a subscribed library. Those items must be updated in the source published library and synchronized to the subscribed library. if you do not have all of the privileges described as follows: - The resource com.vmware.content.library.Item referenced by the parameter libraryItemId requires ContentLibrary.UpdateLibraryItem.
POST
Find Library Item
Returns identifiers of all the visible (as determined by authorization policy) library items matching the requested Item.FindSpec. if you do not have all of the privileges described as follows: - Operation execution requires System.Read. - The resource com.vmware.content.Library referenced by the attribute Item.FindSpec.library-id requires System.Read.
GET
List Library Item
Returns the identifiers of all items in the given library. if you do not have all of the privileges described as follows: - The resource com.vmware.content.Library referenced by the parameter libraryId requires System.Read.
POST
Publish Library Item Id
Publishes the library item to specified subscriptions of the library. If no subscriptions are specified, then publishes the library item to all subscriptions of the library. if you do not have all of the privileges described as follows: - The resource com.vmware.content.library.Item referenced by the parameter libraryItemId requires ContentLibrary.PublishLibraryItem.