content library item downloadsession file: info
The
info
structure defines the downloaded file.Representations:
{
"bytes_transferred": 1,
"checksum_info": {
"algorithm": "SHA1",
"checksum": "string"
},
"download_endpoint": {
"ssl_certificate_thumbprint": "string",
"uri": "http://myurl.com"
},
"error_message": {
"args": [
"string",
"string"
],
"default_message": "string",
"id": "string"
},
"name": "string",
"size": 1,
"status": "UNPREPARED"
}
"bytes_transferred": 1,
"checksum_info": {
"algorithm": "SHA1",
"checksum": "string"
},
"download_endpoint": {
"ssl_certificate_thumbprint": "string",
"uri": "http://myurl.com"
},
"error_message": {
"args": [
"string",
"string"
],
"default_message": "string",
"id": "string"
},
"name": "string",
"size": 1,
"status": "UNPREPARED"
}
<?xml version="1.0" ?>
<ns0:Info xmlns:ns0="http://vmware.com/content/library/item/downloadsession/file" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<download_endpoint>
<ssl_certificate_thumbprint>string</ssl_certificate_thumbprint>
<uri>http://myurl.com</uri>
</download_endpoint>
<status>UNPREPARED</status>
<error_message>
<default_message>string</default_message>
<id>string</id>
<args-array>
<array-item>string</array-item>
<array-item>string</array-item>
</args-array>
</error_message>
<name>string</name>
<bytes_transferred>1</bytes_transferred>
<checksum_info>
<checksum>string</checksum>
<algorithm>SHA1</algorithm>
</checksum_info>
<size>1</size>
</ns0:Info>
<ns0:Info xmlns:ns0="http://vmware.com/content/library/item/downloadsession/file" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<download_endpoint>
<ssl_certificate_thumbprint>string</ssl_certificate_thumbprint>
<uri>http://myurl.com</uri>
</download_endpoint>
<status>UNPREPARED</status>
<error_message>
<default_message>string</default_message>
<id>string</id>
<args-array>
<array-item>string</array-item>
<array-item>string</array-item>
</args-array>
</error_message>
<name>string</name>
<bytes_transferred>1</bytes_transferred>
<checksum_info>
<checksum>string</checksum>
<algorithm>SHA1</algorithm>
</checksum_info>
<size>1</size>
</ns0:Info>
Attributes:
Name | Type | Description |
---|---|---|
Required | ||
name | string | The name of the file. |
bytes_transferred | long | The number of bytes that have been transferred by the server so far for making this file prepared for download. This value may stay at zero till the client starts downloading the file. |
status | string | The preparation status (UNPREPARED , PREPARE_REQUESTED , PREPARING , PREPARED , ERROR ) of the file. Defines the state of the file in preparation for download. Value is one of:UNPREPARED: The file hasn't been requested for preparation. PREPARE_REQUESTED: A prepare has been requested, however the server hasn't started the preparation yet. PREPARING: A prepare has been requested and the file is in the process of being prepared. PREPARED: Prepare succeeded. The file is ready for download. ERROR: Prepare failed. |
Optional | ||
size | long | The file size, in bytes. Optional. This field may not be available immediately. It is guaranteed to be set when the client finishes downloading the file. |
download_endpoint | transfer_endpoint | Endpoint at which the file is available for download. The value is valid only when the content.library.item.downloadsession.file.info.status is PREPARED. Optional. This field won't be set until the file status is PREPARED. |
checksum_info | checksum_info | The checksum information of the file. When the download is complete, you can retrieve the checksum from the get operation to verify the checksum for the downloaded file. Optional. The checksum is always calculated for the downloaded file, but this field won't be set until the download is complete. |
error_message | localizable_message | Error message for a failed preparation when the prepare status is ERROR. Optional. This field won't be set unless there was an error with the file transfer. |