DescribeLiveDomainRealTimeTrafficData - ApsaraVideo Live - Alibaba Cloud ドキュメントセンター

使用状況ノート

StartTimeパラメーターもEndTimeパラメーターも指定しない場合、最後の1時間のデータが返されます。 StartTimeパラメーターとEndTimeパラメーターの両方を指定して、指定した時間範囲のデータを照会できます。
最大で過去90日間のデータをクエリできます。
この操作は、データを監視するために呼び出されます。データは、課金とは異なる方法で収集および処理されます。したがって、この操作によって返されるデータは、課金のリソース使用量を計算するための参照として使用することはできません。

QPS制限

この操作では、1人のユーザーに1秒あたりのクエリ (QPS) 制限が課されません。 You can call this operation based on your business requirements. シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。

デバッグ

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

リクエストパラメーター


パラメーター	データ型	必須／任意	例	説明
操作	String	必須	DescribeLiveDomainRealTimeTrafficData	実行したい操作。値をDescribeLiveDomainRealTimeTrafficDataに設定します。
DomainName	String	必須	example.com,example.aliyundoc.com	ストリーミングドメイン。複数のドメイン名はコンマ (,) で区切ります。
StartTime	String	任意	2015-12-10T15:00:00Z	クエリする時間範囲の先頭。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。時刻はUTCである必要があります。注このパラメーターを設定しない場合、過去1時間のデータが返されます。
IspNameEn	String	任意	alibaba	インターネットサービスプロバイダー (ISP) の名前。 ISPを照会するには、DescribeCdnRegionAndIsp操作を呼び出します。
LocationNameEn	String	任意	tianjin	データをクエリするリージョンの名前。リージョンを照会するには、DescribeCdnRegionAndIsp操作を呼び出します。
EndTime	String	任意	2015-12-10T15:01:00Z	The end of the time range to query. 終了時刻は開始時刻よりも後の時刻にする必要があります。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。時刻はUTCである必要があります。

レスポンスパラメーター


パラメーター	データ型	例	説明
DataInterval	String	60	The time interval between the returned entries. (単位：秒)
DomainName	String	example.com,example.aliyundoc.com	The streaming domain.
EndTime	String	2015-12-10T15:01:00Z	データが照会された時間範囲の終わり。時間は、 Z形式のISO 8601標準に従います。時刻はUTCで表示されます。
RealTimeTrafficDataPerInterval	DataModuleの配列		The network traffic data that was collected for each interval.
DataModule
タイムスタンプ	String	2015-12-10T15:01:00Z	The timestamp of the returned data. 時間は、 Z形式のISO 8601標準に従います。時刻はUTCで表示されます。
利点	String	0	ネットワークトラフィックデータ。単位: バイト。
RequestId	String	A666D44F-19D6-490E-97CF-1A64AB962C57	リクエストの ID です。
StartTime	String	2015-12-10T15:00:00Z	データが照会された時間範囲の開始。時間は、 Z形式のISO 8601標準に従います。時刻はUTCで表示されます。

例

リクエストの例

http(s):// live.aliyuncs.com/?Action=DescribeLiveDomainRealTimeTrafficData
&<共通リクエストパラメーター>

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

XML 形式

<DescribeLiveDomainRealTimeTrafficDataResponse>
      <DomainNam e>example.com、example.aliyundoc.com</DomainName>
      <DataInterval>60</DataInterval>
      <RealTimeTrafficDataPerInterval>
            <DataModule>
                  <タイムスタンプ> 2015-12-10T15:00:00Z</タイムスタンプ>
                  <値> 0</値>
            </DataModule>
            <DataModule>
                  <タイムスタンプ> 2015-12-10T15:01:00Z</タイムスタンプ>
                  <値> 0</値>
            </DataModule>
      </RealTimeTrafficDataPerInterval>
      <RequestId>A666D44F-19D6-490E-97CF-1A64AB962C57</RequestId>
      <StartTime>2015-12-10T15:00:00Z</StartTime>
      <EndTime>2015-12-10T15:01:00Z</EndTime>
</DescribeLiveDomainRealTimeTrafficDataResponse>

JSON 形式

{
    "DomainName": "example.com、example.aliyundoc.com" 、
    "DataInterval": "60" 、
    "RealTimeTrafficDataPerInterval": {
        "DataModule": [
            {
                "タイムスタンプ": "2015-12-10T15:00:00Z" 、
                "値": "0"
            },
            {
                "タイムスタンプ": "2015-12-10T15:01:00Z" 、
                "値": "0"
            }
        ]
    },
    "RequestId": "A666D44F-19D6-490E-97CF-1A64AB962C57" 、
    "StartTime": "2015-12-10T15:00:00Z" 、
    "EndTime": "2015-12-10T15:01:00Z"
}

エラーコード


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

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