All Products
Search
Document Center

CDN:DescribeUserUsageDetailDataExportTask

Last Updated:Jul 07, 2026

Queries export tasks for resource usage details of one or more accelerated domain names in your Alibaba Cloud CDN account. Usage data is collected at 5-minute intervals.

Operation description

  • Data is available for the last three months. This operation has been available since July 20, 2018.

  • Each account can call this operation up to 100 times per second.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

ActionAccess levelResource typeCondition keyDependent action
cdn:DescribeUserUsageDetailDataExportTaskget*All Resource *NoneNone

Request parameters

ParameterTypeRequiredDescriptionExample
PageSizestringNoThe number of entries per page. Valid values: 1 to 50. Default value: 20.10
PageNumberstringNoThe page number. Valid values: 1 to 100000.1

Response elements

ElementTypeDescriptionExample
RequestIdstringThe request ID.A91BE91F-0B34-4CBF-8E0F-A2977E15AA52
UsageDataPerPageobjectThe usage details returned per page.
PageSizeintegerThe number of entries per page.10
PageNumberintegerThe page number of the returned page.1
TotalCountintegerThe total number of entries returned.1
DataobjectThe container for task data.
DataItemarray\<object\>The information about the task.
TaskIdstringThe task ID.11
TaskNamestringThe task name.Refresh
StatusstringThe task status.success
CreateTimestringThe time when the task was created. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.2018-10-09T06:33:38Z
UpdateTimestringThe time when the task was last modified. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.2018-10-09T06:35:46Z
DownloadUrlstringThe URL to download the exported usage data.https://test.oss-cn-beijing.aliyuncs.com/billing_data/xxx
TaskConfigobjectThe configurations of the task.
StartTimestringThe start of the time range during which data was queried. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.2018-07-31T16:00:00Z
EndTimestringThe end of the time range during which data was queried. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.2018-08-31T15:59:59Z

Examples

Success response

JSON format

{
  "RequestId": "A91BE91F-0B34-4CBF-8E0F-A2977E15AA52",
  "UsageDataPerPage": {
    "PageSize": 10,
    "PageNumber": 1,
    "TotalCount": 1,
    "Data": {
      "DataItem": [
        {
          "Status": "success",
          "UpdateTime": "2018-10-09T06:35:46Z",
          "DownloadUrl": "https://test.oss-cn-beijing.aliyuncs.com/billing_data/xxx",
          "CreateTime": "2018-10-09T06:33:38Z",
          "TaskName": "Refresh",
          "TaskId": "11",
          "TaskConfig": {
            "EndTime": "2018-08-31T15:59:59Z",
            "StartTime": "2018-07-31T16:00:00Z"
          }
        }
      ]
    }
  }
}

Error codes

HTTP status codeError codeError messageDescription
400InvalidParameterProductInvalid Parameter Product.The Product parameter is set to an invalid value.
400InvalidParameterOperatorInvalid Parameter Operator.The Operator parameter is set to an invalid value.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.