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制限」をご参照ください。
デバッグ
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 例 | 説明 |
---|---|---|---|---|
操作 | 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 エラーセンター」をご参照ください。