POST 脅威インジケーター
2024年8月22日
ID 198625
新しい脅威インジケーターを追加します。
追加した脅威インジケーターは REST API 脅威インジケーターであり、REST API メソッドを使用して管理できます。新しい脅威インジケーターは既定で有効化されます。
パス
/api/%API_VERSION%/suppliers
メソッド
POST
リクエストヘッダー
このリクエストには、次のヘッダーがあります。
リクエストヘッダー
名前 | 値 | 説明 |
---|---|---|
|
| |
|
| レスポンスのコンテンツタイプ。 |
|
| リクエストのコンテンツタイプ。
|
|
| リクエストボディのサイズ(バイト)。 このリクエストボディの最大サイズは、128 MB( |
リクエストボディ
このリクエストボディには、JSON 配列と脅威インジケーターオブジェクトが含まれます。1 つの脅威インジケーターオブジェクトのみを指定する必要があります。
[
{
"name":"%SUPPLIER_NAME%",
"confidence": %SUPPLIER_CONFIDENCE%,
"retention": %SUPPLIER_RETENTION%,
"vendor": "%SUPPLIER_VENDOR%"
}
]
次の表で脅威インジケーターオブジェクトのプロパティについて説明します。
脅威インジケーターオブジェクトのプロパティ
プロパティ | 値 | 必須 | 説明 |
---|---|---|---|
|
| Yes | 脅威インジケーターの名前。 脅威インジケーターの名前には、ラテン文字、数字、ハイフン( 脅威インジケーター名として FalsePositive および InternalTI は使用しないでください。これらは、Kaspersky CyberTrace の組み込み脅威インジケーター名として予約されているためです。 |
|
| Yes | この脅威インジケーターのインジケーターの信頼性レベル。 このパラメータの値の範囲は、 |
|
| Yes | インジケーターの保持時間(分)。 このパラメータにより、この脅威インジケーターのインジケーターがマッチングで使用されなくなるまでのタイムアウトが決定されます。このタイムアウトは、インジケーターの最後の更新時から計算されます。 |
|
| No | 脅威インジケーターのベンダー名。 |
リクエスト例
POST suppliers リクエストの例は、次の通りです。
POST https://192.0.2.57/api/1.1/
Accept: application/json Content-Type: application/json Authorization: Basic Content-Length: 91 [ {"name":"ExampleSupplier", "confidence": 90, "retention": 5000, "vendor": "ExampleVendor"} ] |
レスポンスヘッダー
このレスポンスには、次のヘッダーがあります。
レスポンスヘッダー
名前 | 値 | 説明 |
---|---|---|
Content-Type |
| レスポンスのコンテンツタイプ。 |
Content-Length |
| レスポンスボディのサイズ(バイト)。 |
レスポンスボディ
レスポンスボディには、JSON オブジェクトと操作のステータスが含まれます。
[
{
"status": "Supplier successfully created"
}
]
次の表でステータスオブジェクトのプロパティについて説明します。
ステータスオブジェクトのプロパティ
プロパティ | 値 | 説明 |
---|---|---|
|
| 操作のステータス。 |
レスポンス例
POST suppliers リクエストのレスポンス例は、次の通りです。
НТТР/1.1 201 ОК Date:Mon, 23 Dec 2019 09:56:10 UTC Content-Type: application/json Content-Length: 41
"status": "Supplier successfully created" |
エラーレスポンス
エラーレスポンスには、レスポンスのステータスに関する情報が含まれます。
エラーレスポンスには、JSON オブジェクトとエラーの説明が含まれます。
[
{
"status": "An error occurred while creating some suppliers",
"reason": "%REASON%"
}
]
次の表でエラーオブジェクトのプロパティについて説明します。
エラーオブジェクトのプロパティ
プロパティ | 値 | 説明 |
---|---|---|
|
| エラーの説明。 |
|
| エラーの原因。 |
エラーレスポンスの例
POST suppliers エラーのレスポンス例は、次の通りです。
HTTP/1.1 400 Bad Request Date:Mon, 23 Dec 2019 09:56:10 UTC Content-Type: application/json Content-Length: 92
[{"status": "An error occurred while creating some suppliers", "reason": "Incorrect supplier name"}] |