1つ以上のドメイン名のタイムシフトのリソース使用量データを照会します。

使用状況ノート

  • 複数のドメイン名を指定し、コンマ (,) で区切ることができます。
  • 最大で過去90日間のデータをクエリできます。
  • 返されるエントリ間の時間間隔は1時間です。
  • The maximum time range in which the data can be queried in a call is 31 days.

QPS制限

1人のユーザーが1分あたり最大10件のクエリを実行できます。 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 スロットルはビジネスに影響を与える可能性があります。 したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。

デバッグ

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

リクエストパラメーター

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

実行する操作です。 値をDescribeLiveDomainTimeShiftDataに設定します。

DomainName String 任意 example.com

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

  • このパラメーターを設定しない場合、すべてのドメイン名のマージされたデータが返されます。
  • 複数のドメイン名を指定し、コンマ (,) で区切ることができます。
StartTime String 任意 2021-03-03T00:00:00Z

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

  • 最小クエリ間隔は5分です。
  • このパラメーターを設定しない場合、過去24時間のデータが返されます。
EndTime String 任意 2021-03-03T02:00:00Z

照会する時間範囲の終わり。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。 時間は UTC にする必要があります。 終了時間は開始時間より遅くする必要があります。

間隔 String 任意 300

データが照会される時間間隔。 (単位:秒) 設定可能な値は以下のとおりです。

  • 300
  • 3600
  • 86400

このパラメーターを設定しない場合、または指定された値が無効な場合は、デフォルト値300が使用されます。

レスポンスパラメーター

パラメーター データ型 説明
RequestId String 8AE1CB3A-6510-442E-A6B9-EF03D05B3E09

リクエストの ID です。

TimeShiftData DataModuleの配列

時間間隔ごとに収集されたタイムシフトのリソース使用量データ。

DataModule
Size String 1664165660

タイムシフトのストレージ使用量。 単位: バイト。

タイムスタンプ String 2021-03-03T00:00:00Z

返されたデータのタイムスタンプ。

データ型 String HLS_D7

タイムシフトのタイプ。 例: HLS_D1およびHLS_D7。

リクエストの例

http(s):// live.aliyuncs.com/?Action=DescribeLiveDomainTimeShiftData
&StartTime=2021-03-03T00:00:00Z
&EndTime=2021-03-03T02:00:00Z
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

<DescribeLiveDomainTimeShiftDataResponse>
      <TimeShiftData>
            <DataModule>
                  <タイプ> HLS_D7</タイプ>
                  <サイズ> 1664165660</サイズ>
                  <タイムスタンプ> 2021-03-03T00:00:00Z</タイムスタンプ>
            </DataModule>
            <DataModule>
                  <タイプ> HLS_D7</タイプ>
                  <サイズ> 1308431308</サイズ>
                  <タイムスタンプ> 2021-03-03T01:00:00Z</タイムスタンプ>
            </DataModule>
      </TimeShiftData>
      <RequestId>E8942890-A783-4456-BEF8-81FDDD8F8F3C</RequestId>
</DescribeLiveDomainTimeShiftDataResponse>

JSON 形式

{
    "TimeShiftData": {
        "DataModule": [
            {
                "タイプ": "HLS_D7" 、
                「サイズ」: 1664165660、
                "タイムスタンプ": "2021-03-03T00:00:00Z"
            },
            {
                "タイプ": "HLS_D7" 、
                「サイズ」: 1308431308、
                "TimeStamp": "2021-03-03T01:00:00Z"
            }
        ]
    },
    "RequestId": "E8942890-A783-4456-BEF8-81FDDD8F8F3C"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
400 InvalidStartTime.Malformed 指定された StartTime は不正です。 開始時刻の形式が無効な場合に返されるエラーメッセージ。 StartTimeパラメーターの値が有効かどうかを確認します。
400 InvalidEndTime.Malformed 指定された EndTime は不正です。 終了時刻の形式が無効な場合に返されるエラーメッセージ。 EndTimeパラメーターの値が有効かどうかを確認します。
400 InvalidEndTime. ミスマッチ 指定された終了時間は、指定された開始時間を計算しません。 終了時刻が開始時刻より前の場合に返されるエラーメッセージ。 StartTimeパラメーターとEndTimeパラメーターの値が有効かどうかを確認します。

エラーコードリストについては、「API エラーセンター」をご参照ください。

特殊エラーコード

エラーコード

エラーメッセージ

HTTP ステータスコード

説明

Throttling

Request was denied due to request throttling.

503

帯域幅調整が行われ、リクエストが拒否された場合に返されるエラーメッセージです。

InvalidDomain.NotFound

The domain provided does not belong to you.

404

ドメイン名が存在しないか、現在のユーザーに属していない場合に返されるエラーメッセージ。