描述
查询转码用量数据。
- 注意:起始结束时间间隔在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参数错误 |
原创文章,作者:网友投稿,如若转载,请注明出处:https://www.cloudads.cn/archives/33343.html