DescribeLiveDomainPushTrafficData - - Alibaba Cloud ドキュメントセンター

使用状況ノート

ネットワークトラフィックデータの単位はビット /秒である。
カンマ (,) で区切って、複数の取り込みドメインのネットワークトラフィックデータを照会できます。
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 エラーセンター」をご参照ください。