Description
You can call this operation to create a task to export the detailed usage data. The detailed usage data can be downloaded in Excel format.
Note: You can only query the usage data for the last 12 months. You can export the usage data for only one month at a time.
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
| Action | String | Yes | The operation that you want to perform. Set the value to CreateUsageDetailDataExportTask. |
| StartTime | String | Yes | The start time of the queried data. The date format follows the ISO8601 standard and UTC time is used. The format is YYYY-MM-DDThh:mm:ssZ. |
| EndTime | String | Yes | The end time of the queried data. The end time must be later than the start time. The date format follows the ISO8601 standard and UTC time is used. The format is YYYY-MM-DDThh:mm:ssZ. |
| Group | String | No | The domain name group. If you have specified this parameter, leave the DomainNames parameter empty. |
| DomainNames | String | No | The specified domain names. If you have not specified the Group parameter, you can specify the DomainNames parameter. In this case, the data of the specified domain names is exported. If you do not specify this parameter, the data of all your domain names is exported. |
| Type | String | Yes | The type of usage data, flow or vas. |
| TaskName | String | No | The name of the task. |
Response parameters
| Name | Type | Description |
|---|---|---|
| TaskId | String | The ID of the task. |
Examples
Sample requests
http://cdn.aliyuncs.com?Action=CreateUsageDetailDataExportTask&Type=flow&StartTime=2015-12-10T20:00:00Z&EndTime=2015-12-10T21:00:00Z&<Common request parameters>
Error codes
| Error code | Error message | HTTP status code | Description |
|---|---|---|---|
| Throttling | Request was denied due to request throttling. | 503 | The error message returned when the request was denied due to throttling. |
| IllegalOperation | Illegal domain, operation is not permitted. | 403 | The error message returned when the domain name is invalid and operations cannot be performed. |
| OperationDenied | Your account does not open Cdn service yet. | 403 | The error message returned when the CDN service is not enabled. |
| OperationDenied | Your Cdn service is suspended. | 403 | The error message returned when the CDN service has been suspended. |
| InvalidParameter | Invalid Parameter. | 400 | The error message returned when a parameter error occurs. |
| InvalidParameterProduct | Invalid Parameter Product. | 400 | The error message returned when the specified Product is invalid. |
| InvalidParameterDimension | Invalid Parameter Dimension. | 400 | The error message returned when the specified Dimension is invalid. |
| InvalidParameterBillType | Invalid Parameter BillType. | 400 | The error message returned when the specified BillType is invalid. |
| InvalidParameterAliuid | Invalid Parameter Aliuid. | 400 | The error message returned when the specified Aliuid is invalid. |
| InvalidParameterStartTime | Invalid Parameter StartTime. | 400 | The error message returned when the specified StartTime is invalid. |
| InvalidParameterEndTime | InvalidParameterEndTime | 400 | The error message returned when the specified EndTime is invalid. |
| InvalidTimeRange | StartTime and EndTime range should less than 1 month. | 400 | The error message returned when the duration specified by the StartTime and EndTime parameters exceeds 31 days. |
| InvalidParameterOperator | Invalid Parameter Operator. | 400 | The error message returned when the specified Operator is invalid. |