この操作を呼び出すと、bit/s 単位でライブドメイン名のネットワーク帯域幅のモニタリングデータを照会できます。

  • StartTime も EndTime も指定しない場合、デフォルトで過去 24 時間のデータを取得できます。 StartTime と EndTime の両方を指定して、指定された期間のデータを取得することもできます。

  • 複数のドメイン名をコンマ (,) で区切って指定できます。

  • 最大で過去 90 日間のデータを取得できます。

パラメータのリクエスト

名前 タイプ 必須項目 例 説明
Action String 必須 DescribeLiveDomainBpsData 実行する操作。 値を DescribeLiveDomainBpsData に設定します。
DomainName String 任意 test.com

照会するライブドメイン名。

  • このパラメーターを指定しない場合、デフォルトですべてのライブドメイン名をマージしたデータを取得します。
  • 複数のドメイン名を指定できます。
  • ドメイン名はコンマ (,) で区切ります。
StartTime String 任意 2017-12-10T20:00:00Z

クエリの開始時刻。

  • 時刻は、UTC の ISO 8601 形式で指定します。
  • YYYY-MM-DDThh:mm:ssZ 形式です。
  • 最小サンプリング間隔は 5 分です。
  • 最大サンプリング間隔は 1 日です。
  • 最大で過去 45 日間のデータを取得できます。
EndTime String 任意 2017-12-10T21:00:00Z

終了時刻は開始時刻よりも後の時刻でなければなりません。

  • 時刻は、UTC の ISO 8601 形式で指定します。
  • YYYY-MM-DDThh:mm:ssZ 形式です。
  • 最小サンプリング間隔は 5 分です。
  • 最大サンプリング間隔は 1 日です。
  • 最大で過去 45 日間のデータを取得できます。

レスポンスのパラメータ

名前 データ型 例 説明
DomainName String test.com ライブドメイン名。
DataInterval String 300 サンプリング間隔。
RequestId String B955107D-E658-4E77-B913-E0AC3D31693E Alibaba Cloud によって生成された、リクエストに対する GUID。
BpsDataPerInterval 各サンプリング間隔で収集される帯域幅データ。
  └TimeStamp String 2017-12-10T20:00:05Z サンプリング間隔の開始時刻。
  └BpsValue String 11288111

帯域幅。

単位：bit/s。
  └HttpBpsValue String 11286111

HTTP トラフィックの帯域幅。

単位：bit/s。
  └HttpsBpsValue String 2000

HTTPS トラフィックの帯域幅。

単位：bit/s。
StartTime String 2017-12-10T20:00:00Z 開始時刻。
EndTime String 2017-12-10T21:00:00Z 終了時刻。

コーディング例

リクエスト例
http://live.aliyuncs.com?Action=DescribeLiveDomainBpsData&DomainName=test.com
&StartTime=2017-12-10T20:00:00Z
&EndTime=2017-12-10T21:00:00Z
&<Common request parameters>

通常のレスポンスの例

JSON 形式
{
	"BpsDataPerInterval":{
		"DataModule":[
			{
				"BpsValue":"11288111",
				"HttpBpsValue":"11286111",
				"HttpsBpsValue":"2000",
				"TimeStamp":"2017-12-10T20:00:00Z"
			},
			{
				"BpsValue":"1288111",
				"HttpBpsValue":"1286111",
				"HttpsBpsValue":"2000",
				"TimeStamp":"2017-12-10T20:05:00Z"
			}
		]
	},
	"DataInterval":"300",
	"DomainName":"test.com",
	"EndTime":"2017-12-10T21:00:00Z",
	"RequestId":"3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F",
	"StartTime":"2017-12-10T20:00:00Z"
}

レスポンスがエラーになる場合のコーディング例

JSON 形式
{
	"Code":"InternalError",
	"HostId":"live.aliyuncs.com",
	"Message":"The request processing has failed due to some unknown error.",
	"RequestId":"6EBD1AC4-C34D-4AE1-963E-B688A228BE31"
}

Error codes

詳細については、「ApsaraVideo Live の一般的なエラーコード」をご参照ください。