查询流量带宽用量数据_用量数据_数据统计_服务端API

描述

查询加速流量/带宽用量数据。

支持批量域名查询，多个域名用逗号（半角）分隔,最多可以一次查询100个域名.如果为空则返回账号下所有域名的数据。
最长可查询近1年的数据，单次查询跨度最长为3个月,查询时间为1-3天时，数据按小时粒度返回，查询时间大于4天，数据按天粒度返回。

请求参数

名称	类型	必填项	描述
Action	String	是	操作接口名。系统规定参数，取值：DescribeVodDomainUsageData
StartTime	String	是	获取数据起始时间点。日期格式按照ISO8601表示法，并使用UTC时间。格式为：YYYY-MM-DDThh:mm:ssZ
EndTime	String	是	获取数据结束时间点，需大于起始时间。日期格式按照ISO8601表示法，并使用UTC时间。格式为：YYYY-MM-DDThh:mm:ssZ
Field	String	是	数据类型。取值范围：bps（带宽）、traf（流量）
Area	String	否	区域代号，默认为CN中国大陆。取值范围：CN（中国大陆）、OverSeas（海外区域）
DomainName	String	否	加速域名。若参数为空，默认返回所有加速域名合并后数据。支持批量查询，多个用逗号（半角）分隔

返回参数

名称	类型	必填项	描述
RequestId	String	是	请求ID
StartTime	String	是	开始时间
EndTime	String	是	结束时间
Type	String	是	用量类型
Area	String	是	用量区域
DomainName	String	否	加速域名信息
DataInterval	String	是	每条记录的时间间隔。单位：秒
UsageDataPerInterval	UsageData	是	流量/带宽用量数据

UsageData

字段名	类型	必填项	取值
TimeStamp	String	是	时间片起始时刻。
Value	String	是	流量/带宽用量。

API示例

请求示例

http://vod.cn-shanghai.aliyuncs.com/?Action=DescribeVodDomainUsageData&StartTime=xxx&EndTime=xxx&Field=xxx&Format=JSON&<公共参数>

注意：示例中的“公共参数”参见公共参数说明文档。

返回示例

{
    "RequestId": "B955107D-E658-4E77-B913-E0AC3D31693E",
    "StartTime": "2015-12-10T20:00Z",
    "EndTime": "2015-12-10T21:00Z",
    "Area": "CN",
    "Type": "traf"
    "DomainName": "example.com",
    "DataInterval": "300",
    "UsageDataPerInterval": {
        "UsageData": [
            {
                "TimeStamp": "2015-12-10T20:00:00Z",
                "Value": 2592.3920000000003
            },
            {
                "TimeStamp": "2015-12-10T20:05:00Z",
                "Value": 2592.3920000000003
            }
        ]
    }
}

错误码

错误代码	描述	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	域名配置失败
InvalidParameter	Invalid Parameter.	400	参数错误
InvalidParameterProduct	Invalid Parameter Product.	400	Product参数错误
InvalidParameterArea	Invalid Parameter Area.	400	Area参数错误
InvalidParameterField	Invalid Parameter Field.	400	Field参数错误
InvalidParameterStartTime	Invalid Parameter StartTime.	400	StartTime参数错误
InvalidParameterEndTime	Invalid Parameter EndTime.	400	EndTime参数错误
InvalidTimeRange	StartTime and EndTime range should less than 1 month.	400	SndTime和StartTime差值不能超过31天
InvalidParameterInterval	Invalid Parameter Interval.	400	Interval参数错误