This API has a deprecated equivalent from v7.0U1.
List Item File
Lists all of the files that are stored within a given library item. 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.
Request
URLURL
https://{api_host}/api/content/library/item/{library_item_id}/file
Path Parameters
Path Parameters
string
library_item_id
Required
Identifier of the library item whose files should be listed. The parameter must be an identifier for the resource type: com.vmware.content.library.Item.
Header Parameters
Header Parameters
string
vmware-api-session-id
Required
Required session ID, acquired from Create Session API under CIS product
vmware-api-session-id example
"b00db39f948d13ea1e59b4d6fce56389"
Authentication
This operation uses the following authentication methods.
Response
Response
Response BodyResponse Body
200 OK returns
array of
LibraryItemFileInfo
of type application/json
The list of all of the files that are stored within the given library item.
[
{
"cached": false,
"checksum_info": {
"algorithm": "SHA1",
"checksum": "string"
},
"name": "string",
"size": 0,
"version": "string"
}
]
boolean
cached
Required
Indicates whether the file is on disk or not.
string
name
Required
The name of the file. This value will be unique within the library item for each file. It cannot be an empty string.
integer
size
Required
The file size, in bytes. The file size is the storage used and not the uploaded or provisioned size. For example, when uploading a disk to a datastore, the amount of storage that the disk consumes may be different from the disk file size. When the file is not cached, the size is 0.
string
version
Required
The version of this file; incremented when a new copy of the file is uploaded.
checksum_info
Optional
A checksum for validating the content of the file. This value can be used to verify that a transfer was completed without errors.
A checksum cannot always be calculated, and the value will be unset if the file does not have content.
Errors
404
com.vmware.vapi.std.errors.not_found : if libraryItemId refers to a library item that does not exist.
default
‘Default’ means this response is used for all HTTP codes that are not covered individually for this operation.
Code Samples
PowerCLI Client SDK Example
Invoke-ListLibraryItemIdContentFile -LibraryItemId "MyLibraryItemId"
cURL Command
curl -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" https://{api_host}/api/content/library/item/{library_item_id}/file
Vendor Extensions
This operation contains the following vendor extensions defined in the spec:
x-vmw-doc-deprecated-method: get
x-vmw-doc-deprecated-path: /rest/com/vmware/content/library/item/file
x-vmw-doc-operation: list
Availability
Added in 7.0U2
On This Page
Item File Operations
get
get
