FileTransferInformation

FileTransferInformation
FileTransferInformation

Represents the information about a InitiateFileTransferFromGuest operation of GuestFileManager object.

The user can use the URL provided in url property to transfer the file from the guest. The user should send a HTTP GET request to the URL. Entire file content will be returned in the body of the response message.

AllOf
This class requires all of the following:
JSON Example
{
    "_typeName": "string",
    "attributes": {
        "_typeName": "string",
        "modificationTime": "string",
        "accessTime": "string",
        "symlinkTarget": "string"
    },
    "size": 0,
    "url": "string"
}
attributes
Required

Different attributes for a guest file.

integer As int64 As int64
size
Required

Total size of the file in bytes.

string
url
Required

Specifies the URL to which the user has to send HTTP GET request.

Multiple GET requests cannot be sent to the URL simultaneously. URL will become invalid once a successful GET request is sent.

The host part of the URL is returned as '*' if the hostname to be used is the name of the server to which the call was made. For example, if the call is made to esx-svr-1.domain1.com, and the file is available for download from https://esx-svr-1.domain1.com/guestFile?id=1&token=1234, the URL returned may be https://*/guestFile?id=1&token=1234. The client replaces the asterisk with the server name on which it invoked the call.

The URL is valid only for 10 minutes from the time it is generated. Also, the URL becomes invalid whenever the virtual machine is powered off, suspended or unregistered.