--- title: "SearchDetectionTarget" slug: "security-webshellbehaviordetector-detectionsetting-searchdetectiontarget" updated: 2026-09-17T09:58:26Z published: 2026-09-17T09:58:26Z canonical: "api.ncloud-docs.com/security-webshellbehaviordetector-detectionsetting-searchdetectiontarget" --- > ## 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. # SearchDetectionTarget VPC環境で利用できます。 登録された検知対象のうち、目的の項目を検索します。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | POST | /api/v1/servers | ### リクエストヘッダ Webshell Behavior Detector APIで共通して使用されるヘッダの詳細は、[Webshell Behavior Detectorのリクエストヘッダ](/docs/ja/security-webshellbehaviordetector#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 ### リクエストボディ リクエストボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `pageIndex` | Integer | Optional | ページ番号 | | `pageSize` | Integer | Optional | ページ表示数 | | `agentStatus` | Array | Optional | エージェントの状態 - `enable` \| `disable` \| `notInstalled` \| `error` \| `activating` \| `down` - `enable`: 有効化状態 - `disable`: 無効化状態 - `notInstalled`: 未インストール状態 - `error`: エラー状態 - `activating`: 有効化進行中状態 - `down`: エージェントダウン状態 | | `fileUploadPath` | String | Optional | ファイルのアップロードディレクトリ | | `webRootPath` | String | Optional | ウェブルートディレクトリ | | `ipAddress` | String | Optional | サーバの IPアドレス | | `memo` | String | Optional | メモ | | `serverGroupName` | String | Optional | サーバグループ名 | | `serverImageName` | String | Optional | VMのサーバイメージ名 | | `serverName` | String | Optional | VMのサーバ名 | ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` curl --location --request POST 'https://wbd.apigw.ntruss.com/api/v1/servers' \ --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 '{ "agentStatus": [ "enable" ] }' ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスボディ レスポンスボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `success` | Boolean | - | リクエスト処理の有無 | | `code` | Integer | - | レスポンスコード | | `message` | String | - | レスポンスメッセージ | | `result` | Object | - | レスポンス結果 | | `content` | Array | - | 検知対象リスト: [content](/docs/ja/security-webshellbehaviordetector-detectionsetting-searchdetectiontarget#content) | | `totalCount` | Integer | - | レスポンス結果数 | | `pageSize` | Integer | - | ページ表示数 | | `pageIndex` | Integer | - | ページ番号 | | `totalPages` | Integer | - | ページの総数 | #### `content` `content`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `instanceNo` | String | - | VMのインスタンス番号 | | `serverName` | String | - | VMのサーバ名 | | `serverImageName` | String | - | VMのサーバイメージ名 | | `serverStatus` | String | - | VMの現在の状態 | | `serverType` | String | - | VMタイプ | | `serverEnvType` | String | - | サーバ環境タイプ | | `ipAddress` | String | - | サーバの IPアドレス | | `agentStatus` | String | - | エージェントの状態 | | `serverGroupId` | String | - | サーバグループ ID | | `serverGroupName` | String | - | サーバグループ名 | | `platform` | String | - | サーバのプラットフォーム - `VPC` \| `CLASSIC` | | `wasConfigList` | Array | - | WAS検知設定: [wasConfigList](/docs/ja/security-webshellbehaviordetector-detectionsetting-searchdetectiontarget#wasConfigList) | | `registeredTime` | Integer | - | 検知対象の登録日時 - Timestamp形式 | | `activationTime` | Integer | - | エージェントの有効化日時 - Timestamp形式 | | `latestActivationTime` | Integer | - | エージェントの最終有効化日時 - Timestamp形式 | | `latestDeactivationTime` | Integer | - | エージェントの最終無効化日時 - Timestamp形式 | | `lastUpdatedTime` | Integer | - | 検知対象の最終情報更新日時 - Timestamp形式 | | `memberNo` | Integer | - | VM使用会員番号 | | `memo` | String | - | メモ | | `commandResult` | String | - | コマンド結果の詳細メッセージ | | `resultCode` | String | - | コマンドの結果コード | | `agentVersion` | String | - | インストールされたエージェントのバージョン | | `agentEnable` | Boolean | - | エージェント有効化の有無 - `true` \| `false` - `true`: 有効化 - `false`: 無効化 | | `agentStage` | String | - | エージェントの状態 | | `chargeInstanceNo` | String | - | 課金基準となるインスタンス番号 | | `resultParam` | JSON | - | エージェントの実行/エラーなどの詳細内容 | | `clusterName` | String | - | エージェントがインストールされた Podのクラスタ名 | #### `wasConfigList` `wasConfigList`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `wasType` | String | - | WASタイプ - `jsp` \| `php` | | `webRootPaths` | Array | - | ウェブルートディレクトリ | | `fileUploadPaths` | Array | - | ファイルのアップロードディレクトリ | ### レスポンスステータスコード 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": [ { "instanceNo": "25****43", "serverName": "tomcat", "serverImageName": "CentOS 7.8 (64-bit) with Tomcat", "serverStatus": "running", "serverType": "VPCServer", "serverEnvType": "HOST", "ipAddress": "172.***.***.***", "agentStatus": "enable", "serverGroupId": null, "serverGroupName": null, "platform": "VPC", "wasConfigList": [ { "wasType": "jsp", "webRootPaths": [ "/opt/tomcat/webapps" ], "fileUploadPaths": [ "/opt/tomcat/webapps/helloworld" ] } ], "registeredTime": 1722409425616, "activationTime": 1722410006635, "latestActivationTime": 1722475527004, "latestDeactivationTime": null, "lastUpdatedTime": 1722475536504, "memberNo": 27***85, "memo": "", "commandResult": "OK", "resultCode": 0, "agentVersion": "1.0.5.030", "agentEnable": true, "agentStage": "RUNNING", "chargeInstanceNo": "25****65", "resultParam": null, "clusterName": null } ], "totalCount": 1, "pageSize": 20, "pageIndex": 0, "totalPages": 1 } } ```