--- title: "GetExceptedWebshellSuspiciousObject" slug: "security-webshellbehaviordetector-getexceptedwebshellsuspiciousobject" updated: 2026-09-17T09:58:26Z published: 2026-09-17T09:58:26Z canonical: "api.ncloud-docs.com/security-webshellbehaviordetector-getexceptedwebshellsuspiciousobject" --- > ## 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. # GetExceptedWebshellSuspiciousObject VPC環境で利用できます。 例外処理されたウェブシェル行為検知履歴のうち、目的のファイルの詳細情報を照会します。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | GET | /api/v1/exceptions/{exception-id}/suspicious-objects | ### リクエストヘッダ Webshell Behavior Detector APIで共通して使用されるヘッダの詳細は、[Webshell Behavior Detectorのリクエストヘッダ](/docs/ja/security-webshellbehaviordetector#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 ### リクエストパスパラメータ リクエストパスパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `exception-id` | Integer | Required | 例外処理されたウェブシェル行為検知履歴 ID - [GetExceptedWebshell](/docs/ja/security-webshellbehaviordetector-exceptedwebshell-getexceptedwebshell)を通じて`detectionId`を確認 | ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` curl --location --request GET 'https://wbd.apigw.ntruss.com/api/v1/exceptions/2024072321234500000010/suspicious-objects' \ --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' ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスボディ レスポンスボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `success` | Boolean | - | リクエスト処理の有無 | | `code` | Integer | - | レスポンスコード | | `message` | String | - | レスポンスメッセージ | | `result` | Array | - | 疑わしいファイルリスト: [result](/docs/ja/security-webshellbehaviordetector-getexceptedwebshellsuspiciousobject#result) | #### `result` `result`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `suspicionFileId` | String | - | ファイル ID | | `detectionId` | String | - | ウェブシェル行為の検知履歴 ID | | `hostName` | String | - | VMのホスト名 | | `osType` | String | - | VMの OSタイプ | | `fileOriginName` | String | - | ファイル名 | | `quarantineFileName` | String | - | 分離措置されたファイル名 | | `fileSize` | Integer | - | ファイルサイズ | | `sha1` | String | - | ファイルの sha1ハッシュ値 | | `privateIPofServer` | String | - | VMのプライベート IPアドレス | | `fileAuthority` | String | - | ファイルの権限 | | `fileOwner` | String | - | ファイルの所有者 | | `fileGroup` | String | - | ファイル所有グループ | | `accessTime` | Integer | - | ファイルアクセス日時 - Timestamp形式 | | `modifyTime` | Integer | - | ファイル変更日時 - Timestamp形式 | | `changeTime` | Integer | - | ファイル更新日時 - Timestamp形式 | | `instanceNo` | String | - | VMのインスタンス番号 | | `hashScanResult` | String | - | Hashに基づいたマルウェア判断の結果 - `malware` \| `notMalware` - `malware`: マルウェア - `notMalware`: 正常 | | `memo` | String | - | メモ | | `memberNo` | Integer | - | VM使用会員番号 | | `restoreTime` | Integer | - | ファイル復旧日時 - Timestamp形式 | | `quarantineTime` | Integer | - | ファイル隔離日時 - Timestamp形式 | | `weight` | Integer | - | スコア - スコアが高いほどウェブシェルである可能性が高い | | `commandStatus` | String | - | 隔離/復旧コマンドの処理状態 - `restoring` \| `restored` \| `restoreFailed` \| `onQurantine` \| `quarantined` \| `quarantineFailed` - `restoring`: 復旧中 - `restored`: 復旧完了 - `restoreFailed`: 復旧失敗 - `onQurantine`: 隔離中 - `quarantined`: 隔離完了 - `quarantineFailed`: 隔離失敗 | | `commandResult` | String | - | 隔離/復旧コマンド結果の詳細メッセージ | | `isRestore` | Boolean | - | 復旧されたかどうか - `true` \| `false` - `true`: 復旧済み - `false`: 復旧されていない | | `isQuarantine` | Boolean | - | 隔離されたかどうか - `true` \| `false` - `true`: 隔離済み - `false`: 隔離されていない | | `isExcepted` | Boolean | - | 例外処理されたかどうか - `true` \| `false` - `true`: 例外処理済み - `false`: 例外処理されていない | | `lastUpdatedTime` | Integer | - | 最終検知履歴の記録日時 - Timestamp形式 | | `resultCode` | Integer | - | 隔離/復旧コマンドの結果コード | | `platform` | String | - | VM環境 - `VPC` \| `CLASSIC` | | `serverName` | String | - | VMのサーバ名 | | `containerName` | String | - | VMのコンテナ名 | | `k8sName` | String | - | ワークロード名 - Kubernetes環境の場合、有効値を表示 | | `k8sType` | String | - | デプロイされた Podのワークロードタイプ - Kubernetes環境の場合、有効値を表示 | | `podName` | String | - | デプロイされた Pod名 - Kubernetes環境の場合、有効値を表示 | | `isDeleted` | Boolean | - | ファイルは削除されたかどうか - `true` \| `false` - `true`: 削除済み - `false`: 削除されていない | ### レスポンスステータスコード 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": [ { "suspicionFileId": "2024072321234500000008", "detectionId": "2024072321234500000010", "hostName": "{hostname}", "osType": "LINUX", "fileOriginName": "{web-root-path}/{suspicious-object-name}", "quarantineFileName": "{web-root-path}/{quarantined-object-name}", "fileSize": 222, "sha1": "********************************", "privateIPofServer": "***.***.***.***", "fileAuthority": "rw-r--r--", "fileOwner": "root", "fileGroup": "root", "accessTime": 1721737308457, "modifyTime": 1721362317000, "changeTime": 1721737326361, "instanceNo": "25****17", "hashScanResult": "notMalware", "memo": null, "memberNo": 26***90, "restoreTime": 1721737448315, "quarantineTime": 1721737443431, "weight": 29, "commandStatus": "restored", "commandResult": "OK", "isRestore": true, "isQuarantine": true, "isExcepted": false, "lastUpdatedTime": 1721737448341, "resultCode": 0, "platform": "VPC", "serverName": "{servername}", "containerName": "{containername}", "k8sName": "my-pod-jsp", "k8sType": "Pod", "podName": "my-pod-jsp", "isDeleted": false } ] } ```