1つ以上の取り込みドメインのネットワークトラフィックデータを照会します。

使用状況ノート

  • ネットワークトラフィックデータの単位はビット /秒である。
  • カンマ (,) で区切って、複数の取り込みドメインのネットワークトラフィックデータを照会できます。
  • StartTimeパラメーターまたはEndTimeパラメーターを設定しない場合、過去24時間のデータが照会されます。 StartTimeおよびEndTimeパラメーターを設定すると、指定された時間範囲のデータが照会されます。
  • 過去90日以内のデータを照会できます。

QPS制限

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

デバッグ

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

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 DescribeLiveDomainPushTrafficData

実行する操作です。 値を

DescribeLiveDomainPushTrafficData。

DomainName String 任意 demo.aliyundoc.com

取り込みドメイン。

カンマ (,) で区切って、複数の取り込みドメインのネットワークトラフィックデータを照会できます。

このパラメーターを設定しない場合、すべての取り込みドメインのマージされたデータが返されます。

StartTime String 任意 2017-12-10T20:00:00Z

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

このパラメーターを設定しない場合、過去24時間のデータが返されます。

EndTime String 任意 2017-12-10T21:00:00Z

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

間隔 String 任意 300

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

  • 300
  • 3600
  • 86400

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

IspNameEn String 任意 alibaba

インターネットサービスプロバイダー (ISP) の名前。

ISPを照会するには、DescribeCdnRegionAndIsp操作を呼び出します。 このパラメーターを設定しない場合、すべてのISPのデータが返されます。

LocationNameEn String 任意 tianjin

データを照会するリージョンの名前。

リージョンを照会するには、DescribeCdnRegionAndIsp操作を呼び出します。 このパラメーターを設定しない場合、すべてのリージョンのデータが返されます。

レスポンスパラメーター

パラメーター データ型 例 説明
DataInterval String 300

データが照会された間隔。

DomainName String demo.aliyundoc.com

取り込みドメイン。

EndTime String 2017-12-10T21:00:00Z

データが照会された時間範囲の終了。

RequestId String 3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F

リクエストの ID です。

StartTime String 2017-12-10T20:00:00Z

データが照会された時間範囲の開始。

TrafficDataPerInterval DataModuleの配列

間隔ごとに収集されたネットワークトラフィックデータ。

DataModule
タイムスタンプ String 2017-12-10T20:05:00Z

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

TrafficValue String 1288111

ネットワークトラフィックデータ。 単位: バイト。

例

リクエストの例

http(s):// live.aliyuncs.com/?Action=DescribeLivePushDomainTrafficData
&DomainNam e=demo.aliyundoc.com
&StartTime=2017-12-10T20:00:00Z
&EndTime=2017-12-10T21:00:00Z
&<共通リクエストパラメーター>

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

XML 形式 

<DescribeLiveDomainPushTrafficDataResponse>
      <TrafficDataPerInterval>
            <DataModule>
                  <タイムスタンプ> 2017-12-10T20:00:00Z</タイムスタンプ>
                  <TrafficValue>11288111</TrafficValue>
            </DataModule>
            <DataModule>
                  <タイムスタンプ> 2017-12-10T20:05:00Z</タイムスタンプ>
                  <TrafficValue>1288111</TrafficValue>
            </DataModule>
      </TrafficDataPerInterval>
      <DomainNam e>demo.aliyundoc.com</DomainName>
      <DataInterval>300</DataInterval>
      <RequestId>3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F</RequestId>
      <StartTime>2017-12-10T20:00:00Z</StartTime>
      <EndTime>2017-12-10T21:00:00Z</EndTime>
</DescribeLiveDomainPushTrafficDataResponse>

JSON 形式 

{
    "TrafficDataPerInterval": {
        "DataModule": [
            {
                "タイムスタンプ": "2017-12-10T20:00:00Z" 、
                "TrafficValue": "11288111"
            },
            {
                "タイムスタンプ": "2017-12-10T20:05:00Z" 、
                "TrafficValue": "1288111"
            }
        ]
    },
    "DomainName": "demo.aliyundoc.com" 、
    "DataInterval": "300" 、
    "RequestId": "3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F" 、
    "StartTime": "2017-12-10T20:00:00Z" 、
    "EndTime": "2017-12-10T21:00:00Z"
}

エラーコード

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

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