Queries data report export tasks.
Try it now
Test
RAM authorization
Action | Access level | Resource type | Condition key | Dependent action |
ecd:DescribeEcdReportTasks | none | *All Resource
| None | None |
Request parameters
Parameter | Type | Required | Description | Example |
TaskId | string | No | The ID of the report export task. | ret-sfkdsjfi***** |
TaskType | string | No | The type of the report. Valid value:
Valid values:
| RESOURCE_REPORT |
SubType | string | No | The sub-type of the report export task. Valid values:
| DESKTOP |
| Status | array | No | The task status. Valid values:
| |
string | No | The task status. | RUNNING | |
PageNum | integer | No | The number of the page to return. Pages start from page 1. Default value: 1. | 1 |
PageSize | integer | No | The number of entries returned per page. Maximum value: 200. | 20。 |
Response elements
Element | Type | Description | Example |
object | The response parameters. | ||
RequestId | string | The request ID. | 1CBAFFAB-B697-4049-A9B1-67E1FC5F**** |
TotalCount | integer | The total number of entries returned. | 20 |
| ExportTaskList | array<object> | The report export tasks. | |
object | |||
TaskId | string | The ID of the report export task. | ret-asdfkjg***** |
TaskType | string | The type of the report. Valid value:
Valid values:
| RESOURCE_REPORT |
SubType | string | The sub-type of the report export task. Valid value:
Valid values:
| DESKTOP |
ReportFileName | string | The name of the report file. | TestFileName |
Status | string | The task status. | Running |
Progress | number | The progress of the report export task. Unit: %. | 80 |
GmtCreate | string | The time when the task was created. | 2025-07-14T07:46:49.000+00:00 |
GmtModified | string | The time when the task was last modified. | 2025-07-14T07:46:49.000+00:00 |
DownloadUrl | string | The download URL of the report file. | https://cn-shanghai-ecd-report-files.oss-cn-shanghai.aliyuncs.com/ecd_report/resource/desktop/100721430*****/DESKTOP_20250709140932_*****.xlsx?Expires=*****&OSSAccessKeyId=STS.****&Signature=****%3D&security-token=**** |
ErrorCode | string | The error code returned. | Success |
ErrorMsg | string | The error message. | No Data. |
Examples
Success response
JSON format
{
"RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****",
"TotalCount": 20,
"ExportTaskList": [
{
"TaskId": "ret-asdfkjg*****",
"TaskType": "RESOURCE_REPORT",
"SubType": "DESKTOP",
"ReportFileName": "TestFileName",
"Status": "Running",
"Progress": 80,
"GmtCreate": "2025-07-14T07:46:49.000+00:00",
"GmtModified": "2025-07-14T07:46:49.000+00:00",
"DownloadUrl": "https://cn-shanghai-ecd-report-files.oss-cn-shanghai.aliyuncs.com/ecd_report/resource/desktop/100721430*****/DESKTOP_20250709140932_*****.xlsx?Expires=*****&OSSAccessKeyId=STS.****&Signature=****%3D&security-token=****",
"ErrorCode": "Success",
"ErrorMsg": "No Data."
}
]
}Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.