すべてのプロダクト
Search
ドキュメントセンター

ApsaraVideo Live:DescribeLiveDomainRecordUsageData

最終更新日:Jul 18, 2024

ライブ録画チャンネル数とコンテナ形式の変換数を照会します。

使用状況ノート

  • この操作を呼び出して、毎日の同時録画チャンネル数と、さまざまな時間間隔でのイベント追跡データを照会できます。 これらは、各日または月の同時記録チャネルのピーク数を測定するために使用できます。
  • 時間シフトされたチャネルの数は、記録チャネルの数には含まれない。
  • ドメイン名でデータを照会するか、複数のドメイン名のデータを照会できます。 複数のドメイン名のデータをクエリする場合は、ドメイン名をコンマ (,) で区切ります。
  • 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制限」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーターデータ型必須/任意説明
操作String必須DescribeLiveDomainRecordUsageData

実行する操作です。 値を

DescribeLiveDomainRecordUsageDataです。

StartTimeString必須2021-05-10T20:00:00Z

クエリする期間の開始時刻です。 yyyy-MM-dd T HH:mm:ss Z形式のISO 8601標準で時刻を指定します。 時間は UTC にする必要があります。

  • 最小クエリ間隔は5分です。
  • このパラメーターを設定しない場合、過去24時間のデータが返されます。
説明 最も早い開始時刻は、現在の時刻から90日以内、正確に秒に設定できます。
EndTimeString必須2021-05-10T21:00:00Z

クエリする期間の終了時刻を設定します。 yyyy-MM-dd T HH:mm:ss Z形式のISO 8601標準で時刻を指定します。 時間は UTC にする必要があります。 時間は次の要件を満たす必要があります。

  • 開始時間より遅く。
  • 終了時間と開始時間の間の時間範囲は最大31日です。 期間が31日を超えると、リクエストは失敗し、エラーが報告されます。
RegionIdString任意cn-shanghai

ドメイン名のリージョンID。

DomainNameString任意example.com

照会するメインのストリーミングドメイン。

  • 1つ以上のドメイン名を照会できます。 複数のドメイン名のデータをクエリする場合は、コンマ (,) で区切ります。
  • このパラメーターを設定しない場合、所属するすべてのドメイン名のデータが返されます。
SplitByString任意ドメイン、record_fmt

データをグループ化するために使用されるキー。 設定可能な値は以下のとおりです。

  • domain: クエリ結果はドメイン名でグループ化されます。
  • record_fmt: クエリ結果は、記録タイプによってグループ化されます。

1つまたは両方のオプションのみを選択できます。 両方のオプションを選択する場合は、コンマ (,) で区切ります。

デフォルト値はdomain,record_fmtです。 空のままか、値がnullの場合、このパラメーターは無視されます。

レスポンスパラメーター

パラメーターデータ型説明
RecordUsageDataDataModuleの配列

インターバルごとに収集された記録データ。

DataModule
CountLong1

ピークチャンネル。

ドメインStringexample.com

メインのストリーミングドメイン。

このパラメーターは、リクエストパラメーターSplitByの値にdomainが含まれている場合に返されます。

有効期間Long3560

記録時間 (分) 。

タイムスタンプString2021-05-10T20:00:00Z

録音を開始する時間。

データ型StringMP4

記録ファイルの種類。

このパラメーターは、リクエストパラメーターSplitByの値にrecord_fmtが含まれている場合に返されます。

RequestIdString4B460F8B-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エラーコードエラーメッセージ説明
400InvalidStartTime.Malformed指定された StartTime は不正です。開始時刻の形式が無効な場合に返されるエラーメッセージ。 StartTimeパラメーターの値が有効かどうかを確認します。
400InvalidEndTime.Malformed指定された EndTime は不正です。終了時刻の形式が無効な場合に返されるエラーメッセージ。 EndTimeパラメーターの値が有効かどうかを確認します。
400InvalidEndTime. ミスマッチ指定された終了時間は、指定された開始時間を計算しません。終了時刻が開始時刻よりも遅くない場合、または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アカウントに属していない場合に返されるエラーメッセージ。