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

UpdateIPSet

IPSet ID で指定されている IPSet を更新します。

重要

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

リクエストの構文

POST https://<endpoint>/detector/{detectorId}/ipset/{ipSetId}

本文:

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

パスパラメータ

detectorId

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

型: 文字列

必須: はい

ipSetId

更新対象の IPSet を指定する一意の ID。

型: 文字列

必須: はい

リクエストパラメータ

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

name

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

型: 文字列

必須: いいえ

location

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

型: 文字列

必須: いいえ

activate

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

タイプ: ブール値

必須: いいえ

レスポンスの構文

アクションが成功すると、サービスは 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/ipset/0cb0141ab9fbde177613ab9436212e90 HTTP/1.1 Host: guardduty.us-west-2.amazonaws.com Accept-Encoding: identity Content-Length: 19 Authorization: AUTHPARAMS X-Amz-Date: 20180124T002823Z 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 00:28:25 GMT x-amzn-RequestId: 7d04eb7e-009d-11e8-9150-9b7ab09573a9 X-Amzn-Trace-Id: sampled=0;root=1-5a67d328-1f5cd901719c010f77e58ee3 X-Cache: Miss from cloudfront Via: 1.1 2d8af5cc5befc5d35bb54b4a5b6494c9.cloudfront.net (CloudFront) X-Amz-Cf-Id: 9yHsYLUD63GBTsSwOGPBRRDtoU5m_Ncv9LAJ-EmknNTNxi9wzC0zew== Connection: Keep-alive