この操作を呼び出すと、ライブドメイン名のネットワークトラフィックのモニタリングデータをバイト単位で照会できます。

  • StartTime も EndTime も指定しない場合、デフォルトで過去 24 時間のデータを取得できます。 StartTime と EndTime の両方を指定して、指定された期間のデータを取得することもできます。

  • 複数のドメイン名をコンマ (,) で区切って指定できます。

  • 最大で過去 90 日間のデータを取得できます。

パラメータのリクエスト

名前 タイプ 必須項目 例 説明
Action String 必須 DescribeLiveDomainTrafficData 実行する操作。 値を DescribeLiveDomainTrafficData に設定します。
DomainName String 任意 test.com

照会するライブドメイン名。

  • このパラメーターを指定しない場合、デフォルトですべてのライブドメイン名をマージしたデータを取得します。
  • 複数の条件を指定できます。
  • ドメイン名はコンマ (,) で区切ります。
StartTime String 任意 2017-12-10T20:00:00Z

クエリの開始時刻。

  • 時刻は、UTC の ISO 8601 形式で指定します。
  • YYYY-MM-DDThh:mm:ssZ 形式です。
  • 最小サンプリング間隔は 5 分です。
  • 最大サンプリング間隔は 1 日です。
  • 最大で過去 45 日間のデータを取得できます。
EndTime String 任意 2017-12-10T21:00:00Z

クエリの終了時刻。 終了時刻は開始時刻よりも後の時刻でなければなりません。

  • 時刻は、UTC の ISO 8601 形式で指定します。
  • YYYY-MM-DDThh:mm:ssZ 形式です。
  • 最小サンプリング間隔は 5 分です。
  • 最大サンプリング間隔は 1 日です。
  • 最大で過去 45 日間のデータを取得できます。

レスポンスのパラメータ

名前 データ型 例 説明
DomainName String test.com ライブドメイン名。
DataInterval String 300 サンプリング間隔。
TrafficDataPerInterval 各サンプリング間隔中に収集されるトラフィックデータ。
  └TimeStamp String 2017-12-10T20:00:05Z サンプリング間隔の開始時間。
  └TrafficValue String 454680793 トラフィックの合計量。
  └HttpTrafficValue String 0 HTTP トラフィックの量。
  └HttpsTrafficValue String 454680793 HTTPS トラフィックの量。
RequestId String B955107D-E658-4E77-B913-E0AC3D31693E Alibaba Cloud によって生成された、リクエストに対する GUID。
StartTime String 2017-12-10T20:00:00Z 開始時刻。
EndTime String 2017-12-10T21:00:00Z 終了時刻。

コーディング例

リクエスト例
 http://live.aliyuncs.com?Action=DescribeLiveDomainTrafficData&DomainName=test.com
&StartTime=2017-12-10T20:00:00Z
&EndTime=2017-12-10T21:00:00Z
&<Common request parameters>

通常のレスポンスの例

JSON 形式
{
    "DataInterval":"300",
    "DomainName":"test.com",
    "EndTime":"2017-12-10T21:00:00Z",
    "RequestId":"B955107D-E658-4E77-B913-E0AC3D31693E",
    "StartTime":"2017-12-10T20:00:00Z",
    "TrafficDataPerInterval":{
        "DataModule":[
            {
                "HttpTrafficValue":"0",
                "HttpsTrafficValue":"423304182",
                "TimeStamp":"2017-12-10T20:00:00Z",
                "TrafficValue":"423304182"
            },
            {
                "HttpTrafficValue":"0",
                "HttpsTrafficValue":"454680793",
                "TimeStamp":"2017-12-10T20:00:05Z",
                "TrafficValue":"454680793"
            }
        ]
    }
}

レスポンスがエラーになる場合のコーディング例

JSON 形式
{
    "Code":"InternalError",
    "HostId":"live.aliyuncs.com",
    "Message":"The request processing has failed due to some unknown error.",
    "RequestId":"6EBD1AC4-C34D-4AE1-963E-B688A228BE31"
}

Error codes

詳細については、「ApsaraVideo Live の一般的なエラーコード」をご参照ください。