content library item file: get

Retrieves the information for a single file in a library item by its name.

Request:

HTTP request

POST https://{server}/rest/com/vmware/content/library/item/file/id:{library_item_id}?~action=get

Path Parameters

Name Type Description
Required
library_item_id string Identifier of the library item whose file information should be returned.

Request Body Structure:

{
    "name""string"
}
<?xml version="1.0" ?>
<ns0:Get-Input xmlns:ns0="http://vmware.com/content/library/item/file" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <name>string</name>
</ns0:Get-Input>

Request Body Parameters:

Name Type Description
bold = required
name string Name of the file in the library item whose information should be returned.

Response:

HTTP Status Code: 200

Representations:

{
    "value"{
        "cached"true,
        "checksum_info"{
            "algorithm""SHA1",
            "checksum""string"
        },
        "name""string",
        "size"1,
        "version""string"
    }
}
<?xml version="1.0" ?>
<ns0:Get-Result xmlns:ns0="http://vmware.com/content/library/item/file" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <value>
    <cached>true</cached>
    <name>string</name>
    <version>string</version>
    <size>1</size>
    <checksum_info>
      <checksum>string</checksum>
      <algorithm>SHA1</algorithm>
    </checksum_info>
  </value>
</ns0:Get-Result>

Response Type:

Name Type Description
bold = required
value info The content.library.item.file.info object with information on the specified file.
value.checksum_info checksum_info A checksum for validating the content of the file.

This value can be used to verify that a transfer was completed without errors.

Optional. A checksum cannot always be calculated, and the value will be unset if the file does not have content.

value.checksum_info.algorithm string The checksum algorithm (SHA1, MD5) used to calculate the checksum.

Optional. If not specified the default checksum algorithm is SH_a1.

value.checksum_info.checksum string The checksum value calculated with content.library.item.file.checksum_info.algorithm.

value.name string The name of the file.

This value will be unique within the library item for each file. It cannot be an empty string.

value.size long 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.

value.cached boolean Indicates whether the file is on disk or not.

value.version string The version of this file; incremented when a new copy of the file is uploaded.

Errors:

HTTP Status Code Type Description
404 not_found if library_item_id refers to a library item that does not exist.