アクセラレーションドメイン名のトラフィックデータを照会します。DescribeVodDomainRealTimeTrafficData 操作と比較して、この操作はより長い既存データのクエリ範囲（最大 366 日）をサポートしますが、データの時間の粒度が大きく（最小値 5 分）、データ遅延が高くなります。
操作説明
この操作のサービスアドレスは China (Shanghai) のみをサポートしています。
バッチクエリがサポートされています。一度に最大 500 個のドメイン名のデータのクエリを実行できます。
StartTimeとEndTimeを指定しない場合、デフォルトで過去 24 時間のデータが返されます。StartTimeとEndTimeを指定した場合、指定された時間範囲のデータが返されます。
返されるデータの時間の粒度
次の表は、Interval がセットされていない場合に、StartTime と EndTime で指定された時間のスパンに基づく、返されるデータのデフォルトの時間の粒度、クエリ可能な既存データの有効値、およびデータ遅延について説明しています。
| 時間の粒度 | クエリあたりの時間のスパン | クエリ可能な既存データの有効値 | データ遅延 |
| 5 分 | クエリあたりの時間のスパン < 3 日 | 93 日 | 15 分 |
| 1 時間 | 3 日 ≤ クエリあたりの時間のスパン < 31 日 | 186 日 | 通常 3～4 時間 |
| 1 日 | 31 日 ≤ クエリあたりの時間のスパン ≤ 366 日 | 366 日 | 通常 4 時間、最大 24 時間 |
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
vod:DescribeVodDomainTrafficData |
get |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| DomainName |
string |
任意 |
クエリ対象のアクセラレーションドメイン名。
|
example.com。 |
| StartTime |
string |
任意 |
クエリする時間範囲の開始時刻。 ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ フォーマットで時間を指定します。時間は協定世界時 (UTC) である必要があります。 |
2019-01-20T13:59:58Z |
| EndTime |
string |
任意 |
クエリする時間範囲の終了時刻。 ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ フォーマットで時間を指定します。時間は協定世界時 (UTC) である必要があります。 説明
終了時刻は開始時刻より後である必要があります。 |
2019-01-20T14:59:58Z |
| Interval |
string |
任意 |
データエントリの時間の粒度。単位: 秒。有効な値: 300、3600、86400。このパラメーターを指定しないか、サポートされていない値を指定した場合、デフォルト値が使用されます。サポートされる時間の粒度は、
|
300 |
| IspNameEn |
string |
任意 |
インターネットサービスプロバイダー (ISP) の英語名。このパラメーターを指定しない場合、デフォルトですべての ISP のデータがクエリされます。 |
unicom。 |
| LocationNameEn |
string |
任意 |
リージョンの英語名。このパラメーターを指定しない場合、デフォルトですべてのリージョンのデータがクエリされます。Shanghai リージョンのみがサポートされています。 |
shanghai。 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
応答パラメーター。 |
||
| EndTime |
string |
返されるデータの時間範囲の終了時刻。 |
2019-01-20T14:59:58Z |
| StartTime |
string |
返されるデータの時間範囲の開始時刻。 |
2019-01-20T13:59:58Z |
| RequestId |
string |
リクエスト ID。 |
D94E471F-1A27-442E-552D-D4D2000C**** |
| DomainName |
string |
アクセラレーションドメイン名。 |
example.com。 |
| TotalTraffic |
string |
合計トラフィック。 |
5906662826 |
| DataInterval |
string |
データエントリ間の時間間隔。これはデータの時間の粒度です。単位: 秒。 |
300 |
| TrafficDataPerInterval |
object |
||
| DataModule |
array<object> |
各時間間隔のトラフィックデータ。 |
|
|
object |
The information about the network traffic. |
||
| HttpsDomesticValue |
string |
中国本土の L1 ノードの HTTPS トラフィック。単位: バイト。 |
0 |
| Value |
string |
総トラフィック。単位: バイト。 |
0 |
| OverseasValue |
string |
中国本土以外のトラフィック。単位: バイト。 |
0 |
| HttpsValue |
string |
L1 ノードの HTTPS 総トラフィック。単位: バイト。 |
0 |
| HttpsOverseasValue |
string |
中国本土以外の L1 ノードの HTTPS トラフィック。単位: バイト。 |
0 |
| TimeStamp |
string |
データタイムスタンプ。時間は ISO 8601 標準に従い、UTC で表示されます。 |
2019-01-20T13:59:58Z |
| DomesticValue |
string |
中国本土のトラフィック。単位: バイト。 |
0 |
例
成功レスポンス
JSONJSON
{
"EndTime": "2019-01-20T14:59:58Z",
"StartTime": "2019-01-20T13:59:58Z",
"RequestId": "D94E471F-1A27-442E-552D-D4D2000C****",
"DomainName": "example.com",
"TotalTraffic": "5906662826",
"DataInterval": "300\n",
"TrafficDataPerInterval": {
"DataModule": [
{
"HttpsDomesticValue": "0",
"Value": "0",
"OverseasValue": "0",
"HttpsValue": "0",
"HttpsOverseasValue": "0",
"TimeStamp": "2019-01-20T13:59:58Z",
"DomesticValue": "0"
}
]
}
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | MissingTimeParameter | The StartTime and EndTime must be both specified. | |
| 400 | InvalidStartTime.Malformed | The specified StartTime is invalid. | |
| 400 | InvalidEndTime.Malformed | The specified EndTime is invalid. | |
| 400 | InvalidEndTime.Mismatch | The specified EndTime is earlier than the StartTime. | |
| 400 | InvalidStartTime.ValueNotSupported | The specified StartTime is invalid. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。