Amazon GuardDuty
Amazon Guard Duty ユーザーガイド

UpdateThreatIntelSet

ThreatIntelSet ID で指定された ThreatIntelSet を更新します。

重要

GuardDuty メンバーアカウントのユーザーが、この API を実行することはできません。現在、GuardDuty では、メンバーアカウントのユーザーが ThreatIntelSets のアップロードや管理を行うことはできません。マスターアカウントからアップロードされた ThreatIntelSets は、そのメンバーアカウントの GuardDuty 機能に適用されます。詳細については、「Amazon GuardDuty でのアカウントの管理」を参照してください。

リクエストの構文

POST https://<endpoint>/detector/{detectorId}/threatintelset/{threatIntelSetId}

本文:

{ "name": "string", "location": "string", "activate": "boolean" }

パスパラメータ

detectorId

ThreatIntelSet を更新する対象の GuardDuty サービスを指定するディテクター ID。

型: 文字列

必須: はい

threatIntelSetId

更新する ThreatIntelSet を指定する一意の ID。

型: 文字列

必須: はい

リクエストパラメータ

リクエストは以下のデータを JSON 形式で受け入れます。

name

更新された ThreatIntelSet のわかりやすい名前。

型: 文字列

必須: いいえ

location

ThreatIntelSet を含むファイルの更新された URI。

型: 文字列

必須: いいえ

activate

ThreateIntelSet がアクティブであるかどうかを指定します。

必須: いいえ

タイプ: ブール値

レスポンスの構文

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

エラー

アクションが失敗すると、サービスより HTTP エラーレスポンスコードとエラー情報の詳細が返ります。

InvalidInputException

リクエストは却下されました。無効な値または範囲外の値が入力パラメータとして指定されています。

HTTP ステータスコード: 400

InvalidInputException

リクエストは却下されました。必要なクエリまたはパスパラメータが指定されていません。

HTTP ステータスコード: 400

InvalidInputException

リクエストは却下されました。1 つ以上の入力パラメータの値が無効です。

HTTP ステータスコード: 400

InvalidInputException

リクエストは却下されました。パラメータ (detectorId) の値が無効です。

HTTP ステータスコード: 400

InvalidInputException

リクエストは却下されました。指定された ipSetId は無効です。

HTTP ステータスコード: 400

InvalidInputException

リクエストは却下されました。メンバーアカウントが IPSets や ThreatIntelSets を管理することはできません。

HTTP ステータスコード: 400

NoSuchEntityException

リクエストは却下されました。入力 (detectorId) は、現在のアカウントによって所有されていません。

HTTP ステータスコード: 400

NoSuchEntityException

リクエストは却下されました。指定された ipSetId は無効です。

HTTP ステータスコード: 400

AccessDeniedException

リクエストは却下されました。この API を呼び出す許可が発信者に与えられていません。

HTTP ステータスコード: 400

NoSuchEntityException

リクエストは却下されました。ロールが見つかりませんでした。

HTTP ステータスコード: 400

BadRequestException

リクエストは却下されました。このサービスでサービスロールを引き受けることはできません。

HTTP ステータスコード: 400

AccessDeniedException

リクエストは却下されました。必要なアクセス許可 (iam:PutRolePolicy) がありません。

HTTP ステータスコード: 400

BadRequestException

リクエストは却下されました。指定したサービスロールはサービスにリンクされたロールではありません。

HTTP ステータスコード: 400

InternalException

内部サーバーエラー。

HTTP ステータスコード: 500

リクエスト例

POST /detector/12abc34d567e8fa901bc2d34e56789f0/threatintelset/8cb094db7082fd0db09479755d215dba HTTP/1.1 Host: guardduty.us-west-2.amazonaws.com Accept-Encoding: identity Content-Length: 19 Authorization: AUTHPARAMS X-Amz-Date: 20180124T212506Z User-Agent: aws-cli/1.14.29 Python/2.7.9 Windows/8 botocore/1.8.33 { "activate":false }

レスポンス例

HTTP/1.1 200 OK Content-Type: application/json Content-Length: 0 Date: Wed, 24 Jan 2018 21:25:09 GMT x-amzn-RequestId: 0d3e8284-014d-11e8-beb7-958380c0c8da X-Amzn-Trace-Id: sampled=0;root=1-5a68f9b4-00718037918ec6f8abaacddd X-Cache: Miss from cloudfront Via: 1.1 7a06af51e583997d8673ab89482dd45a.cloudfront.net (CloudFront) X-Amz-Cf-Id: 1YgXeOCWt1SC7nBaB2s8unBvIfhp45JRVJxXL3B-KHRWByGMCAyNRA== Connection: Keep-alive