All Products
Search
Document Center

Elastic Desktop Service:ListTransferFiles

Last Updated:Nov 14, 2025

Queries the file information of a file transmission task.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
TaskIdstringNo

The ID of the transmission task.

trt-03tdwg4tcuwdzv****
MaxResultsintegerNo

The number of entries to return on each page.

Maximum value: 100.

Default value: 20.

20
NextTokenstringNo

A pagination token. It can be used in the next request to retrieve a new page of results. If NextToken is empty, no next page exists.

caeba0bbb2be03f84eb48b699f0****

Response parameters

ParameterTypeDescriptionExample
object

The returned data.

RequestIdstring

The ID of the request.

1CBAFFAB-B697-4049-A9B1-67E1FC5F****
NextTokenstring

The returned value of NextToken is a pagination token, which can be used in the next request to retrieve a new page of results. If NextToken is empty, no next page exists.

caeba0bbb2be03f84eb48b699f0a****
MaxResultsinteger

The number of entries to return on each page.

Maximum value: 100.

Default value: 20.

20
Filesarray<object>

The files.

Fileobject

The information about the file.

IconUrlstring

The URL of the file icon.

Note
  • For image file types (.png, .jpg, .jpeg, .gif, .webp, and .svg), the URL of the specific image is returned.

  • For other file types, the URL of the default image is returned.

https://app-center-icon-pre-hangzhou.oss-cn-hangzhou.aliyuncs.com/tenant****
Statusstring

The file status.

Valid values:

  • DELETING
  • DELETED
  • UPLOADED
DELETED
Typestring

The file type.

txt
Sizestring

The file size.

10853079
OssFileNamestring

The name of the object stored in OSS.

Note
  • A value is returned for this parameter only when the object is stored in a custom OSS bucket.
Idstring

The file ID.

trf-a213msf****
Namestring

The file name.

OssFilePathstring

The path of the object in the OSS bucket.

Note
  • A value is returned for this parameter only when the object is stored in a custom OSS bucket.
transfer/1244234/****

Examples

Sample success responses

JSONformat

{
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****",
  "NextToken": "caeba0bbb2be03f84eb48b699f0a****",
  "MaxResults": 20,
  "Files": [
    {
      "IconUrl": "https://app-center-icon-pre-hangzhou.oss-cn-hangzhou.aliyuncs.com/tenant****",
      "Status": "DELETED",
      "Type": "txt",
      "Size": 10853079,
      "OssFileName": "",
      "Id": "trf-a213msf****",
      "Name": "",
      "OssFilePath": "transfer/1244234/****"
    }
  ]
}

Error codes

For a list of error codes, visit the Service error codes.