View a markdown version of this page

UpdateCustomDetectionRuleAssociation - Amazon GuardDuty

UpdateCustomDetectionRuleAssociation

Updates the mode of an existing custom detection rule association.

Request Syntax

PUT /custom-detection-rule/rule/RuleId/association/AssociationId HTTP/1.1 Content-type: application/json { "mode": "string" }

URI Request Parameters

The request uses the following URI parameters.

AssociationId

The unique identifier for the association to update.

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

Pattern: [a-zA-Z0-9_-]{1,64}

Required: Yes

RuleId

The unique identifier for the custom detection rule.

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

Pattern: [a-z0-9]+(-[a-z0-9]+)*

Required: Yes

Request Body

The request accepts the following data in JSON format.

mode

The rule execution mode. Valid values: LIVE | DRY_RUN.

Type: String

Valid Values: LIVE | DRY_RUN

Required: Yes

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 Error Types.

AccessDeniedException

An access denied exception object.

Message

The error message.

Type

The error type.

HTTP Status Code: 403

BadRequestException

A bad request exception object.

Message

The error message.

Type

The error type.

HTTP Status Code: 400

ConflictException

A request conflict exception object.

Message

The error message.

Type

The error type.

HTTP Status Code: 409

InternalServerErrorException

An internal server error exception object.

Message

The error message.

Type

The error type.

HTTP Status Code: 500

ResourceNotFoundException

The requested resource can't be found.

Message

The error message.

Type

The error type.

HTTP Status Code: 404

See Also

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