AWS::WAFv2::RuleGroup CustomResponse - Amazon CloudFormation
SyntaxProperties
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

AWS::WAFv2::RuleGroup CustomResponse

A custom response to send to the client. You can define a custom response for rule actions and default web ACL actions that are set to Block.

For information about customizing web requests and responses, see Customizing web requests and responses in Amazon WAF in the Amazon WAF developer guide.

Syntax

To declare this entity in your Amazon CloudFormation template, use the following syntax:

JSON

{
  "CustomResponseBodyKey" : String,
  "ResponseCode" : Integer,
  "ResponseHeaders" : [ CustomHTTPHeader, ... ]
}

Properties

CustomResponseBodyKey

References the response body that you want Amazon WAF to return to the web request client. You can define a custom response for a rule action or a default web ACL action that is set to block. To do this, you first define the response body key and value in the CustomResponseBodies setting for the AWS::WAFv2::WebACL or AWS::WAFv2::RuleGroup where you want to use it. Then, in the rule action or web ACL default action BlockAction setting, you reference the response body using this key.

Required: No

Type: String

Pattern: ^[\w\-]+$

Update requires: No interruption

ResponseCode

The HTTP status code to return to the client.

For a list of status codes that you can use in your custom responses, see Supported status codes for custom response in the Amazon WAF Developer Guide.

Required: Yes

Type: Integer

Minimum: 200

Maximum: 599

Update requires: No interruption

ResponseHeaders

The HTTP headers to use in the response. You can specify any header name except for content-type. Duplicate header names are not allowed.

For information about the limits on count and size for custom request and response settings, see Amazon WAF quotas in the Amazon WAF Developer Guide.

Required: No

Type: Array of CustomHTTPHeader

Minimum: 1

Update requires: No interruption