UpdateIPSet - Amazon GuardDuty

UpdateIPSet

Updates the IPSet specified by the IPSet ID.

Request Syntax

POST /detector/detectorId/ipset/ipSetId HTTP/1.1 Content-type: application/json { "activate": boolean, "location": "string", "name": "string" }

URI Request Parameters

The request uses the following URI parameters.

detectorId

The detectorID that specifies the GuardDuty service whose IPSet you want to update.

To find the detectorId in the current Region, see the Settings page in the GuardDuty console, or run the ListDetectors API.

Length Constraints: Minimum length of 1. Maximum length of 300.

Required: Yes

ipSetId

The unique ID that specifies the IPSet that you want to update.

Required: Yes

Request Body

The request accepts the following data in JSON format.

activate

The updated Boolean value that specifies whether the IPSet is active or not.

Type: Boolean

Required: No

location

The updated URI of the file that contains the IPSet.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 300.

Required: No

name

The unique ID that specifies the IPSet that you want to update.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 300.

Required: No

Response Syntax

HTTP/1.1 200

Response Elements

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

Errors

For information about the errors that are common to all actions, see Common Errors.

BadRequestException

A bad request exception object.

HTTP Status Code: 400

InternalServerErrorException

An internal server error exception object.

HTTP Status Code: 500

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: