雲端錄製用量查詢。
介面說明
-
統計每日雲端錄製各規格下的錄製時長。
-
支援到即時音訊影片應用程式粒度查詢。
QPS 限制
本介面的單使用者 QPS 限制為 10 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理呼叫。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
live:DescribeLiveRtcRecordUsageData |
none |
*全部資源。
|
無 | 無 |
請求文法
GET HTTP/1.1請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| StartTime |
string |
是 |
取得資料起始時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。 |
2017-12-21T08:00:00Z |
| EndTime |
string |
是 |
結束時間。查詢粒度 ≥5 分鐘且 ≤31 天。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。 |
2022-10-10T21:00:00Z |
| AppId |
string |
是 |
即時音訊影片應用程式 ID。可在即時音訊影片應用程式管理中檢視。透過存取 影片直播>直播+>即時音訊影片>應用程式管理 可以檢視擁有的應用程式 ID。 |
intl7f92-a5a8*************7ce4eb44a6 |
| RecordMode |
string |
是 |
錄製模式：
|
0 |
| Interval |
string |
否 |
查詢資料的時間粒度。單位：秒。取值：
|
3600 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
Schema of Response |
||
| RequestId |
string |
Id of the request |
16A96B9A-F2*************B92E68F4CD8 |
| RecordMode |
string |
錄製模式。
|
0 |
| AppId |
string |
需要查詢的即時音訊影片應用程式 ID。 |
7fd341b3-c6fa-43e1-96b8-7295a1dd**** |
| TotalSummaryDuration |
number |
彙總時長，單位：秒。 |
150 |
| AudioSummaryDuration |
number |
純音訊彙總時長，單位：秒。 |
20 |
| V480SummaryDuration |
number |
480P 及以下影片彙總時長，單位：秒。 |
30 |
| V720SummaryDuration |
number |
720P 及以下影片彙總時長，單位：秒。 |
40 |
| V1080SummaryDuration |
number |
720P 以上（含 1080P）影片彙總時長，單位：秒。 |
10 |
| Data |
array<object> |
用量統計資訊。 |
|
|
object |
用量統計資訊。 |
||
| Timestamp |
string |
資料統計時刻。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。 |
2022-10-10T20:00:00Z |
| TotalDuration |
number |
全部時長，單位：秒。 |
150 |
| AudioDuration |
number |
純音訊時長，單位：秒。 |
20 |
| V480Duration |
number |
480P 及以下影片時長，單位：秒。 |
30 |
| V720Duration |
number |
720P 及以下影片時長，單位：秒。 |
40 |
| V1080Duration |
number |
720P 以上影片時長，單位：秒。 |
10 |
樣本
正常返回樣本
JSON格式
{
"RequestId": "16A96B9A-F2*************B92E68F4CD8",
"RecordMode": "0",
"AppId": "7fd341b3-c6fa-43e1-96b8-7295a1dd****",
"TotalSummaryDuration": 150,
"AudioSummaryDuration": 20,
"V480SummaryDuration": 30,
"V720SummaryDuration": 40,
"V1080SummaryDuration": 10,
"Data": [
{
"Timestamp": "2022-10-10T20:00:00Z",
"TotalDuration": 150,
"AudioDuration": 20,
"V480Duration": 30,
"V720Duration": 40,
"V1080Duration": 10
}
]
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | InvalidStartTime.ValueNotSupported | The specified value of parameter StartTime is not supported. | 傳入的 StartTime 參數不支援。 |
| 400 | InvalidEndTime.Mismatch | Specified end time does not math the specified start time. | 結束時間與開始時間不匹配，請您確認時間的匹配度。 |
| 400 | InvalidRecordModeParameter | RecordMode parameter error. | RecordMode參數錯誤。 |
| 400 | InvalidAppIdParameter | AppId parameter error. | AppId參數錯誤。 |
| 400 | InvalidTimeSpan | The time span exceeds the limit. | 時間跨度超過限制，請參照介面文件，設定合理查詢跨度。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。