1つ以上のドメイン名について1分ごとに収集される帯域幅データを照会します。

Usage note

  • 過去7日間のデータを照会できます。 The time range that is specified by the StartTime and EndTime parameters cannot exceed 24 hours for a single query.
  • StartTimeパラメーターもEndTimeパラメーターも指定しない場合、最後の1時間のデータが返されます。
  • この操作は、データを監視するために呼び出されます。 データは、課金とは異なる方法で収集および処理されます。 したがって、この操作によって返されるデータは、課金のリソース使用量を計算するための参照として使用することはできません。

QPS制限

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

デバッグ

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

リクエストパラメーター

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

実行したい操作。 値をDescribeLiveDomainRealTimeBpsDataに設定します。

DomainName String 必須 example.com,example.aliyundoc.com

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

複数のドメイン名はコンマ (,) で区切ります。

IspNameEn String 任意 alibaba

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

ISPを照会するには、DescribeCdnRegionAndIsp操作を呼び出します。

LocationNameEn String 任意 tianjin

データをクエリするリージョンの名前。

リージョンを照会するには、DescribeCdnRegionAndIsp操作を呼び出します。

StartTime String 任意 2015-11-30T05:39:00Z

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

EndTime String 任意 2015-11-30T05:40:00Z

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

このパラメーターを設定しない場合、指定された開始時刻の次の時間のデータが返されます。

レスポンスパラメーター

パラメーター データ型 説明
DataInterval String 60

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

DomainName String example.com,example.aliyundoc.com

照会されたストリーミングドメイン名。

EndTime String 2015-11-30T05:40:00Z

データが照会された時間範囲の終わり。 時間は、 Z形式のISO 8601標準に従います。 The time is displayed in UTC.

RealTimeBpsDataPerInterval Array of DataModule

The bandwidth data that was collected every minute.

DataModule
タイムスタンプ String 2015-11-30T05:39:00Z

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

利点 String 59392614.8

帯域幅。 単位:bit/s。

RequestId String BC858082-736F-4A25-867B-E5B67C85ACF7

リクエストの ID です。

StartTime String 2015-11-30T05:33:00Z

データが照会された時間範囲の開始。 時間は、 Z形式のISO 8601標準に従います。 時刻はUTCで表示されます。

リクエストの例

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

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

XML 形式

<DescribeLiveDomainRealTimeBpsDataResponse>
      <RealTimeBpsDataPerInterval>
            <DataModule>
                  <タイムスタンプ> 2018-01-02T11:05:00Z</タイムスタンプ>
                  <Value>16710625.733333332</Value>
            </DataModule>
            <DataModule>
                  <タイムスタンプ> 2018-01-02T11:04:00Z</タイムスタンプ>
                  <Value>59392614.8</Value>
            </DataModule>
      </RealTimeBpsDataPerInterval>
      <RequestId>B49E6DDA-F413-422B-B58E-2FA23F286726</RequestId>
      <DomainNam e>example.com、example.aliyundoc.com</DomainName>
      <EndTime>2017-12-10T15:00:00Z</EndTime>
      <DataInterval>300</DataInterval>
      <StartTime>2017-12-10T14:00:00Z</StartTime>
</DescribeLiveDomainRealTimeBpsDataResponse>

JSON 形式

{
   "RealTimeBpsDataPerInterval":{
      "DataModule":[
         {
            "タイムスタンプ":"2018-01-02T11:05:00Z" 、
            "値":16710625.733333332
         },
         {
            "TimeStamp":"2018-01-02T11:04:00Z" 、
            "値":59392614.8
         }
      ]
   },
   "RequestId":"B49E6DDA-F413-422B-B58E-2FA23F286726" 、
   "DomainName":"example.com、example.aliyundoc.com" 、
   "EndTime":"2017-12-10T15:00:00Z" 、
   "DataInterval":"300",
   "StartTime":"2017-12-10T14:00:00Z"
}

エラーコード

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