--- title: "SearchExceptedWebshell" slug: "security-webshellbehaviordetector-exceptedwebshell-searchexceptedwebshell" updated: 2026-09-17T09:58:26Z published: 2026-09-17T09:58:26Z canonical: "api.ncloud-docs.com/security-webshellbehaviordetector-exceptedwebshell-searchexceptedwebshell" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # SearchExceptedWebshell VPC環境で利用できます。 例外処理されたウェブシェル行為検知履歴のうち、目的の項目を検索します。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | POST | /api/v1/exceptions | ### リクエストヘッダ Webshell Behavior Detector APIで共通して使用されるヘッダの詳細は、[Webshell Behavior Detectorのリクエストヘッダ](/docs/ja/security-webshellbehaviordetector#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 ### リクエストボディ リクエストボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `actionStatus` | String | Optional | 問題対応の状態 - `confirmed` \| `blank` - `confirmed`: 確認完了 - `blank`: 未確認 | | `detectTimeFrom` | Integer | Optional | 検索開始日時 - Timestamp形式 | | `detectTimeTo` | Integer | Optional | 検索終了日時 - Timestamp形式 | | `executor` | String | Optional | プロセス実行アカウント | | `executorOfParent` | String | Optional | 親プロセス実行アカウント | | `hostName` | String | Optional | VMのホスト名 | | `memo` | String | Optional | メモ | | `pageIndex` | Integer | Required | ページ番号 | | `pageSize` | Integer | Required | ページ表示数 | | `privateIPofServer` | String | Optional | VMのプライベート IPアドレス | | `processArg` | String | Optional | プロセス引数値 | | `processArgOfParent` | String | Optional | 親プロセス引数値 | | `processName` | String | Optional | プロセス名 | | `processNameOfParent` | String | Optional | 親プロセス名 | | `serverName` | String | Optional | VMのサーバ名 | | `suspiciousIP` | String | Optional | 疑わしい IPアドレス | ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` curl --location --request POST 'https://wbd.apigw.ntruss.com/api/v1/exceptions' \ --header 'x-ncp-apigw-timestamp: {Timestamp}' \ --header 'x-ncp-iam-access-key: {Access Key}' \ --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \ --header 'Content-Type: application/json' \ --header 'X-NCP-USE_PLATFORM_TYPE: VPC' \ --data '{ "detectTimeFrom": 0, "detectTimeTo": 0, "pageIndex": 1, "pageSize": 2, "serverName": "wbd-****-***-****" }' ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスボディ レスポンスボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `success` | Boolean | - | リクエスト処理の有無 | | `code` | Integer | - | レスポンスコード | | `message` | String | - | レスポンスメッセージ | | `result` | Object | - | レスポンス結果 | | `content` | Array | - | ウェブシェル行為の検知履歴リスト: [content](/docs/ja/security-webshellbehaviordetector-exceptedwebshell-searchexceptedwebshell#content) | | `totalCount` | Integer | - | レスポンス結果数 | | `pageSize` | Integer | - | ページ表示数 | | `pageIndex` | Integer | - | ページ番号 | | `totalPages` | Integer | - | ページの総数 | #### `content` `content`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `detectionId` | String | - | ウェブシェル行為の検知履歴 ID | | `instanceNo` | String | - | VMのインスタンス番号 | | `hostName` | String | - | VMのホスト名 | | `serverName` | String | - | VMのサーバ名 | | `containerName` | String | - | VMのコンテナ名 | | `privateIPofServer` | String | - | VMのプライベート IPアドレス | | `command` | String | - | ファイル実行コマンド | | `processName` | String | - | プロセス名 | | `processArg` | String | - | プロセス引数値 | | `processId` | String | - | プロセス ID | | `executor` | String | - | プロセス実行アカウント | | `processIdOfParent` | String | - | 親プロセス ID | | `processNameOfParent` | String | - | 親プロセス名 | | `processArgOfParent` | String | - | 親プロセス引数値 | | `executorOfParent` | String | - | 親プロセス実行アカウント | | `uid` | String | - | 検知プロセス UID | | `euid` | String | - | プロセス EUID | | `gid` | String | - | プロセス GID | | `egid` | String | - | プロセス EGID | | `actionStatus` | String | - | 問題対応の状態 - `confirmed` \| `blank` - `confirmed`: 確認完了 - `blank`: 未確認 | | `memo` | String | - | メモ | | `actionTime` | Integer | - | ウェブシェル行為の発生日時 - Timestamp形式 | | `detectTime` | Integer | - | ウェブシェル行為の検知日時 - Timestamp形式 | | `collectTime` | Integer | - | ウェブシェル行為の収集日時 - Timestamp形式 | | `lastUpdatedTime` | Integer | - | 最終検知履歴の記録日時 - Timestamp形式 | | `isChecked` | Boolean | - | 検知履歴を確認したかどうか - `true` \| `false` - `true`: 確認完了 - `false`: 未確認 | | `memberNo` | Integer | - | VM使用会員番号 | | `detectionRuleId` | String | - | 検知ポリシー ID | | `suspicionFiles` | Array | - | 疑わしいファイルリスト: [suspicionFiles](/docs/ja/security-webshellbehaviordetector-exceptedwebshell-searchexceptedwebshell#suspicionFiles) | | `suspicionIps` | Array | - | 疑わしい IPアドレスリスト: [suspicionIps](/docs/ja/security-webshellbehaviordetector-exceptedwebshell-searchexceptedwebshell#suspicionIps) | | `osType` | String | - | VMの OSタイプ | #### `suspicionFiles` `suspicionFiles`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `suspicionFileId` | String | - | ファイル ID | | `fileOriginName` | String | - | ファイル名 | | `fileOwner` | String | - | ファイルの所有者 | | `weight` | Integer | - | スコア - スコアが高いほどウェブシェルである可能性が高い | | `accessTime` | Integer | - | ファイルアクセス日時 - Timestamp形式 | | `modifyTime` | Integer | - | ファイル変更日時 - Timestamp形式 | | `changeTime` | Integer | - | ファイル更新日時 - Timestamp形式 | | `detectionId` | String | - | ウェブシェル行為の検知履歴 ID | #### `suspicionIps` `suspicionIps`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `suspicionIpId` | String | - | 疑わしい IPアドレスの ID | | `detectionId` | String | - | ウェブシェル行為の検知履歴 ID | | `suspicionIp` | String | - | 疑わしい IPアドレス | | `country` | String | - | 疑わしい IPアドレスの国 | | `platform` | String | - | VM環境 - `VPC` \| `CLASSIC` | ### レスポンスステータスコード Webshell Behavior Detector APIで共通して使用されるレスポンスステータスコードの詳細は、[Webshell Behavior Detectorのレスポンスステータスコード](/docs/ja/security-webshellbehaviordetector#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 レスポンスのサンプルコードは次の通りです。 ``` { "success": true, "code": 0, "message": "success", "result": { "content": [ { "detectionId": "2024072321225900000008", "instanceNo": "25****17", "hostName": "{hostname}", "serverName": "{servername}", "containerName": "{containername}", "privateIPofServer": "***.***.***.***", "command": "{command}", "processName": "{process}", "processArg": "{process-and-arguments}", "processId": "{command-process-id}", "executor": "DefaultAppPool", "processIdOfParent": "{command-process-id}", "processNameOfParent": "{process}", "processArgOfParent": "{process-and-arguments}", "executorOfParent": "DefaultAppPool", "uid": "0", "euid": "0", "gid": "0", "egid": "0", "actionStatus": "blank", "detectTime": 1721737379713, "collectTime": 1721737379933, "lastUpdatedTime": 1721737392197, "isChecked": false, "memberNo": 26***90, "detectionRuleId": "2020110215374500000038", "suspicionIps": [], "osType": "LINUX" }, { "detectionId": "2024072321110800000002", "instanceNo": "25****17", "hostName": "{hostname}", "serverName": "{servername}", "containerName": "{containername}", "privateIPofServer": "***.***.***.***", "command": "{command}", "processName": "{process}", "processArg": "{process-and-arguments}", "processId": "{command-process-id}", "executor": "www-data", "processIdOfParent": "{command-process-id}", "processNameOfParent": "{process}", "processArgOfParent": "{process-and-arguments}", "executorOfParent": "www-data", "uid": "33", "euid": "33", "gid": "33", "egid": "33", "actionStatus": "blank", "actionTime": 1721736687176, "detectTime": 1721736668622, "collectTime": 1721736669272, "lastUpdatedTime": 1721736701611, "isChecked": false, "memberNo": 26***90, "detectionRuleId": "2020110215374200000034", "suspicionIps": [ { "suspicionIpId": "2024072321110900000002", "detectionId": "2024072321110800000002", "suspicionIp": "***.***.***.***", "country": null, "platform": "VPC" } ], "osType": "LINUX" } ], "totalCount": 4, "pageSize": 2, "pageIndex": 1, "totalPages": 2 } } ```