全部产品
云市场

查询存储用量数据

更新时间:2019-05-16 10:30:51

描述

查询媒资管理(存储空间、存储流出流量)的用量数据。

  • 注意:起始结束时间间隔在7天以内时,返回小时粒度的数据;大于7天时,返回天粒度的数据;最大间隔为31天。

请求参数

名称 类型 必填项 描述
Action String 操作接口名。系统规定参数,取值:DescribeVodStorageData
StartTime String 获取数据起始时间点。
日期格式按照ISO8601表示法,并使用UTC时间。
格式为:YYYY-MM-DDThh:mm:ssZ
EndTime String 获取数据结束时间点,需大于起始时间。
日期格式按照ISO8601表示法,并使用UTC时间。
格式为:YYYY-MM-DDThh:mm:ssZ
Region String 存储区域。
默认返回所有区域。
支持批量查询,多个区域用逗号(半角)分隔。
取值范围:cn-shanghai(上海)、cn-beijing(北京)、eu-central-1(德国)、ap-southeast-1(新加坡)
Storage String 存储名称(阿里云OSS存储Bucket名称),默认返回所有存储。
支持批量查询,多个用逗号(半角)分隔

返回参数

名称 类型 必填项 描述
RequestId String 请求ID。
DataInterval String 返回数据的时间颗粒度。
取值范围:hour(小时数据),day(天数据)
StorageData StorageDataItem 存储用量数据。

StorageDataItem

字段名 类型 必填项 取值
StorageUtilization Long 存储用量数据。
NetworkOut Long 存储流出流量。
此流量指直接访问存储地址产生的流量,未经CDN加速。
TimeStamp String 时间片起始时刻。

API示例

请求示例

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

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

返回示例

  1. {
  2. "RequestId": "C370DAF1-C838-4288-A1A0-9A87633D248E",
  3. "DataInterval": "day",
  4. "StorageData": {
  5. "StorageDataItem": [
  6. {
  7. "StorageUtilization": 111111,
  8. "NetworkOut": 111111,
  9. "TimeStamp": "2019-02-01T16:00:00Z"
  10. },
  11. {
  12. "StorageUtilization": 111111,
  13. "NetworkOut": 111111,
  14. "TimeStamp": "2019-02-02T16:00:00Z"
  15. },
  16. ]
  17. }
  18. }

错误码

错误代码 描述 Http状态码 语义
Throttling Request was denied due to request throttling. 503 请求被流量控制限制
OperationDenied Your account does not open VOD service yet. 403 未开通VOD服务
OperationDenied Your VOD service is suspended. 403 VOD服务已被停止
InvalidParameter Invalid Parameter. 400 参数错误
InvalidParameterAliUid Invalid Parameter AliUid. 400 AliUid参数错误
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天
InvalidParameterRegion Invalid Parameter Region. 400 Region参数错误