DescribeDdosEventList による DDoS 攻撃イベントのクエリ - Anti-DDoS

この操作は、パブリック IP アドレスを持つアセットの DDoS 攻撃イベントの詳細をクエリします。

操作説明

この操作は、パブリック IP アドレスを持つ特定のアセットの DDoS 攻撃イベントの詳細を取得するためのページングクエリを実行します。詳細は、各イベントの開始時刻、終了時刻、およびステータスを含みます。

QPS 制限

この操作の 1 秒あたりのクエリ数 (QPS) 制限は、ユーザーごとに 10 です。制限を超えると、API 呼び出しがスロットルされます。これはビジネスに影響を与える可能性があります。この操作は妥当な回数呼び出すことをお勧めします。

今すぐお試しください

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

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

yundun-ddos:DescribeDdosEventList

get

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
DdosRegionId	string	必須	パブリック IP アドレスが割り当てられているアセットのリージョン ID です。説明すべてのリージョン ID をクエリするには、DescribeRegions を呼び出します。	cn-hangzhou
InstanceType	string	必須	パブリック IP アドレスが割り当てられているアセットのインスタンスタイプ。有効な値: ecs: Elastic Compute Service (ECS) インスタンス。 slb: Server Load Balancer (SLB) インスタンス。 eip: エラスティック IP アドレス (EIP) インスタンス。 ipv6: IPv6 ゲートウェイインスタンス。 swas: シンプルアプリケーションサーバーインスタンス。 waf: 専用 Web Application Firewall (WAF) インスタンス。 ga_basic: Global Accelerator インスタンス。	ecs
InstanceId	string	必須	パブリック IP アドレスが割り当てられているアセットのインスタンス ID です。説明 Alibaba Cloud アカウントに属する ECS、SLB、および EIP インスタンスの ID をクエリするには、DescribeInstance を呼び出します。	i-bp10bclrt56fblts****
CurrentPage	integer	任意	ページングクエリで返すページ番号です。デフォルト値: 1。	1
PageSize	integer	任意	ページングクエリで各ページに返す攻撃イベントの数です。デフォルト値: 10。	10
InternetIp	string	任意	パブリック IP アドレスが割り当てられているアセットの IP アドレスです。	121.199.XX.XX
QueryDays	integer	任意	現在の時刻から遡ってクエリする日数です。デフォルト値: 7。	7

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンスパラメータ。
Total	integer	検出された DDoS 攻撃イベントの総数です。	1
RequestId	string	リクエストの ID です。Alibaba Cloud はリクエストごとに一意の ID を生成します。この ID を使用して問題のトラブルシューティングを行うことができます。	BC0907F8-A9F3-5E11-977B-D59CD98C64ED
DdosEventList	object
DdosEvent	array<object>	DDoS 攻撃イベントのリスト。
	object	DDoS 攻撃イベントのリスト。
DdosType	string	DDoS 攻撃イベントのタイプ。有効な値: defense: トラフィックスクラビングイベント。 blackhole: ブラックホールフィルタリングイベント。	blackhole
EndTime	integer	イベントの終了時刻。これは UNIX タイムスタンプです。単位: ミリ秒。	1637817679000
StartTime	integer	イベントの開始時刻。これは UNIX タイムスタンプです。単位: ミリ秒。	1637812279000
DelayTime	integer	最後の攻撃の時刻。これは UNIX タイムスタンプです。単位: ミリ秒。説明このパラメータは、パブリック IP アドレスが割り当てられているアセットが複数回攻撃された一部のブラックホールフィルタリングイベントについてのみ返されます。	1637817679000
DdosStatus	string	イベントのステータス。有効な値: mitigating: トラフィックがスクラビングされています。 blackholed: アセットに対してブラックホールフィルタリングが有効になっています。 normal: イベントは終了しました。	normal
UnBlackholeTime	integer	ブラックホールフィルタリングが無効になった時刻。これは UNIX タイムスタンプです。単位: ミリ秒。説明このパラメータは、DdosType が blackhole (ブラックホールフィルタリングイベントを示す) の場合にのみ返されます。	1637814079000

例

成功レスポンス

JSONJSON

{
  "Total": 1,
  "RequestId": "BC0907F8-A9F3-5E11-977B-D59CD98C64ED",
  "DdosEventList": {
    "DdosEvent": [
      {
        "DdosType": "blackhole",
        "EndTime": 1637817679000,
        "StartTime": 1637812279000,
        "DelayTime": 1637817679000,
        "DdosStatus": "normal",
        "UnBlackholeTime": 1637814079000
      }
    ]
  }
}

エラーコード

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

変更履歴

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