开发者社区> 问答> 正文

如何查询时刻网络带宽?



DescribeDomainBpsDataByTimeStamp



描述


获取加速域名的在某个时刻不同Locate和Isp上的带宽数据,单位 bit/second

  • 不支持批量域名查询
  • 时间精确到5分钟粒度


请求参数

参数类型必要描述
ActionString操作接口名,系统规定参数取值:DescribeDomainBpsDataByTimeStamp
DomainNameString要查询的域名,不能为空;
LocationNamesString需要查询目标节点列表,用“,”隔开,不能为空; Location名通过DescribeCdnRegionAndIsp接口获得;
IspNamesString需要查询目标Isp列表,用“,”隔开,不能为空; ISP名通过DescribeCdnRegionAndIsp接口获得;
TimePointString查询目标时间点,日期格式按照ISO8601表示法,并使用UTC时间。格式为:YYYY-MM-DDThh:mmZ最小数据粒度为5分钟


返回参数

名称类型描述
DomainNameString加速域名信息
TimePointString时间点
BpsDataListBpsDataModel[]每个Locate、ISP对应的bps值


BpsDataModel

名称类型描述
LocationNameString节点名
IspNameStringIsp名
BpsLong对应的带宽值


特殊错误码

错误代码描述Http 状态码语义
ThrottlingRequest was denied due to request throttling.503请求被流量控制限制
IllegalOperationIllegal domain, operation is not permitted.403非法域名, 无法操作
OperationDeniedYour account does not open CDN service yet.403未开通CDN服务
OperationDeniedYour CDN service is suspended.403CDN服务已被停止
InvalidDomain.NotFoundThe domain provided does not belong to you.404域名不存在或不属于当前用户
InvalidDomain.OfflineThe domain provided is offline.404域名已下线
ServiceBusyThe specified Domain is configuring, please retry later.403域名正在配置中, 请稍后再试
InvalidTimePoint.MalformedSpecified TimePoint malformed.400TimePoint格式错误
InvaildParameterIspNames Not Supported400ISP不支持
InvaildParameterLocationNames Not Supported400Location不支持


示例


请求示例: http://cdn.aliyuncs.com?Action=DescribeDomainBpsDataByTimeStamp&DomainName=abc.com
&LocationNames=liaoning,guangxi
&IspNames=unicom,telecom
&TimePoint=2016-08-01T22:00Z
&<公共请求参数>


返回示例:
JSON格式 {
    "TimeStamp": "2016-08-01T22:00Z",
    "BpsDataList": {
        "BpsDataModel": [
            {
                "LocationName": "Liaoning",
                "Bps": 880996111,
                "IspName": "telecom"
            },
            {
                "LocationName": "Liaoning",
                "Bps": 52119553,
                "IspName": "unicom"
            },
            {
                "LocationName": "Guangxi",
                "Bps": 51295137,
                "IspName": "telecom"
            },
            {
                "LocationName": "Guangxi",
                "Bps": 18673571,
                "IspName": "unicom"
            }
        ]
    },
    "RequestId": "7682DE14-3B4D-48D0-9B7C-DD3C8C3E1C78",
    "DomainName": "abc.cn"
}


XML格式: <?xml version="1.0" ?>
<DescribeDomainBpsDataByTimeStampResponse>
        <TimeStamp>2016-08-01T22:00Z</TimeStamp>
        <BpsDataList>
                <BpsDataModel>
                        <LocationName>Liaoning</LocationName>
                        <IspName>telecom</IspName>
                        <Bps>880996111</Bps>
                </BpsDataModel>
                <BpsDataModel>
                        <LocationName>Liaoning</LocationName>
                        <IspName>unicom</IspName>
                        <Bps>52119553</Bps>
                </BpsDataModel>
                <BpsDataModel>
                        <LocationName>Guangxi</LocationName>
                        <IspName>unicom</IspName>
                        <Bps>51295137</Bps>
                </BpsDataModel>
                <BpsDataModel>
                        <LocationName>Guangxi</LocationName>
                        <IspName>unicom</IspName>
                        <Bps>18673571</Bps>
                </BpsDataModel>
        </BpsDataList>
        <RequestId>AA2981FF-1A30-4590-B929-88FC85E12A8B</RequestId>
        <DomainName>abc.cn</DomainName>
</DescribeDomainBpsDataByTimeStampResponse>

展开
收起
青衫无名 2017-10-24 11:25:26 2642 0
0 条回答
写回答
取消 提交回答
问答分类:
问答标签:
问答地址:
问答排行榜
最热
最新

相关电子书

更多
可编程网络视角的网络创新研究 立即下载
可编程网络和SDN3.0 立即下载
开放促进创新:构建开放网络生态 立即下载