调用GetBandwidthData获取加速域名的网络带宽监控数据,支持获取最近90天的数据。

说明
  • 单位:bit/second。
  • 不指定StartTime和EndTime时,默认读取过去24小时的数据;指定StartTime和EndTime时,按指定的起止时间查询。

调试

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

请求参数

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

系统规定参数,取值:GetBandwidthData

BusinessType String all

业务类型,多个用竖线(|)分隔。取值:

  • live:直播流媒体。
  • download:大文件下载。
  • vod:视视频点播。
  • all:全部业务类型。
EndDate String 2017-05-10

结束时间。

IspName String all

运营商代码,多个用竖线(|)分隔,全部填all。

查询请参见通用字段参考

PlatformType String all

终端代码,多个用竖线(|)分隔,全部填all。

查询请参见通用字段参考

Region String all

地域代码,多个用竖线(|)分隔,全部填all。

查询请参见通用字段参考

StartDate String 2017-05-01

开始时间。

Version String 2017-04-11

版本号。

Domain String all

待查询的域名列表。支持批量域名查询,多个域名用竖线(|)分隔。

不传该参数将查询全部。

返回数据

名称 类型 示例值 描述
Code Integer 0

业务码,成功返回0。

DataList Array of UsageData

返回的信息列表。

UsageData
Date String 2017-05-01 00:00:00

数据的时间片起始时刻。

Values List 95231540262

带宽数据,bit/second。

Labels List 带宽

标签,用于描述数据类型。

RequestId String 5C2C4882-69C3-45BA-A10E-67E4DFFEA403

请求ID。

示例

请求示例

http(s)://pcdn.aliyuncs.com/?Action=GetBandwidthData
&BusinessType=all
&EndDate=2017-05-10
&IspName=all
&PlatformType=all
&Region=all
&StartDate=2017-05-01
&Domain=all
&Version=2017-04-11
&<公共请求参数>

正常返回示例

XML格式

<GetBandwidthDataResponse>
    <Labels>带宽</Labels>
    <RequestId>C86F7C0C-D520-4F67-95DB-277E9A233E4E</RequestId>
    <DataList>
        <UsageData>
            <Values>
                <Values>95231540262</Values>
                <Values>290426020145</Values>
            </Values>
            <Date>2017-05-01 00:00:00</Date>
        </UsageData>
        <UsageData>
            <Values>
                <Values>36802763485</Values>
                <Values>290426020145</Values>
            </Values>
            <Date>2017-05-01 04:00:00</Date>
        </UsageData>
    </DataList>
    <Code>0</Code>
</GetBandwidthDataResponse>

JSON格式

{
    "Labels": "带宽" ,
    "RequestId": "5C2C4882-69C3-45BA-A10E-67E4DFFEA403",
    "DataList": {
        "UsageData": [
            {
                "Values": {
                    "Values": [
                        95231540262,
                        290426020145
                    ]
                },
                "Date": "2017-05-01 00:00:00"
            },
            {
                "Values": {
                    "Values": [
                        36802763485,
                        290426020145
                    ]
                },
                "Date": "2017-05-01 04:00:00"
            }
        ]
    },
    "Code": 0
}

错误码

HttpCode 错误码 错误信息 描述
400 MissingParameter You must specify domainName. 请求中缺少必要的参数domainName

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