侵入防止イベントの詳細情報を取得します。
操作説明
この操作を使用して、侵入防止イベントの詳細情報を照会およびダウンロードできます。1 回の照会で 5~10 件程度を指定することを推奨します。照会タイムアウトを防ぐため、IP ジオロケーション情報が不要な場合は、`NoLocation` パラメーターを `true` に設定してください。
クエリ/秒 (QPS) 制限
単一ユーザーに対するクエリ/秒 (QPS) の上限は 10 です。この上限を超えると、API 呼び出しはスロットルされます。これにより、お客様の業務に影響が出る可能性があります。本操作の呼び出しは、適切な頻度で実行してください。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Lang |
string |
任意 |
リクエストおよび応答の言語。有効な値:
|
zh |
| Lang |
string |
任意 |
リクエストおよび応答の言語。有効な値:
|
zh |
| StartTime |
string |
必須 |
照会対象の時間範囲の開始時刻。値は UNIX タイムスタンプ(単位:秒)です。 |
1534408189 |
| EndTime |
string |
必須 |
照会対象の時間範囲の終了時刻。値は UNIX タイムスタンプ(単位:秒)です。 |
1534408267 |
| Direction |
string |
任意 |
侵入防止イベントのトラフィック方向。有効な値:
説明
このパラメーターを設定しない場合、すべてのトラフィック方向のイベントが照会されます。 |
in |
| PageSize |
string |
任意 |
1 ページあたりの表示件数。 デフォルト値:6。最大値:10。 |
6 |
| CurrentPage |
string |
任意 |
返されるデータのページ番号。 デフォルト値:1。 |
1 |
| DataType |
string |
必須 |
リスクイベントの種別。 |
session |
| RuleSource |
string |
任意 |
侵入防止イベント検出に使用されるルールのソース。有効な値:
説明
このパラメーターを設定しない場合、すべてのタイプのルールで検出されたイベントが照会されます。 |
1 |
| RuleResult |
string |
任意 |
Cloud Firewall の処理ステータス。有効な値:
説明
このパラメーターを設定しない場合、すべての処理ステータスのイベントが照会されます。 |
1 |
| SrcIP |
string |
任意 |
照会対象の送信元 IP アドレス。このパラメーターを設定すると、指定した送信元 IP アドレスを含む侵入防止イベントのみが照会されます。 |
192.0.XX.XX |
| DstIP |
string |
任意 |
照会対象の宛先 IP アドレス。このパラメーターを設定すると、指定した宛先 IP アドレスを含む侵入防止イベントのみが照会されます。 |
192.0.XX.XX |
| VulLevel |
string |
任意 |
侵入防止イベントのリスクレベル。有効な値:
説明
このパラメーターを設定しない場合、すべてのリスクレベルのイベントが照会されます。 |
1 |
| FirewallType |
string |
任意 |
ファイアウォールの種別。有効な値:
|
InternetFirewall |
| SrcNetworkInstanceId |
string |
任意 |
送信元 VPC の ID。 説明
`FirewallType` が `VpcFirewall` に設定されている場合にのみ、このパラメーターを指定する必要があります。 |
vpc-uf6e9a9zyokj2ywuo**** |
| DstNetworkInstanceId |
string |
任意 |
宛先 VPC の ID。 説明
`FirewallType` が `VpcFirewall` に設定されている場合にのみ、このパラメーターを指定する必要があります。 |
vpc-uf6e9a9zyokj2ywuo**** |
| AttackType |
string |
任意 |
攻撃の種別。有効な値:
説明
このパラメーターを設定しない場合、すべての攻撃種別のイベントが照会されます。 |
1 |
| NoLocation |
string |
任意 |
IP アドレスの位置情報の照会有無を指定します。有効な値:
|
false |
| AttackApp |
array |
任意 |
攻撃対象アプリケーションの名前リスト。`["AttackApp1","AttackApp2"]` 形式で指定します。 |
["MySql","DNS"] |
|
string |
任意 |
攻撃対象アプリケーションの名前。 |
Redis |
|
| BuyVersion |
integer |
任意 |
Cloud Firewall のエディション。有効な値:
|
10 |
| Sort |
string |
任意 |
ソート対象のフィールド。有効な値:
|
LastTime |
| Order |
string |
任意 |
ソート順。有効な値:
|
desc |
| EventName |
string |
任意 |
侵入防止イベントの名称。 |
wooden horse rear door communication |
| IsOnlyPrivateAssoc |
string |
任意 |
プライベート IP アドレスに紐づくデータのみを照会するかどうかを指定します。 |
true |
| AttackAppCategory |
array |
任意 |
攻撃対象アプリケーションのカテゴリリスト。`["AttackAppCategory1","AttackAppCategory2"]` 形式で指定します。 |
|
|
string |
任意 |
攻撃対象アプリケーションのカテゴリ。 |
AI Component |
上記のリクエストパラメーターに加えて、本操作を呼び出す際には共通リクエストパラメーターも指定する必要があります。共通リクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。 リクエストフォーマットについては、本トピックの「例」セクションにあるリクエスト例をご確認ください。
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
侵入防止イベントの詳細情報。 |
||
| TotalCount |
integer |
リスクイベントの合計件数。 |
20 |
| RequestId |
string |
リクエストの ID。 |
B14757D0-4640-4B44-AC67-7F558FE7E6EF |
| DataList |
array<object> |
返されるデータのリスト。 |
|
|
array<object> |
返されるデータのリスト。 |
||
| Direction |
string |
侵入防止イベントのトラフィック方向。有効な値:
|
in |
| EventName |
string |
侵入防止イベントの名称。 |
Web Directory Traversal Attack |
| DstIP |
string |
宛先 IP アドレス。侵入防止イベントはこの宛先 IP アドレスを含みます。 |
192.0.XX.XX |
| AttackType |
integer |
攻撃の種別。有効な値:
|
1 |
| Tag |
string |
重要イベントサポートのタグ。 |
test-tag |
| RuleId |
string |
侵入防止イベントの防御に使用されるルールの ID。 |
1000**** |
| EventId |
string |
侵入防止イベントの ID。 |
2b58efae-4c4b-4d96-9544-a586fb1f**** |
| ResourceType |
string |
パブリック IP アドレスの種別。有効な値:
|
EcsPublicIP |
| FirstEventTime |
integer |
侵入イベントの初回発生日時。値は UNIX タイムスタンプ(単位:秒)です。 |
1534408189 |
| Description |
string |
侵入防止イベントの説明。 |
A directory traversal attack was detected in Web access for HTTP requests |
| EventCount |
integer |
侵入防止イベントの件数。 |
100 |
| VulLevel |
integer |
侵入防止イベントのリスクレベル。有効な値:
|
1 |
| AttackApp |
string |
攻撃対象アプリケーションの名前。 |
MySql |
| RuleSource |
integer |
侵入防止イベント検出に使用されるルールのソース。有効な値:
|
1 |
| RuleResult |
integer |
処理ステータス。有効な値:
|
2 |
| SrcIP |
string |
送信元 IP アドレス。侵入防止イベントはこの送信元 IP アドレスを含みます。 |
192.0.XX.XX |
| LastEventTime |
integer |
侵入防止イベントの最終発生日時。値は UNIX タイムスタンプ(単位:秒)です。 |
1534408267 |
| ResourcePrivateIPList |
array<object> |
侵入防止イベントにおけるプライベート IP アドレスの情報。値は RegionNo、ResourceInstanceId、ResourceInstanceName、ResourcePrivateIP の各パラメーターから構成される配列です。 |
|
|
object |
侵入防止イベントにおけるプライベート IP アドレスの情報。値は RegionNo、ResourceInstanceId、ResourceInstanceName、ResourcePrivateIP の各パラメーターから構成される配列です。 |
||
| ResourceInstanceName |
string |
インスタンスの名前。 |
LD-shenzhen-zy**** |
| ResourcePrivateIP |
string |
プライベート IP アドレス。 |
10.255.XX.XX |
| ResourceInstanceId |
string |
インスタンスの ID。 |
i-wz92jf4scg2zb74p**** |
| RegionNo |
string |
リージョン ID。このパラメーターは、プライベート IP アドレスのリージョン ID を示します。 |
cn-hangzhou |
| SrcPrivateIPList |
array |
侵入防止イベントにおける送信元プライベート IP アドレスのリスト。 |
|
|
string |
侵入防止イベントにおける送信元プライベート IP アドレス。 説明
このパラメーターは、アウトバウンドトラフィックの場合のみ返されます。 |
["192.168.XX.XX","192.168.XX.XX"] |
|
| VpcSrcInfo |
object |
侵入防止イベントの送信元 VPC の情報。この構造体には EcsInstanceId、EcsInstanceName、NetworkInstanceId、NetworkInstanceName、RegionNo の各パラメーターが含まれます。 |
|
| EcsInstanceName |
string |
ECS インスタンスの名前。 |
LD-shenzhen-zy**** |
| NetworkInstanceName |
string |
VPC の名前。 |
VPC-SH-TX**** |
| NetworkInstanceId |
string |
VPC の ID。 |
vpc-uf6e9a9zyokj2ywuo**** |
| EcsInstanceId |
string |
ECS インスタンスの ID。 |
i-wz92jf4scg2zb74p**** |
| RegionNo |
string |
リージョン ID。このパラメーターは、送信元 VPC のリージョン ID を示します。 |
cn-hangzhou |
| VpcDstInfo |
object |
侵入防止イベントの宛先 VPC の情報。この構造体には EcsInstanceId、EcsInstanceName、NetworkInstanceId、NetworkInstanceName、RegionNo の各パラメーターが含まれます。 |
|
| EcsInstanceName |
string |
ECS インスタンスの名前。 |
LD-shenzhen-zy**** |
| NetworkInstanceName |
string |
VPC の名前。 |
VPC-SH-TX**** |
| NetworkInstanceId |
string |
VPC の ID。 |
vpc-uf6e9a9zyokj2ywuo**** |
| EcsInstanceId |
string |
ECS インスタンスの ID。 |
i-wz92jf4scg2zb74p**** |
| RegionNo |
string |
リージョン ID。このパラメーターは、宛先 VPC のリージョン ID を示します。 |
cn-hangzhou |
| IPLocationInfo |
object |
IP アドレスのジオロケーション情報。この構造体には CityId、CityName、CountryId、CountryName の各パラメーターが含まれます。 |
|
| CityId |
string |
都市 ID。 |
510100 |
| CountryName |
string |
国名。 |
China |
| CityName |
string |
都市名。 |
Chengdu |
| CountryId |
string |
国 ID。 |
CN |
SrcIPTag
deprecated
|
string |
送信元 IP アドレスのタグ。このタグは、IP アドレスが Alibaba Cloud サービスのオリジン IP アドレスであるかを識別するために使用されます。 |
WAF Back-to-origin Address |
| SrcIPTags |
array |
IP アドレスタグのリスト。 |
|
|
string |
IP アドレスタグ。 |
Anti-DDoS Back-to-origin Address |
例
成功レスポンス
JSONJSON
{
"TotalCount": 20,
"RequestId": "B14757D0-4640-4B44-AC67-7F558FE7E6EF",
"DataList": [
{
"Direction": "in",
"EventName": "Web Directory Traversal Attack",
"DstIP": "192.0.XX.XX",
"AttackType": 1,
"Tag": "test-tag",
"RuleId": "1000****",
"EventId": "2b58efae-4c4b-4d96-9544-a586fb1f****",
"ResourceType": "EcsPublicIP",
"FirstEventTime": 1534408189,
"Description": "A directory traversal attack was detected in Web access for HTTP requests",
"EventCount": 100,
"VulLevel": 1,
"AttackApp": "MySql",
"RuleSource": 1,
"RuleResult": 2,
"SrcIP": "192.0.XX.XX",
"LastEventTime": 1534408267,
"ResourcePrivateIPList": [
{
"ResourceInstanceName": "LD-shenzhen-zy****",
"ResourcePrivateIP": "10.255.XX.XX",
"ResourceInstanceId": "i-wz92jf4scg2zb74p****",
"RegionNo": "cn-hangzhou"
}
],
"SrcPrivateIPList": [
"[\"192.168.XX.XX\",\"192.168.XX.XX\"]"
],
"VpcSrcInfo": {
"EcsInstanceName": "LD-shenzhen-zy****",
"NetworkInstanceName": "VPC-SH-TX****",
"NetworkInstanceId": "vpc-uf6e9a9zyokj2ywuo****",
"EcsInstanceId": "i-wz92jf4scg2zb74p****",
"RegionNo": "cn-hangzhou"
},
"VpcDstInfo": {
"EcsInstanceName": "LD-shenzhen-zy****",
"NetworkInstanceName": "VPC-SH-TX****",
"NetworkInstanceId": "vpc-uf6e9a9zyokj2ywuo****",
"EcsInstanceId": "i-wz92jf4scg2zb74p****",
"RegionNo": "cn-hangzhou"
},
"IPLocationInfo": {
"CityId": "510100",
"CountryName": "China",
"CityName": "Chengdu",
"CountryId": "CN"
},
"SrcIPTag": "WAF Back-to-origin Address",
"SrcIPTags": [
"Anti-DDoS Back-to-origin Address"
]
}
]
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | ErrorAliUid | Aliuid invalid. | |
| 400 | ErrorFirewallType | The specified firewall type is invalid. | |
| 400 | ErrorParameters | A parameter error occurred. | |
| 400 | ErrorDirectionError | The direction is invalid. | |
| 400 | ErrorIpFormat | The IP address is invalid. | |
| 400 | ErrorRuleSourceError | The rule source is invalid. | |
| 400 | ErrorRuleResultError | The rule result is invalid. | |
| 400 | ErrorVulLevelFailed | VulLevel has failed. | |
| 400 | ErrorTimeError | time range invalid. | |
| 400 | ErrorIntervalError | The interval is invalid. | |
| 400 | ErrorPageNo | Either page number or page size is invalid. | |
| 400 | ErrorDBSelectError | A database select error occurred. | |
| 400 | ErrorMarshalJSON | internal error. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。