DescribeLiveDomainPushBpsData 操作を呼び出して、アップストリーミングドメインのネットワーク帯域幅のモニタリングデータをクエリできます。
操作説明
帯域幅データは bit/s 単位で測定されます。
複数のドメイン名のデータを照会できます。 そのためには、ドメイン名をコンマ (,) で区切ります。
StartTime パラメーターと EndTime パラメーターを指定しない場合、過去 24 時間のデータが返されます。 特定の時間範囲のデータを照会するには、StartTime パラメーターと EndTime パラメーターの両方を指定する必要があります。
過去 90 日間のデータを照会できます。
QPS 制限
単一ユーザーの秒間クエリ数 (QPS) 制限は 100 です。 この制限を超えると、API 呼び出しがスロットリングされ、ビジネスに影響を与える可能性があります。 この操作は、妥当なレートで呼び出すことを推奨します。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
live:DescribeLiveDomainPushBpsData |
get |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
任意 |
リージョン ID。 |
cn-shanghai |
| DomainName |
string |
任意 |
アップストリーミングドメイン名。 複数のドメイン名を指定し、コンマ (,) で区切ることができます。 このパラメーターを空のままにすると、すべてのアップストリーミングドメインのマージされたデータが返されます。 |
demo.aliyundoc.com |
| StartTime |
string |
任意 |
照会する時間範囲の開始時刻。 yyyy-MM-ddTHH:mm:ssZ 形式で時刻を指定します。 時刻は協定世界時 (UTC) である必要があります。 このパラメーターを指定しない場合、過去 24 時間のデータが返されます。 |
2017-12-10T20:00:00Z |
| EndTime |
string |
任意 |
照会する時間範囲の終了時刻。 yyyy-MM-ddTHH:mm:ssZ 形式で時刻を指定します。 時刻は UTC である必要があります。 終了時刻は開始時刻より後である必要があります。 |
2017-12-10T21:00:00Z |
| Interval |
string |
任意 |
データの時間の粒度。 単位:秒。 有効な値:
このパラメーターを指定しないか、無効な値を指定した場合、デフォルト値の 300 が使用されます。 |
300 |
| IspNameEn |
string |
任意 |
キャリアの英語名。 DescribeCdnRegionAndIsp 操作を呼び出して名前を取得できます。 このパラメーターを指定しない場合、すべてのキャリアのデータが返されます。 |
alibaba |
| LocationNameEn |
string |
任意 |
リージョンの英語名。 DescribeCdnRegionAndIsp 操作を呼び出して名前を取得できます。 このパラメーターを指定しない場合、すべてのリージョンのデータが返されます。 |
tianjin |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| EndTime |
string |
時間範囲の終了時刻。 |
2017-12-10T21:00:00Z |
| StartTime |
string |
時間範囲の開始時刻。 |
2017-12-10T20:00:00Z |
| RequestId |
string |
リクエスト ID。 |
3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F |
| DomainName |
string |
照会されたアップストリーミングドメイン名。 |
demo.aliyundoc.com |
| DataInterval |
string |
照会されたデータの時間の粒度。 |
300 |
| BpsDataPerInterval |
object |
||
| DataModule |
array<object> |
各時間間隔におけるネットワーク帯域幅データ。 |
|
|
object |
|||
| BpsValue |
string |
帯域幅の値 (bit/s)。 |
11288111 |
| TimeStamp |
string |
タイムスライスの開始時刻。 |
2017-12-10T20:00:00Z |
例
成功レスポンス
JSONJSON
{
"EndTime": "2017-12-10T21:00:00Z",
"StartTime": "2017-12-10T20:00:00Z",
"RequestId": "3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F",
"DomainName": "demo.aliyundoc.com",
"DataInterval": "300",
"BpsDataPerInterval": {
"DataModule": [
{
"BpsValue": "11288111",
"TimeStamp": "2017-12-10T20:00:00Z"
}
]
}
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | |
| 400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | |
| 400 | InvalidEndTime.Mismatch | Specified end time does not math the specified start time. | |
| 400 | InvalidStartTime.ValueNotSupported | The specified value of parameter StartTime is not supported. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。