创建一个任务,用来生成您加速域名的用量报告。调用该 API 后,您可以调用 ListUsageReports 获取用量报告的下载 URL。
节流限制:您每秒最多可以发送 20 个 API 请求。
参数名称 | 数据类型 | 是否必选 | 参数说明 |
---|---|---|---|
Action | String | 是 | 接口名称。当前 API 的名称为 CreateUsageReport 。 |
Version | String | 是 | 接口版本。当前 API 的版本为 2021-03-01 。 |
参数名称 | 数据类型 | 是否必选 | 参数说明 | 示例 |
---|---|---|---|---|
BillingRegion | String | 是 | 表示一个计费区域。该任务生成该计费区域的用量报告。该参数有以下取值:
| ALL |
EndTime | Long | 是 | 表示该任务中统计时间段的结束时间,格式是 Unix 时间戳,精确到天。 | 1714492799 |
ExportType | String | 是 | 表示该任务的类型。该参数的取值如下:
| domain |
Metric | String | 否 | 表示一个计费项。该参数有以下取值:
| traffic |
StartTime | Long | 是 | 表示该任务中统计时间段的开始时间,格式是 Unix 时间戳,精确到天。
| 1711900800 |
TaskName | String | 是 | 表示该任务的名称,长度为 3-63 个字符。任务名称只能包含小写字母、数字、下划线(_),并且只能以小写字母或数字开头和结尾。 | my_task |
Aggregate | String | 否 | 表示是否聚合所有指定域名的用量。该参数有以下取值:
Domain 时才生效。该参数的默认值为 aggregate 。 | aggregate |
Domain | String | 否 | 表示一个加速域名列表,列表中的加速域名以逗号(,)分隔。列表中最多可以包含 50 个加速域名。当 | img.example.com,doc.example.com |
CalculationMethod | String | 否 | 表示
| monthly_95th_percentile_bandwidth |
参数名称 | 数据类型 | 参数说明 | 示例 |
---|---|---|---|
TaskId | String | 表示创建的任务 ID。 | 1b972ae5f1494f9fa8710cd4c737a242 |
POST https://cdn.volcengineapi.com/?Action=CreateUsageReport&Version=2021-03-01 { "ExportType": "domain", "BillingRegion": "ALL", "Domain": "img.example.com,doc.example.com", "TaskName": "mytask", "StartTime": 1711900800, "EndTime": 1714492799, "Aggregate": "disaggregate" }
{ "ResponseMetadata": { "RequestId": "2024052615550133AE8D9DAAF80B5510CF", "Action": "CreateUsageReport", "Version": "2021-03-01", "Service": "CDN", "Region": "cn-north-1" }, "Result": { "TaskId": "1b972ae5f1494f9fa8710cd4c737a242" } }
如果响应正文的 ResponseMetadata
字段中包含 Error
字段,则表示 API 请求失败。更多关于错误码的信息,参见错误码。