Get Item Updatesession File
If vSphere APIs begin with /rest (vs /api), any maps are consumed/returned instead as arrays of objects, each containing a key and a value property field.
Retrieves information about a specific file in the snapshot of the library item at the time when the update session was created. if you do not have all of the privileges described as follows: - Operation execution requires System.Anonymous.
Request
URLURL
https://{api_host}/rest/com/vmware/content/library/item/updatesession/file/id:{update_session_id}?~action=get
Parameters
Parameters
string
update_session_id
Required
Identifier of the update session.
The parameter must be an identifier for the resource type: com.vmware.content.library.item.UpdateSession.
Query Parameters
Query Parameters
string
file_name
Required
Name of the file.
Header Parameters
Header Parameters
string
vmware-api-session-id
Required
Required session ID, obtained by first calling Create Session API
Example: b00db39f948d13ea1e59b4d6fce56389
Response
Response
Response BodyResponse Body
200 OK returns
LibraryItemUpdatesessionFileGetResponseBody
of type application/json
Information about the file.
{
"value": {
"bytes_transferred": 0,
"checksum_info": {
"algorithm": "enum",
"checksum": "string"
},
"keep_in_storage": false,
"name": "string",
"size": 0,
"source_endpoint": {
"ssl_certificate_thumbprint": "string",
"uri": "string"
},
"source_type": "enum",
"status": "enum",
"upload_endpoint": {
"ssl_certificate_thumbprint": "string",
"uri": "string"
}
}
}cURL Command
curl -X POST -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" https://{api_host}/rest/com/vmware/content/library/item/updatesession/file/id:{update_session_id}?~action=get?file_name=string
Errors
400
com.vmware.vapi.std.errors.invalid_argument : if the file doesn't exist in the library item associated with the update session.
