Library_ItemModel

Library_ItemModel
Library_ItemModel

The ItemModel structure represents a library item that has been stored in a library. A ItemModel represents a single logical unit to be managed within a LibraryModel. Items contain the actual content of a library, and their placement within a library determines policies that affect that content such as publishing.

A library item can have a specified type, indicated with the ItemModel.type field. This property is associated with a Content Library Service plugin that supports specific types and provides additional services. The types available in a specific Content Library Service can be queried using the Type service. Items of an unknown or unspecified type are treated generically. Because subscribed library catalogs are synchronized as is, subscribing to a remote Content Library Service effectively gives you a library with the functionality of the remote service's type adapter plugins, even if they are not installed locally.

Items can be managed using the Item service and, for items in subscribed libraries, the SubscribedItem service.

JSON Example
{
    "id": "string",
    "library_id": "string",
    "content_version": "string",
    "creation_time": "string",
    "description": "string",
    "last_modified_time": "string",
    "last_sync_time": "string",
    "metadata_version": "string",
    "name": "string",
    "cached": false,
    "size": 0,
    "type": "string",
    "version": "string",
    "source_id": "string",
    "security_compliance": false,
    "certificate_verification_info": "Library_Item_CertificateVerificationInfo Object"
}
string
id
Optional

A unique identifier for this library item. This field is not used for the create operation. It will not be present in the result of the get or list operations. It is not used for the update operation. 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. 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.

string
library_id
Optional

The identifier of the LibraryModel to which this item belongs. This field must be provided for the create operation. It will always be present in the result of the get or list operations. It is not used for the update operation. 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. 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.

string
content_version
Optional

The latest version of the file content list of this library item. This field is not used for the create operation. It will always be present in the result of the get or list operations. It is not used for the update operation. 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.

string As date-time
creation_time
Optional

The date and time when this library item was created. This field is not used for the create operation. It will always be present in the result of the get or list operations. It is not used for the update operation.

string
description
Optional

A human-readable description for this library item. This field is optional for the create operation. Leaving it unset during creation will result in an empty string value. It will always be present in the result of a get or list operation. It is optional for the update operation. Leaving it unset during update indicates that the description remains unchanged.

string As date-time
last_modified_time
Optional

The date and time when the metadata for this library item was last changed. This field is affected by changes to the properties or file content of this item. It is not modified by changes to the tags of the item, or by changes to the library which owns this item.

This field is not used for the create operation. It will always be present in the result of the get or list operations. It is not used for the update operation.

string As date-time
last_sync_time
Optional

The date and time when this library item was last synchronized. This field is updated every time a synchronization is triggered on the library item, including when a synchronization is triggered on the library to which this item belongs. The value is unset for a library item that belongs to a local library.

This field is not used for the create operation. It is optional in the result of the get or list operations. It is not used for the update operation.

string
metadata_version
Optional

A version number for the metadata of this library item. This value is incremented with each change to the metadata of this item. Changes to name, description, and so on will increment this value. The value is not incremented by changes to the content or tags of the item or the library which owns it.

This field is not used for the create operation. It will always be present in the result of the get or list operations. It is not used for the update operation.

string
name
Optional

A human-readable name for this library item. The name may not be unset or an empty string. The name does not have to be unique, even within the same library.

This field must be provided for the create operation. It will always be present in the result of the get or list operations. It is optional for the update operation.

boolean
cached
Optional

The status that indicates whether the library item is on disk or not. The library item is cached when all its files are on disk. This field is not used for the create operation. It will always be present in the result of the get or list operations. It is not used for the update operation.

integer As int64
size
Optional

The library item size, in bytes. The size is the sum of the size used on the storage backing for all the files in the item. When the library item is not cached, the size is 0. This field is not used for the create operation. It is optional in the result of the get or list operations. It is not used for the update operation.

string
type
Optional

An optional type identifier which indicates the type adapter plugin to use. This field may be set to a non-empty string value that corresponds to an identifier supported by a type adapter plugin present in the Content Library Service. A type adapter plugin, if present for the specified type, can provide additional information and services around the item content. A type adapter can guide the upload process by creating file entries that are in need of being uploaded to complete an item.

The types and plugins supported by the Content Library Service can be queried using the Type service.

This field is optional for the create and update operations. During creation, if the type is left unspecified, or if the type is specified but does not have a corresponding type support plugin, then the type of the library item is considered to be generic and all data is treated as generic files. During update, if the type is not specified, then it is not updated.

string
version
Optional

A version number that is updated on metadata changes. This value is used to validate update requests to provide optimistic concurrency of changes. This value represents a number that is incremented every time library item properties, such as name or description, are changed. It is not incremented by changes to the file content of the library item, including adding or removing files. It is also not affected by tagging the library item.

This field is not used for the create operation. It will always be present in the result of a get or list operation. It is optional for the update operation. Leaving it unset during update indicates that you do not need to detect concurrent updates.

string
source_id
Optional

The identifier of the ItemModel to which this item is synchronized to if the item belongs to a subscribed library. The value is unset for a library item that belongs to a local library. This field is not used for the create operation. It is optional in the result of the get or list operations. It is not used for the update operation. 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. 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.

boolean
security_compliance
Optional

Shows the security compliance of ItemModel. This field is not used for the create and update operations. It will be present in the result of a get or list operation.

certificate_verification_info
Optional

Certificate verification status and ItemModel's signing certificate . Currently, this field is available only in following cases 1. This item belongs to a secure content library 2. The item is of type ovf. This field is not used for the create and update operations. It may be present in the result of a get or list operation.