如何查询网络带宽?_问答-阿里云开发者社区

DescribeDomainBpsData

描述

获取加速域名的网络带宽监控数据，单位bit/second
不指定StartTime和EndTime时，默认读取过去24小时的数据，同时支持按指定的起止时间查询，两者需要同时指定。

支持批量域名查询，多个域名用逗号（半角）分隔
最多可获取最近90天的数据

请求参数

参数	类型	必要	描述
Action	String	是	操作接口名，系统规定参数取值：DescribeDomainBpsData
DomainName	String	否	若参数为空，默认返回所有加速域名合并后数据可输入需要查询的加速域名支持批量域名查询，多个域名用逗号（半角）分隔
StartTime	String	否	获取数据起始时间点，日期格式按照ISO8601表示法，并使用UTC时间。格式为：YYYY-MM-DDThh:mmZ最小数据粒度为5分钟不写默认读取过去24小时数据
EndTime	String	否	结束时间需大于起始时间；获日期格式按照ISO8601表示法，并使用UTC时间。格式为：YYYY-MM-DDThh:mmZ
Time Merge	String	否	取值范围 on：默认值，每条记录的时间间隔会根据时间跨度做合并；off：返回5分钟粒度数据，最大时间跨度为31天
Interval	String	否	查询数据的时间粒度，支持300, 3600, 14400, 28800和86400秒。不传和传的值不支持时，使用默认值300秒
LocationNameEn	String	否	区域英文名，通过DescribeCdnRegionAndIsp接口获得，不传为所有区域
IspNameEn	String	否	运营商英文名，通过DescribeCdnRegionAndIsp接口获得，不传为所有运营商
DomainType	String	否	查询类型，传dynamic时，查询全站加速动态资源的实时带宽和静态资源的实时带宽。不传时查询静态资源的实时带宽

返回参数

名称	类型	描述
DomainName	String	加速域名信息
DataInterval	String	[需要补充时间间隔规则]每条记录的时间间隔，以秒为单位
StartTime	DateTime	开始时间
EndTime	DateTime	结束时间
BpsDataPerInterval	UsageData[]	每个时间间隔的网络带宽数据
SupplyBpsDatas	UsageData[]	补充最近30分钟内参考实时带宽数据，可能不存在

UsageData

名称	类型	描述
TimeStamp	String	时间片起始时刻
Value	String	bps数据值，单位：bit/second
DomesticValue	String	国内带宽bps，当按区域运营商查询时，此值为空
OverseasValue	String	海外带宽bps，当按区域运营商查询时，此值为空
L2Value	String	L2 bps数据值，单位：bit/second
DomesticL2Value	String	L2国内带宽bps，当按区域运营商查询时，此值为空
OverseasL2Value	String	L2海外带宽bps，当按区域运营商查询时，此值为空
DynamicValue	String	全站加速，动态bps数据值，单位：bit/second
DynamicDomesticValue	String	全站加速，国内带宽动态bps，当按区域运营商查询时，此值为空
DynamicOverseasValue	String	全站加速，海外带宽动态bps，当按区域运营商查询时，此值为空
StaticValue	String	全站加速，静态bps数据值，单位：bit/second
StaticDomesticValue	String	全站加速，国内带宽静态bps，当按区域运营商查询时，此值为空
StaticOverseasValue	String	全站加速，海外带宽静态bps，当按区域运营商查询时，此值为空

特殊错误码

错误代码	描述	Http 状态码	语义
Throttling	Request was denied due to request throttling.	503	请求被流量控制限制
IllegalOperation	Illegal domain, operation is not permitted.	403	非法域名, 无法操作
OperationDenied	Your account does not open CDN service yet.	403	未开通CDN服务
OperationDenied	Your CDN service is suspended.	403	CDN服务已被停止
InvalidDomain.NotFound	The domain provided does not belong to you.	404	域名不存在或不属于当前用户
InvalidDomain.Offline	The domain provided is offline.	404	域名已下线
ServiceBusy	The specified Domain is configuring, please retry later.	403	域名正在配置中, 请稍后再试
InvalidDomain.Configure_failed	Failed to configure the provided domain.	500	域名配置失败
MissingParameter	StartTime and EndTime can not be single.	400	StartTime和EndTime不能单独设置
InvalidStartTime.Malformed	Specified start time is malformed.	400	StartTime格式错误
InvalidEndTime.Malformed	Specified end time is malformed.	400	EndTime格式错误
InvalidEndTime.Mismatch	Specified end time does not math the specified start time.	400	EndTime小于StartTime
InvalidStartTime.ValueNotSupported	Specified end time does not math the specified start time.	400	EndTime和StartTime差值超过90天
InvalidTime Merge.ValueNotSupported	When value of parameter Time Merge is off, maximum time interval is 31 days.	400	当Time Merge为off时，最大时间跨度为31天

示例

请求示例：

http://cdn.aliyuncs.com?Action=DescribeDomainBpsData&DomainName=test.com
&StartTime=2015-12-10T20:00Z
&EndTime=2015-12-10T21:00Z
&<公共请求参数>

返回示例：
JSON格式

{
    "BpsDataPerInterval": {
        "DataModule": [
            {
                "TimeStamp": "2015-12-10T20:00:00Z",
                "Value": "11288111",
                "DomesticValue": "11286111",
                "OverseasValue": "2000",
                "L2Value": "0",
                "DomesticL2Value": "0",
                "OverseasL2Value": "0",
                "DynamicValue": "0",
                "DynamicDomesticValue": "0",
                "DynamicOverseasValue": "0",
                "StaticValue": "0",
                "StaticDomesticValue": "0",
                "StaticOverseasValue": "0"
            },
            {
                "TimeStamp": "2015-12-10T20:05:00Z",
                "Value": "12124821",
                "DomesticValue": "12112821",
                "OverseasValue": "12000",
                "L2Value": "0",
                "DomesticL2Value": "0",
                "OverseasL2Value": "0",
                "DynamicValue": "0",
                "DynamicDomesticValue": "0",
                "DynamicOverseasValue": "0",
                "StaticValue": "0",
                "StaticDomesticValue": "0",
                "StaticOverseasValue": "0"
            }
        ]
    },
    "SupplyBpsDatas": {
      "DataModule": [
        {
          "TimeStamp": "2015-12-10T20:05:00Z",
          "Value": "12124821"
        },
        {
          "TimeStamp": "2015-12-10T20:06:00Z",
          "Value": "12144838"
        }
      ]
    },
    "DomainName": "test.com",
    "DataInterval": "300",
    "RequestId": "3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F",
    "StartTime": "2015-12-10T20:00Z",
    "EndTime": "2015-12-10T21:00Z"
}

XML格式：

<?xml version="1.0" ?>
<DescribeDomainBpsDataResponse>
        <DataInterval>300</DataInterval>
        <BpsDataPerInterval>
                <DataModule>
                        <TimeStamp>2015-12-10T21:00:00Z</TimeStamp>
                        <Value>11431540</Value>
                        <DomesticValue>11131540</DomesticValue>
                        <OverseasValue>300000</OverseasValue>
                        <L2Value>0</L2Value>
                        <DomesticL2Value>0</DomesticL2Value>
                        <OverseasL2Value>0</OverseasL2Value>
                        <DynamicValue>0</DynamicValue>
                        <DynamicDomesticValue>0</DynamicDomesticValue>
                        <DynamicOverseasValue>0</DynamicOverseasValue>
                        <StaticValue>0</StaticValue>
                        <StaticDomesticValue>0</StaticDomesticValue>
                        <StaticOverseasValue>0</StaticOverseasValue>
                </DataModule>
                <DataModule>
                        <TimeStamp>2015-12-10T20:35:00Z</TimeStamp>
                        <Value>12793665</Value>
                        <DomesticValue>12791665</DomesticValue>
                        <OverseasValue>2000</OverseasValue>
                        <L2Value>0</L2Value>
                        <DomesticL2Value>0</DomesticL2Value>
                        <OverseasL2Value>0</OverseasL2Value>
                        <DynamicValue>0</DynamicValue>
                        <DynamicDomesticValue>0</DynamicDomesticValue>
                        <DynamicOverseasValue>0</DynamicOverseasValue>
                        <StaticValue>0</StaticValue>
                        <StaticDomesticValue>0</StaticDomesticValue>
                        <StaticOverseasValue>0</StaticOverseasValue>
                </DataModule>
        </BpsDataPerInterval>
        <SupplyBpsDatas>
              <DataModule>
                  <TimeStamp>2015-12-10T20:35:00Z</TimeStamp>
                  <Value>12793665</Value>
              </DataModule>
              <DataModule>
                  <TimeStamp>2015-12-10T20:36:00Z</TimeStamp>
                  <Value>19011526</Value>
              </DataModule>
        </SupplyBpsDatas>
        <RequestId>AA2981FF-1A30-4590-B929-88FC85E12A8B</RequestId>
        <DomainName>test.com</DomainName>
        <EndTime>2015-12-10T21:00Z</EndTime>
        <StartTime>2015-12-10T20:00Z</StartTime>
</DescribeDomainBpsDataResponse>

如何查询网络带宽?

相关课程

相关电子书

相关实验场景

如何查询网络带宽?

相关课程

相关文章

相关电子书

相关实验场景