调用CreateUsageDetailDataExportTask创建用量明细数据导出任务,将详细用量生成Excel文件用于下载。

说明
  • 最长可创建查询近一年数据的任务,单次导出任务跨度最长为一个月。
  • 单用户调用频率:100次/秒。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateUsageDetailDataExportTask

系统规定参数。取值:CreateUsageDetailDataExportTask

StartTime String 2019-12-10T20:00:00Z

获取数据起始时间点。

日期格式按照ISO8601表示法,并使用UTC+0时间,格式为yyyy-MM-ddTHH:mm:ssZ。

EndTime String 2019-12-10T21:00:00Z

获取数据结束时间点。

日期格式按照ISO8601表示法,并使用UTC+0时间,格式为yyyy-MM-ddTHH:mm:ssZ。

说明 结束时间需晚于起始时间。
Group String xxx

域名组信息。如果该信息不为空,则忽略DomainNames字段。

DomainNames String example.com

如果域名组为空,则以该字段提供的域名为准导出数据。

如果未填写该参数,则导出用户维度数据。

Type String flow

需要获取的用量类型。取值:

  • flow:流量带宽数据。
  • vas:请求数据。
TaskName String 刷新

任务名称。

Language String en-us

导出文件的语言。取值:

  • zh-cn(默认值):简体中文。
  • en-us:英文。

返回数据

名称 类型 示例值 描述
EndTime String 2015-12-10T21:00:00Z

结束时间。

StartTime String 2015-12-10T20:00:00Z

开始时间。

RequestId String ED61C6C3-8241-4187-AAA7-5157AE175CEC

请求ID。

TaskId String 123456

任务ID。

示例

请求示例

http(s)://cdn.aliyuncs.com/?Action=CreateUsageDetailDataExportTask
&StartTime=2019-12-10T20:00:00Z
&EndTime=2019-12-10T21:00:00Z
&Group=xxx
&DomainNames=example.com
&Type=flow
&TaskName=刷新
&Language=en-us
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateUsageDetailDataExportTaskResponse>
	<RequestId>ED61C6C3-8241-4187-AAA7-5157AE175CEC</RequestId>
	<StartTime>2015-12-10T20:00:00Z</StartTime>
	<EndTime>2015-12-10T21:00:00Z</EndTime>
	<TaskId>123456</TaskId>
</CreateUsageDetailDataExportTaskResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "ED61C6C3-8241-4187-AAA7-5157AE175CEC",
  "StartTime" : "2015-12-10T20:00:00Z",
  "EndTime" : "2015-12-10T21:00:00Z",
  "TaskId" : "123456"
}

错误码

HttpCode 错误码 错误信息 描述
400 MissingTimeParameter The StartTime and EndTime must be both specified. 请同时提供开始时间和结束时间。
400 InvalidParameterProduct Invalid Parameter Product. Product参数错误
400 InvalidParameterAliuid Invalid Parameter Aliuid. Aliuid参数错误
400 InvalidTimeRange Invalid StartTime and EndTime range. 开始时间和结束时间范围无效。
400 InvalidParameterOperator Invalid Parameter Operator. Operator参数错误

访问错误中心查看更多错误码。