すべてのプロダクト
Search
ドキュメントセンター

:DescribeTraffic

最終更新日:Dec 14, 2025

指定された期間における Anti-DDoS Origin インスタンスのトラフィック統計を照会します。

操作説明

DescribeTraffic 操作を呼び出して、指定された期間における Anti-DDoS Origin インスタンスのトラフィック統計を照会できます。

説明

この操作を呼び出す際は、InstanceId パラメーターを設定して、トラフィック統計を照会する Anti-DDoS Origin インスタンスを指定する必要があります。

制限事項

この操作は、アカウントごとに 1 秒あたり 1 回呼び出すことができます。1 秒あたりの呼び出し回数が制限を超えると、速度制限がトリガーされます。その結果、ビジネスに影響が生じる可能性があります。この操作を呼び出す際は、制限に注意することを推奨します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

必須 / 任意

説明

InstanceId

string

任意

照会する Anti-DDoS Origin インスタンスの ID。

説明

DescribeInstanceList 操作を呼び出して、すべての Anti-DDoS Origin インスタンスの ID を照会できます。

オンデマンドインスタンスを指定する場合は、Interval パラメーターを設定する必要があります。

ddosbgp-cn-n6w203qg****

Ipnet

string

任意

照会するオンデマンドインスタンスの CIDR (Classless Inter-Domain Routing) ブロック。

111.XX.XX.0/24

Ip

string

任意

照会するアセットのパブリック IP アドレス。このパラメーターを指定しない場合、Anti-DDoS Origin インスタンスによって保護されているすべてのパブリック IP アドレスのトラフィック統計が照会されます。

説明

パブリック IP アドレスは、Anti-DDoS Origin インスタンスの保護対象オブジェクトである必要があります。DescribePackIpList 操作を呼び出して、Anti-DDoS Origin インスタンスのすべての保護対象オブジェクトを照会できます。

39.XX.XX.96

StartTime

integer

必須

照会する時間範囲の開始時刻。値は UNIX タイムスタンプです。単位:秒。

1619798400

EndTime

integer

任意

照会する時間範囲の終了時刻。値は UNIX タイムスタンプです。単位:秒。

このパラメーターを指定しない場合、現在のシステム時刻が終了時刻として使用されます。

1563445054

Interval

integer

任意

トラフィック統計が計算される間隔。単位:秒。デフォルト値:5

5

FlowType

string

任意

照会するトラフィック統計のタイプ。有効な値:

  • max:指定された間隔内のピークトラフィック。

  • avg:指定された間隔内の平均トラフィック。

列挙値:

  • all

  • avg

  • max

max

ResourceGroupId

string

任意

Resource Management における Anti-DDoS Origin インスタンスが属するリソースグループの ID。

このパラメーターを指定しない場合、インスタンスはデフォルトのリソースグループに属します。

rg-acfm2pz25js****

RegionId

string

任意

Anti-DDoS Origin インスタンスが存在するリージョンの ID。

説明

DescribeRegions 操作を呼び出して、最新のリージョンリストを照会できます。

cn-hangzhou

すべての Alibaba Cloud API 操作には、共通リクエストパラメーターを含める必要があります。共通リクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。

リクエスト例の詳細については、このトピックの「」セクションをご参照ください。

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエストの ID。

6A507DC8-F657-4C13-84E2-D1D1B9400753

FlowList

array<object>

照会されたトラフィック統計。

object

Time

integer

トラフィック統計が計算された時刻。この値は UNIX タイムスタンプです。単位:秒。

1620951900

FlowType

string

トラフィック統計のタイプ。有効な値:

  • max:指定された間隔内のピークトラフィック

  • avg:指定された間隔内の平均トラフィック

max

AttackPps

integer

攻撃トラフィックのパケット転送速度。単位:1 秒あたりのパケット数。

説明

このパラメーターは、攻撃トラフィックが存在する場合にのみ返されます。

0

Name

string

トラフィック統計の ID。

8e33f19e-5644-11eb-b5c1-d89d67182200

Pps

integer

総トラフィックのパケット転送速度。単位:1 秒あたりのパケット数。

274

Kbps

integer

総トラフィックの帯域幅。単位:Kbit/s。

417

AttackBps

integer

攻撃トラフィックの帯域幅。単位:bit/s。

説明

このパラメーターは、攻撃トラフィックが存在する場合にのみ返されます。

0

成功レスポンス

JSONJSON

{
  "RequestId": "6A507DC8-F657-4C13-84E2-D1D1B9400753",
  "FlowList": [
    {
      "Time": 1620951900,
      "FlowType": "max",
      "AttackPps": 0,
      "Name": "8e33f19e-5644-11eb-b5c1-d89d67182200",
      "Pps": 274,
      "Kbps": 417,
      "AttackBps": 0
    }
  ]
}

エラーレスポンス

JSONJSON

{
 "RequestId": "6A507DC8-F657-4C13-84E2-D1D1B9400753",
 "FlowList": [
        {
            "Name": "73765106-54e7-11e9-aab0-d89d67182200",
            "Pps": 25,
            "Time": 1560855000,
            "FlowType": "max",
            "Kbps": 17
        },
        {
            "Name": "73765106-54e7-11e9-aab0-d89d67182200",
            "Pps": 9,
            "Time": 1560857000,
            "FlowType": "max",
            "Kbps": 8
        }
 ]
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。