調用DescribeLiveDomainRecordUsageData查詢直播錄制路數、轉封裝用量。
使用說明
- 統計每日錄制并發路數、不同時間間隔打點數據。可以用來統計每日并發錄制峰值路數、每月并發錄制峰值路數。
- 時移的路數不會被包含在錄制路數中重復計算。
- 支持到域名粒度查詢,支持批量域名查詢。批量查詢時多個域名用英文逗號(,)分隔。
- 數據粒度1分鐘,最長查詢跨度24小時,最長保存時間60天。
- 數據粒度1小時,最長查詢跨度31天,最長保存時間180天。
- 數據粒度1天,最長查詢跨度90天,最長保存時間366天。
QPS限制
本接口的單用戶QPS限制為10次/秒。超過限制,API調用會被限流,這可能會影響您的業務,請合理調用。更多信息,請參見QPS限制。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | DescribeLiveDomainRecordUsageData | 系統規定參數。取值:DescribeLiveDomainRecordUsageData。 |
DomainName | String | 否 | example.com | 需要查詢的主播流域名。
|
StartTime | String | 否 | 2021-05-10T20:00:00Z | 起始時間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時間)。
說明 起始時間最早可設置為從當前時間開始的90天內,精確到秒。 |
EndTime | String | 否 | 2021-05-10T21:00:00Z | 結束時間,格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時間)。取值要求:
|
Region | String | 否 | cn-shanghai | 地區。取值:
|
SplitBy | String | 否 | domain,record_fmt | 分組鍵。取值:
說明 可選一個,也可多選。多選時用英文逗號(,)分隔。默認為 domain,record_fmt 。置為空或null 的時候即不區分上述鍵。 |
Interval | String | 否 | 300 | 查詢數據的時間粒度。單位:秒。取值:
說明 不傳或傳值不支持時,查詢時間跨度在31天以內的時間粒度默認值為300秒;查詢時間跨度大于31天的時間粒度默認值為86400。 |
返回數據
名稱 |
類型 |
示例值 |
描述 |
EndTime | String | 2021-05-10T21:00:00Z | 結束時間。 |
StartTime | String | 2021-05-10T20:00:00Z | 起始時間。 |
RequestId | String | 4B460F8B-993C-4F48-B98A-910811DEBFEB | 請求ID。 |
RecordUsageData | Array of DataModule | 每個時間間隔的錄制用量數據。 |
|
DataModule | |||
Type | String | MP4 | 錄制文件類型。 請求參數SplitBy取值包含 |
Domain | String | example.com | 主播流域名。 請求參數SplitBy取值包含 |
Region | String | cn-shanghai | 地區。 |
TimeStamp | String | 2021-05-10T20:00:00Z | 起始時刻。 |
Duration | Long | 3560 | 錄制時長用量,單位:秒。 |
Count | Long | 1 | 峰值路數。 |
示例
請求示例
http(s)://live.aliyuncs.com/?Action=DescribeLiveDomainRecordUsageData
&StartTime=2021-05-10T20:00:00Z
&EndTime=2021-05-10T21:00:00Z
&<公共請求參數>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeLiveDomainRecordUsageDataResponse>
<StartTime>2021-05-10T20:00:00Z</StartTime>
<EndTime>2021-05-10T21:00:00Z</EndTime>
<RequestId>4B460F8B-993C-4F48-B98A-910811DEBFEB</RequestId>
<RecordUsageData>
<DataModule>
<Type>MP4</Type>
<Duration>3560</Duration>
<Count>1</Count>
<Domain>example.com</Domain>
<TimeStamp>2021-05-10T20:00:00Z</TimeStamp>
</DataModule>
</RecordUsageData>
</DescribeLiveDomainRecordUsageDataResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"DescribeLiveDomainRecordUsageDataResponse" : {
"StartTime" : "2021-05-10T20:00:00Z",
"EndTime" : "2021-05-10T21:00:00Z",
"RequestId" : "4B460F8B-993C-4F48-B98A-910811DEBFEB",
"RecordUsageData" : {
"DataModule" : {
"Type" : "MP4",
"Duration" : 3560,
"Count" : 1,
"Domain" : "example.com",
"TimeStamp" : "2021-05-10T20:00:00Z"
}
}
}
}
錯誤碼
HttpCode |
錯誤碼 |
錯誤信息 |
描述 |
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | StartTime參數錯誤,請您確認該StartTime參數是否正確。 |
400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | 結束時間錯誤,請您確認結束時間是否正確。 |
400 | InvalidEndTime.Mismatch | Specified end time does not math the specified start time. | 結束時間與開始時間不匹配,請您確認時間的匹配度。 |
400 | InvalidTimeSpan | The time span exceeds the limit. | 時間跨度超過限制,請參照接口文檔,配置合理查詢跨度。 |
400 | InvalidRecordFmt.NotSupported | The RecordFmt parameter is not supported. | RecordFmt不支持查詢輸入的類型,請輸入文檔指定的格式 |
400 | InvalidStartTime.ValueNotSupported | The specified value of parameter StartTime is not supported. | 傳入的StartTime參數不支持。 |
訪問錯誤中心查看更多錯誤碼。
特殊錯誤碼
錯誤代碼 |
描述 |
HTTP 狀態碼 |
語義 |
Throttling |
Request was denied due to request throttling. |
503 |
請求被流量控制限制。 |
InvalidDomain.NotFound |
The domain provided does not belong to you. |
404 |
域名不存在或不屬于當前用戶。 |