ライブ録画チャンネル数とコンテナ形式の変換数を照会します。
使用状況ノート
- この操作を呼び出して、毎日の同時録画チャンネル数と、さまざまな時間間隔でのイベント追跡データを照会できます。 これらは、各日または月の同時記録チャネルのピーク数を測定するために使用できます。
- 時間シフトされたチャネルの数は、記録チャネルの数には含まれない。
- ドメイン名でデータを照会するか、複数のドメイン名のデータを照会できます。 複数のドメイン名のデータをクエリする場合は、ドメイン名をコンマ (,) で区切ります。
- You can query data generated over the past 90 days.
- データ間隔は、データクエリの時間粒度を表します。 The data interval is fixed to one hour. データ間隔はカスタマイズできません。
- データを照会できる最大期間は31日です。
QPS制限
1人のユーザーが1分あたり最大10件のクエリを実行できます。 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 スロットルはビジネスに影響を与える可能性があります。 したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。
デバッグ
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 例 | 説明 |
操作 | String | 必須 | DescribeLiveDomainRecordUsageData | 実行する操作です。 値を DescribeLiveDomainRecordUsageDataです。 |
StartTime | String | 必須 | 2021-05-10T20:00:00Z | クエリする期間の開始時刻です。 yyyy-MM-dd T HH:mm:ss Z形式のISO 8601標準で時刻を指定します。 時間は UTC にする必要があります。
説明 最も早い開始時刻は、現在の時刻から90日以内、正確に秒に設定できます。 |
EndTime | String | 必須 | 2021-05-10T21:00:00Z | クエリする期間の終了時刻を設定します。 yyyy-MM-dd T HH:mm:ss Z形式のISO 8601標準で時刻を指定します。 時間は UTC にする必要があります。 時間は次の要件を満たす必要があります。
|
RegionId | String | 任意 | cn-shanghai | ドメイン名のリージョンID。 |
DomainName | String | 任意 | example.com | 照会するメインのストリーミングドメイン。
|
SplitBy | String | 任意 | ドメイン、record_fmt | データをグループ化するために使用されるキー。 設定可能な値は以下のとおりです。
1つまたは両方のオプションのみを選択できます。 両方のオプションを選択する場合は、コンマ (,) で区切ります。 デフォルト値は |
レスポンスパラメーター
パラメーター | データ型 | 例 | 説明 |
RecordUsageData | DataModuleの配列 | インターバルごとに収集された記録データ。 | |
DataModule | |||
Count | Long | 1 | ピークチャンネル。 |
ドメイン | String | example.com | メインのストリーミングドメイン。 このパラメーターは、リクエストパラメーターSplitByの値に |
有効期間 | Long | 3560 | 記録時間 (分) 。 |
タイムスタンプ | String | 2021-05-10T20:00:00Z | 録音を開始する時間。 |
データ型 | String | MP4 | 記録ファイルの種類。 このパラメーターは、リクエストパラメーターSplitByの値に |
RequestId | String | 4B460F8B-993C-4F48-B98A-910811DEBFEB | リクエストの ID です。 |
例
リクエストの例
http(s):// live.aliyuncs.com/?Action=DescribeLiveDomainRecordUsageData
&DomainNam e=example.com
&StartTime=2021-05-10T20:00:00Z
&EndTime=2021-05-10T21:00:00Z
&<共通リクエストパラメーター>
正常に処理された場合のレスポンス例
XML
形式
<DescribeLiveDomainRecordUsageDataResponse>
<RequestId>4B460F8B-993C-4F48-B98A-910811DEBFEB</RequestId>
<RecordUsageData>
<DataModule>
<タイプ> MP4</タイプ>
<期間> 3560</期間>
<Count>1</Count>
<Domain>example.com</Domain>
<タイムスタンプ> 2021-05-10T20:00:00Z</タイムスタンプ>
</DataModule>
<DataModule>
<タイプ> TS</タイプ>
<Duration>3476</Duration>
<Count>1</Count>
<Domain>example.com</Domain>
<タイムスタンプ> 2021-05-10T20:00:00Z</タイムスタンプ>
</DataModule>
</RecordUsageData>
</DescribeLiveDomainRecordUsageDataResponse>
JSON
形式
{
"RequestId": "4B460F8B-993C-4F48-B98A-910811DEBFEB" 、
"RecordUsageData": {
"DataModule": [
{
"タイプ": "MP4" 、
"期間": 3560、
"カウント": 1、
"ドメイン": "example.com" 、
"タイムスタンプ": "2021-05-10T20:00:00Z"
},
{
"タイプ": "TS" 、
"期間": 3476、
"カウント": 1、
"ドメイン": "example.com" 、
"タイムスタンプ": "2021-05-10T20:00:00Z"
}
]
}
}
エラーコード
HttpCode | エラーコード | エラーメッセージ | 説明 |
400 | InvalidStartTime.Malformed | 指定された StartTime は不正です。 | 開始時刻の形式が無効な場合に返されるエラーメッセージ。 StartTimeパラメーターの値が有効かどうかを確認します。 |
400 | InvalidEndTime.Malformed | 指定された EndTime は不正です。 | 終了時刻の形式が無効な場合に返されるエラーメッセージ。 EndTimeパラメーターの値が有効かどうかを確認します。 |
400 | InvalidEndTime. ミスマッチ | 指定された終了時間は、指定された開始時間を計算しません。 | 終了時刻が開始時刻よりも遅くない場合、またはStartTimeパラメーターとEndTimeパラメーターで指定された時間範囲が31日を超えている場合に返されるエラーメッセージ。 StartTimeパラメーターとEndTimeパラメーターの値が有効かどうかを確認します。 |
エラーコードリストについては、「API エラーセンター」をご参照ください。
Special error codes
エラーコード | エラーメッセージ | HTTP ステータスコード | 説明 |
Throttling | Request was denied due to request throttling. | 503 | 帯域幅調整が行われ、リクエストが拒否された場合に返されるエラーメッセージです。 |
InvalidDomain.NotFound | The domain provided does not belong to you. | 404 | ドメイン名が存在しないか、Alibaba Cloudアカウントに属していない場合に返されるエラーメッセージ。 |