调用DescribeVodTranscodeData查询转码用量数据。
- 目前仅支持上海地域。
- 当起始结束时间间隔在7天以内时,返回小时粒度的数据;当起始结束时间间隔大于7天时,返回天粒度的数据;最大间隔为31天。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeVodTranscodeData |
系统规定参数。取值:DescribeVodTranscodeData。 |
EndTime | String | 是 | 2019-02-01T15:59:00Z |
获取数据结束时间点,需晚于起始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
StartTime | String | 是 | 2019-02-01T15:00:00Z |
获取数据起始时间点。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
Region | String | 否 | cn-shanghai |
存储地域。默认返回所有区域。支持批量查询,多个地域使用半角逗号(,)分隔。取值:
|
Interval | String | 否 | day |
时间粒度。取值:
|
Storage | String | 否 | bucket01 |
存储名称(阿里云OSS存储Bucket名称)。默认返回所有存储。支持批量查询,多个用半角逗号(,)分隔。 |
Specification | String | 否 | Audio |
转码规格,默认返回所有转码规格。支持批量查询,多个用半角逗号(,)分隔。取值:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
DataInterval | String | day |
返回数据的时间颗粒度。取值:
|
RequestId | String | C370DAF1-C838-4288-****-9A87633D248E |
请求ID。 |
TranscodeData | Array of TranscodeDataItem |
转码用量数据。 |
|
TranscodeDataItem | |||
Data | Array of DataItem |
转码用量详细数据。 |
|
DataItem | |||
Name | String | H264.SD |
转码规格。取值:
|
Value | String | 111 |
转码时长。单位:秒。 |
TimeStamp | String | 2019-02-01T16:00:00Z |
数据时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
示例
请求示例
https://vod.aliyuncs.com/?Action=DescribeVodTranscodeData
&EndTime=2019-02-01T15:59:00Z
&StartTime=2019-02-01T15:00:00Z
&<公共请求参数>
正常返回示例
XML
格式
<DescribeVodTranscodeDataResponse>
<RequestId>C370DAF1-C838-4288-****-9A87633D248E</RequestId>
<DataInterval>day</DataInterval>
<TranscodeData>
<TranscodeDataItem>
<TimeStamp>2019-02-01T16:00:00Z</TimeStamp>
<Data>
<DataItem>
<Name>H264.SD</Name>
<Value>111</Value>
</DataItem>
<DataItem>
<Name>All</Name>
<Value>111</Value>
</DataItem>
</Data>
</TranscodeDataItem>
<TranscodeDataItem>
<TimeStamp>2019-02-02T16:00:00Z</TimeStamp>
<Data>
<DataItem>
<Name>Audio</Name>
<Value>111</Value>
</DataItem>
<DataItem>
<Name>H264.SD</Name>
<Value>222</Value>
</DataItem>
<DataItem>
<Name>All</Name>
<Value>333</Value>
</DataItem>
</Data>
</TranscodeDataItem>
</TranscodeData>
</DescribeVodTranscodeDataResponse>
JSON
格式
{
"RequestId": "C370DAF1-C838-4288-****-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 |
EndTime和StartTime差值不能超过31天。 |
InvalidParameterRegion |
Invalid Parameter Region. |
400 |
Region参数错误。 |
在文档使用中是否遇到以下问题
更多建议
匿名提交