調用DescribeLiveDomainStreamTranscodeData查詢域名轉碼用量數據。
使用說明
- 可以用來統計每個時間間隔的網絡帶寬數據。
- 支持批量域名查詢,多個域名用英文逗號(,)分隔。
- 最多可獲取最近90天的數據。
- 數據時間粒度為小時或天。
- 不同轉碼類型與轉碼分辨率對應的計費檔次,請參見直播轉碼計費說明中的轉碼賬單中不同實例規格對應的轉碼計費檔次說明。
QPS限制
本接口的單用戶QPS限制為20次/秒。超過限制,API調用會被限流,這可能會影響您的業務,請合理調用。更多信息,請參見QPS限制。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | DescribeLiveDomainStreamTranscodeData | 系統規定參數。取值:DescribeLiveDomainStreamTranscodeData。 |
DomainName | String | 否 | example.com | 可輸入需要查詢的主播流域名。
|
StartTime | String | 是 | 2017-12-10T20:00:00Z | 查詢起始時間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時間)。
|
EndTime | String | 是 | 2017-12-10T22:00:00Z | 查詢結束時間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時間)。 |
Precision | String | 否 | min | 查詢的時間精度。取值:
|
Interval | String | 否 | 3600 | 查詢的時間粒度。單位:秒。取值:
說明 不填默認按小時。 |
Split | String | 否 | domain | 分組鍵。取值:
可選一個,也可多選,用英文逗號(,)分隔。 默認為 |
返回數據
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | 3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F | 請求ID。 |
TranscodeDataList | Array of TranscodeData | 每個時間間隔的網絡帶寬數據。 |
|
TranscodeData | |||
TanscodeType | String | H264STD | 轉碼類型。取值: 說明 如果請求參數Split(分組鍵)為transcode_type時,此返回參數才生效。
|
Domain | String | example.com | 主播流域名。 說明 如果請求參數Split(分組鍵)為domain時,此返回參數才生效。 |
Region | String | cn-beijing | 域名所屬地域。 取值: 說明 如果請求參數Split(分組鍵)為region時,此返回參數才生效。
|
Duration | Integer | 2000 | 時長。單位:分鐘。 |
TimeStamp | String | 2017-12-10T20:00:00Z | 時間片起始時刻。 |
Fps | String | normal | 幀率。 說明 如果請求參數Split(分組鍵)為fps時,此返回參數才生效。 |
Resolution | String | HD | 分辨率。取值: 說明 如果請求參數Split(分組鍵)為resolution時,此返回參數才生效。
|
示例
請求示例
http(s)://live.aliyuncs.com/?Action=DescribeLiveDomainStreamTranscodeData
&StartTime=2017-12-10T20:00:00Z
&EndTime=2017-12-10T22:00:00Z
&<公共請求參數>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<?xml version="1.0" encoding="UTF-8" ?>
<DescribeLiveDomainStreamTranscodeDataResponse>
<RequestId>3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F</RequestId>
<TranscodeDataList>
<TranscodeData>
<Fps>normal</Fps>
<Region>cn-beijing</Region>
<Duration>2000</Duration>
<TanscodeType>H264STD</TanscodeType>
<Domain>example.com</Domain>
<TimeStamp>2017-12-10T20:00:00Z</TimeStamp>
<Resolution>HD</Resolution>
</TranscodeData>
</TranscodeDataList>
</DescribeLiveDomainStreamTranscodeDataResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"DescribeLiveDomainStreamTranscodeDataResponse" : {
"RequestId" : "3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F",
"TranscodeDataList" : {
"TranscodeData" : {
"Fps" : "normal",
"Region" : "cn-beijing",
"Duration" : 2000,
"TanscodeType" : "H264STD",
"Domain" : "example.com",
"TimeStamp" : "2017-12-10T20:00:00Z",
"Resolution" : "HD"
}
}
}
}
錯誤碼
HttpCode |
錯誤碼 |
錯誤信息 |
描述 |
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | StartTime參數錯誤,請您確認該StartTime參數是否正確。 |
400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | 結束時間錯誤,請您確認結束時間是否正確。 |
400 | InvalidParamPrecision | The parameter Precision is invalid, please check StartTime and EndTime or Precision. | Precision 參數錯誤,請檢查StartTime、EndTime或者Precision 參數。 |
400 | InvalidEndTime.Mismatch | Specified end time does not math the specified start time. | 結束時間與開始時間不匹配,請您確認時間的匹配度。 |
400 | InvalidTimeSpan | The time span exceeds the limit. | 時間跨度超過限制,請參照接口文檔,配置合理查詢跨度。 |
400 | InvalidStartTime.ValueNotSupported | The specified value of parameter StartTime is not supported. | 傳入的StartTime參數不支持。 |
訪問錯誤中心查看更多錯誤碼。
特殊錯誤碼
ErrorCode 錯誤碼 |
Message 錯誤信息 |
HTTP 狀態 |
語義 |
Throttling |
Request was denied due to request throttling. |
503 |
請求被流量控制限制。 |
InvalidDomain.NotFound |
The domain provided does not belong to you. |
404 |
域名不存在或不屬于當前用戶。 |