All Products
Search
Document Center

CDN:DescribeUserUsageDetailDataExportTask

Last Updated:Jul 05, 2024

Queries tasks that were used to export resource usage details of one or more accelerated domain names that belong to your Alibaba Cloud account. Resource usage information is collected every five minutes.

Operation description

  • This operation has been available since July 20, 2018. You can query information about resource usage collected within the last three months.
  • You can call this operation up to 100 times per second per account.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
PageSizestringNo

The number of entries to return on each page. Default value: 20. Maximum value: 50.

Valid values: an integer from 1 to 50.

10
PageNumberstringNo

The number of the page to return. Valid values: 1 to 100000.

1

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The ID of the request.

A91BE91F-0B34-4CBF-8E0F-A2977E15AA52
UsageDataPerPageobject

The usage details returned per page.

PageSizeinteger

The number of entries returned per page.

10
PageNumberinteger

The page number of the returned page.

1
TotalCountinteger

The total number of entries returned.

1
Dataarray<object>

The information about the task.

object
Statusstring

The status of the task.

success
UpdateTimestring

The time when the task was last modified.

2018-10-09T06:35:46Z
DownloadUrlstring

The download URL.

https://test.oss-cn-beijing.aliyuncs.com/billing_data/xxx
CreateTimestring

The time when the task was created.

2018-10-09T06:33:38Z
TaskNamestring

The name of the task.

Refresh
TaskIdstring

The ID of the task.

11
TaskConfigobject

The configurations of the task.

EndTimestring

The end of the time range during which data was queried.

2018-08-31T15:59:59Z
StartTimestring

The start of the time range during which data was queried.

2018-07-31T16:00:00Z

Examples

Sample success responses

JSONformat

{
  "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\n",
          "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.

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