查询转码用量数据_用量数据_数据统计_服务端API

描述

查询转码用量数据。

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

请求参数

名称	类型	必填项	描述
Action	String	是	操作接口名。系统规定参数，取值：DescribeVodTranscodeData
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名称），默认返回所有存储。支持批量查询，多个用逗号（半角）分隔。
Specification	String	否	转码规格，默认返回所有转码规格。支持批量查询，多个用逗号（半角）分隔。取值范围：Audio（音频）、Segmentation（转封装）、H264.LD、H264.SD、H264.HD、H264.2K、H264.4K等

返回参数

名称	类型	必填项	描述
RequestId	String	是	请求ID。
DataInterval	String	是	返回数据的时间颗粒度。取值范围：hour（小时数据），day（天数据）
TranscodeData	TranscodeDataItem	是	转码用量数据。

TranscodeDataItem

字段名	类型	必填项	取值
TimeStamp	String	是	数据时间。
Data	DataItem	是	转码用量详细数据。

DataItem

字段名	类型	必填项	取值
Name	String	是	转码规格。取值范围：Audio（音频）、Segmentation（转封装）、H264.LD、H264.SD、H264.HD、H264.2K、H264.4K等
Value	Long	是	转码时长，单位：秒

API示例

请求示例

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

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

返回示例

{
  "RequestId": "C370DAF1-C838-4288-A1A0-9A87633D248E",
  "DataInterval": "day",
  "TranscodeData": {
    "TranscodeDataItem": [
      {
        "TimeStamp": "2019-02-01T16:00:00Z",
        "Data": {
          "DataItem": [
            {
              "Name": "H264.SD",
              "Value": 111
            },
            {
              "Name": "All",
              "Value": 111
            }
          ]
        }
      },
      {
        "TimeStamp": "2019-02-02T16:00:00Z",
        "Data": {
          "DataItem": [
            {
              "Name": "Audio",
              "Value": 111
            },
            {
              "Name": "H264.SD",
              "Value": 222
            },
            {
              "Name": "All",
              "Value": 333
            }
          ]
        }
      },
    ]
  }
}

错误码

错误代码	描述	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参数错误