---
title: "getThresholdNotiConfig"
slug: "security-filesafer-getthresholdnoticonfig"
updated: 2026-09-17T09:58:23Z
published: 2026-09-17T09:58:23Z
canonical: "api.ncloud-docs.com/security-filesafer-getthresholdnoticonfig"
---

> ## 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.

# getThresholdNotiConfig

Classic/VPC環境で利用できます。

Hash Filterを使用した分析結果の通知設定で高度な設定値を照会します。高度な設定は、一定時間、しきい値に該当するマルウェアが検出されると通知する機能です。

## リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

| メソッド | URI |
| --- | --- |
| POST | /hashfilter/v1/getThresholdNotiConfig |

### リクエストヘッダ

File Safer APIで共通して使用されるヘッダの詳細は、[File Safer APIのリクエストヘッダ](/docs/ja/security-filesafer#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

### リクエスト例

リクエストのサンプルコードは次の通りです。

```
curl --location --request POST 'https://filesafer.apigw.ntruss.com/hashfilter/v1/getThresholdNotiConfig' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-apigw-api-key: {API Gateway API Key}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Accept: application/json'
```

## レスポンス

レスポンス形式を説明します。

### レスポンスボディ

レスポンスボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `returnCode` | String | Required | レスポンスコード |
| `returnMessage` | String | Required | レスポンスメッセージ |
| `thresholdNotificationInfoList` | Array | Required | 分析結果の通知設定情報: [thresholdNotificationInfoList](/docs/ja/security-filesafer-getthresholdnoticonfig#thresholdNotificationInfoList) - オブジェクトがある場合: 通知設定 - オブジェクトがない場合: 通知設定をしない |

#### `thresholdNotificationInfoList`

`thresholdNotificationInfoList`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `notificationType` | String | Conditional | 分析結果の通知条件 - `MAL` \| `ERR` - `MAL`: マルウェア検出時に通知 - `ERR`: 照会失敗時に通知 - 通知設定内で高度な設定をした場合にのみ含む |
| `referenceTime` | Integer | Conditional | しきい値に該当するマルウェアを検出する時間(分) - 5~30 - 通知設定内で高度な設定をした場合にのみ含む |
| `thresholdValue` | Integer | Conditional | しきい値(件) - 1~1000 - 通知設定内で高度な設定をした場合にのみ含む |

### レスポンスステータスコード

File Safer APIで共通して使用されるレスポンスステータスコードの詳細は、[File Saferのレスポンスステータスコード](/docs/ja/security-filesafer#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

### レスポンス例

レスポンスのサンプルコードは次の通りです。

#### 高度な設定をした場合

分析結果の通知設定で高度な設定をした場合、レスポンスのサンプルコードは次の通りです。

```
{
    "returnCode": "0",
    "returnMessage": "success",
    "thresholdNotificationInfoList": [
        {
            "notificationType": "MAL",
            "referenceTime": 5,
            "thresholdValue": 1
        }
    ]
}
```

#### 高度な設定をしなかった場合

分析結果の通知設定で高度な設定をしなかった場合、レスポンスのサンプルコードは次の通りです。

```
{
    "returnCode": "0",
    "returnMessage": "success",
    "thresholdNotificationInfoList": [
    ]
}
```