批量获取DCDN加速域名的各计量口径计费项（最小粒度为5分钟）， 不包含非请求类的计费项。

调用该接口，请注意：

  • 不指定StartTime和EndTime时，默认读取过去 10 分钟的数据，同时支持按指定的起止时间查询，两者需要同时指定。
  • 支持批量域名查询，多个域名用逗号（半角）分隔, 多个域名会分开返回。
  • 最多可获取最近90天的数据。
  • 查询时间跨度不超过1小时

调试

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

请求参数

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

操作接口名，系统规定参数。

取值：DescribeDcdnDomainMultiUsageData。
DomainName String 否 example.com

若参数为空，默认返回所有加速域名分组数据。

可输入需要查询的加速域名，支持批量域名查询，多个域名用逗号（半角）分隔。
StartTime String 否 2017-12-10T20:00:00Z

获取数据起始时间点。

  • 日期格式按照ISO8601表示法，并使用UTC时间。
  • 格式为：YYYY-MM-DDThh:mm:ssZ。
  • 最小数据粒度为5分钟。
  • 不写默认读取过去24小时数据。
  • 需要和EndTime搭配使用
EndTime String 否 2017-12-10T21:00:00Z

结束时间需大于起始时间。

  • 日期格式按照ISO8601表示法，并使用UTC时间。
  • 格式为：YYYY-MM-DDThh:mm:ssZ。
  • 需要和StartTime配合使用

返回数据

名称 类型 示例值 描述
RequestId String 3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F

该条任务请求Id。
StartTime String 2017-12-10T20:00:00Z

开始时间。
EndTime String 2017-12-10T21:00:00Z

结束时间。
TrafficPerInterval Array of TrafficDataModule

每五分钟的各流量计量数据。
TrafficDataModule
Area String CN

大区名称。
Bps Float 11288111.1

BPS数据值，单位：bit/second
Domain String example.com

域名。
TimeStamp String 2017-12-10T20:00:00Z

时间片起始时刻。
Type String Simple

类型，可以是Simple，IPA，WebSocket 之一。
RequestPerInterval Array of RequestDataModule

每五分钟各请求计量数据。
RequestDataModule
Domain String example.com

域名。
Request Long 1128

请求数，单位个。
TimeStamp String 2017-12-10T20:00:00Z

时间片起始时刻。
Type String DynamicHttp

请求数类型，可以是StaticHttps，DynamicHttps，DynamicHttp，StaticQuic，DynamicQuic之一。

示例

请求示例

http://dcdn.aliyuncs.com?Action=DescribeDcdnDomainMultiUsageData
&DomainName=example.com
&StartTime=2017-12-10T20:00:00Z
&EndTime=2017-12-10T21:00:00Z
&<公共请求参数>

正常返回示例

XML格式 

<DescribeDcdnDomainMultiUsageDataResponse>
  <TrafficPerInterval>
        <TrafficDataModule>
              <TimeStamp>2017-12-10T20:00:00Z</TimeStamp>
              <Domain>example.com</Domain>
              <Bps>11288111.1</Bps>
              <Type>Simple</Type>
              <Area>CN</Area>
        </TrafficDataModule>
        <TrafficDataModule>
              <TimeStamp>2017-12-10T20:00:00Z</TimeStamp>
              <Domain>example.com</Domain>
              <Bps>11288111.1</Bps>
              <Type>IPA</Type>
              <Area>CN</Area>
        </TrafficDataModule>
  </TrafficPerInterval>
  <RequestPerInterval>
        <RequestDataModule>
              <TimeStamp>2017-12-10T20:00:00Z</TimeStamp>
              <Domain>example.com</Domain>
              <Request>1128</Request>
              <Type>DynamicHttp</Type>
        </RequestDataModule>
        <RequestDataModule>
              <TimeStamp>2017-12-10T20:00:00Z</TimeStamp>
              <Domain>example.com</Domain>
              <Request>1128</Request>
              <Type>StaticHttps</Type>
        </RequestDataModule>
  </RequestPerInterval>
  <RequestId>3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F</RequestId>
  <StartTime>2017-12-10T20:00:00Z</StartTime>
  <EndTime>2017-12-10T21:00:00Z</EndTime>
</DescribeDcdnDomainMultiUsageDataResponse>

JSON格式 

{
    "TrafficPerInterval": {
        "TrafficDataModule": [
            {
                "TimeStamp": "2017-12-10T20:00:00Z",
                "Domain": "example.com",
                "Bps": 11288111.1,
                "Type": "Simple",
                "Area": "CN"
            },
            {
                "TimeStamp": "2017-12-10T20:00:00Z",
                "Domain": "example.com",
                "Bps": 11288111.1,
                "Type": "IPA",
                "Area": "CN"
            }
        ]
    },
    "RequestPerInterval": {
        "RequestDataModule": [
            {
                "TimeStamp": "2017-12-10T20:00:00Z",
                "Domain": "example.com",
                "Request": 1128,
                "Type": "DynamicHttp"
            },
            {
                "TimeStamp": "2017-12-10T20:00:00Z",
                "Domain": "example.com",
                "Request": 1128,
                "Type": "StaticHttps"
            }
        ]
    },
    "RequestId": "3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F",
    "StartTime": "2017-12-10T20:00:00Z",
    "EndTime": "2017-12-10T21:00:00Z"
}

错误码

HttpCode 错误码 错误信息 描述
400 MissingTimeParameter The StartTime and EndTime must be both specified. 请同时提供开始时间和结束时间。
400 InvalidStartTime.Malformed The specified StartTime parameter is invalid. 请提供正确的开始时间格式。日期格式按照ISO8601表示法，并使用UTC时间，格式为：yyyy-MM-ddTHH:mm:ssZ。
400 InvalidEndTime.Malformed The specified EndTime is invalid. 请提供正确的结束时间格式。日期格式按照ISO8601表示法，并使用UTC时间。 格式为：yyyy-MM-ddTHH:mm:ssZ。
400 InvalidEndTime.Mismatch The specified EndTime is earlier than the StartTime. 结束时间早于开始时间，请检查。
400 InvalidStartTime.ValueNotSupported The specified StartTime is invalid. 不支持该开始时间，请重新填写。

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