GetWebACLForResource - AWS WAFV2

GetWebACLForResource

Retrieves the WebACL for the specified resource.

Request Syntax

{ "ResourceArn": "string" }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

ResourceArn

The Amazon Resource Name (ARN) of the resource whose web ACL you want to retrieve.

The ARN must be in one of the following formats:

  • For an Application Load Balancer: arn:aws:elasticloadbalancing:region:account-id:loadbalancer/app/load-balancer-name/load-balancer-id

  • For an Amazon API Gateway REST API: arn:aws:apigateway:region::/restapis/api-id/stages/stage-name

  • For an AWS AppSync GraphQL API: arn:aws:appsync:region:account-id:apis/GraphQLApiId

  • For an Amazon Cognito user pool: arn:aws:cognito-idp:region:account-id:userpool/user-pool-id

Type: String

Length Constraints: Minimum length of 20. Maximum length of 2048.

Pattern: .*\S.*

Required: Yes

Response Syntax

{ "WebACL": { "ARN": "string", "Capacity": number, "CaptchaConfig": { "ImmunityTimeProperty": { "ImmunityTime": number } }, "ChallengeConfig": { "ImmunityTimeProperty": { "ImmunityTime": number } }, "CustomResponseBodies": { "string" : { "Content": "string", "ContentType": "string" } }, "DefaultAction": { "Allow": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Block": { "CustomResponse": { "CustomResponseBodyKey": "string", "ResponseCode": number, "ResponseHeaders": [ { "Name": "string", "Value": "string" } ] } } }, "Description": "string", "Id": "string", "LabelNamespace": "string", "ManagedByFirewallManager": boolean, "Name": "string", "PostProcessFirewallManagerRuleGroups": [ { "FirewallManagerStatement": { "ManagedRuleGroupStatement": { "ExcludedRules": [ { "Name": "string" } ], "ManagedRuleGroupConfigs": [ { "AWSManagedRulesBotControlRuleSet": { "InspectionLevel": "string" }, "LoginPath": "string", "PasswordField": { "Identifier": "string" }, "PayloadType": "string", "UsernameField": { "Identifier": "string" } } ], "Name": "string", "RuleActionOverrides": [ { "ActionToUse": { "Allow": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Block": { "CustomResponse": { "CustomResponseBodyKey": "string", "ResponseCode": number, "ResponseHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Captcha": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Challenge": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Count": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } } }, "Name": "string" } ], "ScopeDownStatement": { "AndStatement": { "Statements": [ "Statement" ] }, "ByteMatchStatement": { "FieldToMatch": { "AllQueryArguments": { }, "Body": { "OversizeHandling": "string" }, "Cookies": { "MatchPattern": { "All": { }, "ExcludedCookies": [ "string" ], "IncludedCookies": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Headers": { "MatchPattern": { "All": { }, "ExcludedHeaders": [ "string" ], "IncludedHeaders": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "JsonBody": { "InvalidFallbackBehavior": "string", "MatchPattern": { "All": { }, "IncludedPaths": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Method": { }, "QueryString": { }, "SingleHeader": { "Name": "string" }, "SingleQueryArgument": { "Name": "string" }, "UriPath": { } }, "PositionalConstraint": "string", "SearchString": blob, "TextTransformations": [ { "Priority": number, "Type": "string" } ] }, "GeoMatchStatement": { "CountryCodes": [ "string" ], "ForwardedIPConfig": { "FallbackBehavior": "string", "HeaderName": "string" } }, "IPSetReferenceStatement": { "ARN": "string", "IPSetForwardedIPConfig": { "FallbackBehavior": "string", "HeaderName": "string", "Position": "string" } }, "LabelMatchStatement": { "Key": "string", "Scope": "string" }, "ManagedRuleGroupStatement": "ManagedRuleGroupStatement", "NotStatement": { "Statement": "Statement" }, "OrStatement": { "Statements": [ "Statement" ] }, "RateBasedStatement": { "AggregateKeyType": "string", "ForwardedIPConfig": { "FallbackBehavior": "string", "HeaderName": "string" }, "Limit": number, "ScopeDownStatement": "Statement" }, "RegexMatchStatement": { "FieldToMatch": { "AllQueryArguments": { }, "Body": { "OversizeHandling": "string" }, "Cookies": { "MatchPattern": { "All": { }, "ExcludedCookies": [ "string" ], "IncludedCookies": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Headers": { "MatchPattern": { "All": { }, "ExcludedHeaders": [ "string" ], "IncludedHeaders": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "JsonBody": { "InvalidFallbackBehavior": "string", "MatchPattern": { "All": { }, "IncludedPaths": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Method": { }, "QueryString": { }, "SingleHeader": { "Name": "string" }, "SingleQueryArgument": { "Name": "string" }, "UriPath": { } }, "RegexString": "string", "TextTransformations": [ { "Priority": number, "Type": "string" } ] }, "RegexPatternSetReferenceStatement": { "ARN": "string", "FieldToMatch": { "AllQueryArguments": { }, "Body": { "OversizeHandling": "string" }, "Cookies": { "MatchPattern": { "All": { }, "ExcludedCookies": [ "string" ], "IncludedCookies": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Headers": { "MatchPattern": { "All": { }, "ExcludedHeaders": [ "string" ], "IncludedHeaders": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "JsonBody": { "InvalidFallbackBehavior": "string", "MatchPattern": { "All": { }, "IncludedPaths": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Method": { }, "QueryString": { }, "SingleHeader": { "Name": "string" }, "SingleQueryArgument": { "Name": "string" }, "UriPath": { } }, "TextTransformations": [ { "Priority": number, "Type": "string" } ] }, "RuleGroupReferenceStatement": { "ARN": "string", "ExcludedRules": [ { "Name": "string" } ], "RuleActionOverrides": [ { "ActionToUse": { "Allow": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Block": { "CustomResponse": { "CustomResponseBodyKey": "string", "ResponseCode": number, "ResponseHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Captcha": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Challenge": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Count": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } } }, "Name": "string" } ] }, "SizeConstraintStatement": { "ComparisonOperator": "string", "FieldToMatch": { "AllQueryArguments": { }, "Body": { "OversizeHandling": "string" }, "Cookies": { "MatchPattern": { "All": { }, "ExcludedCookies": [ "string" ], "IncludedCookies": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Headers": { "MatchPattern": { "All": { }, "ExcludedHeaders": [ "string" ], "IncludedHeaders": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "JsonBody": { "InvalidFallbackBehavior": "string", "MatchPattern": { "All": { }, "IncludedPaths": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Method": { }, "QueryString": { }, "SingleHeader": { "Name": "string" }, "SingleQueryArgument": { "Name": "string" }, "UriPath": { } }, "Size": number, "TextTransformations": [ { "Priority": number, "Type": "string" } ] }, "SqliMatchStatement": { "FieldToMatch": { "AllQueryArguments": { }, "Body": { "OversizeHandling": "string" }, "Cookies": { "MatchPattern": { "All": { }, "ExcludedCookies": [ "string" ], "IncludedCookies": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Headers": { "MatchPattern": { "All": { }, "ExcludedHeaders": [ "string" ], "IncludedHeaders": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "JsonBody": { "InvalidFallbackBehavior": "string", "MatchPattern": { "All": { }, "IncludedPaths": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Method": { }, "QueryString": { }, "SingleHeader": { "Name": "string" }, "SingleQueryArgument": { "Name": "string" }, "UriPath": { } }, "SensitivityLevel": "string", "TextTransformations": [ { "Priority": number, "Type": "string" } ] }, "XssMatchStatement": { "FieldToMatch": { "AllQueryArguments": { }, "Body": { "OversizeHandling": "string" }, "Cookies": { "MatchPattern": { "All": { }, "ExcludedCookies": [ "string" ], "IncludedCookies": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Headers": { "MatchPattern": { "All": { }, "ExcludedHeaders": [ "string" ], "IncludedHeaders": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "JsonBody": { "InvalidFallbackBehavior": "string", "MatchPattern": { "All": { }, "IncludedPaths": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Method": { }, "QueryString": { }, "SingleHeader": { "Name": "string" }, "SingleQueryArgument": { "Name": "string" }, "UriPath": { } }, "TextTransformations": [ { "Priority": number, "Type": "string" } ] } }, "VendorName": "string", "Version": "string" }, "RuleGroupReferenceStatement": { "ARN": "string", "ExcludedRules": [ { "Name": "string" } ], "RuleActionOverrides": [ { "ActionToUse": { "Allow": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Block": { "CustomResponse": { "CustomResponseBodyKey": "string", "ResponseCode": number, "ResponseHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Captcha": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Challenge": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Count": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } } }, "Name": "string" } ] } }, "Name": "string", "OverrideAction": { "Count": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "None": { } }, "Priority": number, "VisibilityConfig": { "CloudWatchMetricsEnabled": boolean, "MetricName": "string", "SampledRequestsEnabled": boolean } } ], "PreProcessFirewallManagerRuleGroups": [ { "FirewallManagerStatement": { "ManagedRuleGroupStatement": { "ExcludedRules": [ { "Name": "string" } ], "ManagedRuleGroupConfigs": [ { "AWSManagedRulesBotControlRuleSet": { "InspectionLevel": "string" }, "LoginPath": "string", "PasswordField": { "Identifier": "string" }, "PayloadType": "string", "UsernameField": { "Identifier": "string" } } ], "Name": "string", "RuleActionOverrides": [ { "ActionToUse": { "Allow": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Block": { "CustomResponse": { "CustomResponseBodyKey": "string", "ResponseCode": number, "ResponseHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Captcha": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Challenge": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Count": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } } }, "Name": "string" } ], "ScopeDownStatement": { "AndStatement": { "Statements": [ "Statement" ] }, "ByteMatchStatement": { "FieldToMatch": { "AllQueryArguments": { }, "Body": { "OversizeHandling": "string" }, "Cookies": { "MatchPattern": { "All": { }, "ExcludedCookies": [ "string" ], "IncludedCookies": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Headers": { "MatchPattern": { "All": { }, "ExcludedHeaders": [ "string" ], "IncludedHeaders": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "JsonBody": { "InvalidFallbackBehavior": "string", "MatchPattern": { "All": { }, "IncludedPaths": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Method": { }, "QueryString": { }, "SingleHeader": { "Name": "string" }, "SingleQueryArgument": { "Name": "string" }, "UriPath": { } }, "PositionalConstraint": "string", "SearchString": blob, "TextTransformations": [ { "Priority": number, "Type": "string" } ] }, "GeoMatchStatement": { "CountryCodes": [ "string" ], "ForwardedIPConfig": { "FallbackBehavior": "string", "HeaderName": "string" } }, "IPSetReferenceStatement": { "ARN": "string", "IPSetForwardedIPConfig": { "FallbackBehavior": "string", "HeaderName": "string", "Position": "string" } }, "LabelMatchStatement": { "Key": "string", "Scope": "string" }, "ManagedRuleGroupStatement": "ManagedRuleGroupStatement", "NotStatement": { "Statement": "Statement" }, "OrStatement": { "Statements": [ "Statement" ] }, "RateBasedStatement": { "AggregateKeyType": "string", "ForwardedIPConfig": { "FallbackBehavior": "string", "HeaderName": "string" }, "Limit": number, "ScopeDownStatement": "Statement" }, "RegexMatchStatement": { "FieldToMatch": { "AllQueryArguments": { }, "Body": { "OversizeHandling": "string" }, "Cookies": { "MatchPattern": { "All": { }, "ExcludedCookies": [ "string" ], "IncludedCookies": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Headers": { "MatchPattern": { "All": { }, "ExcludedHeaders": [ "string" ], "IncludedHeaders": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "JsonBody": { "InvalidFallbackBehavior": "string", "MatchPattern": { "All": { }, "IncludedPaths": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Method": { }, "QueryString": { }, "SingleHeader": { "Name": "string" }, "SingleQueryArgument": { "Name": "string" }, "UriPath": { } }, "RegexString": "string", "TextTransformations": [ { "Priority": number, "Type": "string" } ] }, "RegexPatternSetReferenceStatement": { "ARN": "string", "FieldToMatch": { "AllQueryArguments": { }, "Body": { "OversizeHandling": "string" }, "Cookies": { "MatchPattern": { "All": { }, "ExcludedCookies": [ "string" ], "IncludedCookies": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Headers": { "MatchPattern": { "All": { }, "ExcludedHeaders": [ "string" ], "IncludedHeaders": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "JsonBody": { "InvalidFallbackBehavior": "string", "MatchPattern": { "All": { }, "IncludedPaths": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Method": { }, "QueryString": { }, "SingleHeader": { "Name": "string" }, "SingleQueryArgument": { "Name": "string" }, "UriPath": { } }, "TextTransformations": [ { "Priority": number, "Type": "string" } ] }, "RuleGroupReferenceStatement": { "ARN": "string", "ExcludedRules": [ { "Name": "string" } ], "RuleActionOverrides": [ { "ActionToUse": { "Allow": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Block": { "CustomResponse": { "CustomResponseBodyKey": "string", "ResponseCode": number, "ResponseHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Captcha": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Challenge": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Count": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } } }, "Name": "string" } ] }, "SizeConstraintStatement": { "ComparisonOperator": "string", "FieldToMatch": { "AllQueryArguments": { }, "Body": { "OversizeHandling": "string" }, "Cookies": { "MatchPattern": { "All": { }, "ExcludedCookies": [ "string" ], "IncludedCookies": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Headers": { "MatchPattern": { "All": { }, "ExcludedHeaders": [ "string" ], "IncludedHeaders": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "JsonBody": { "InvalidFallbackBehavior": "string", "MatchPattern": { "All": { }, "IncludedPaths": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Method": { }, "QueryString": { }, "SingleHeader": { "Name": "string" }, "SingleQueryArgument": { "Name": "string" }, "UriPath": { } }, "Size": number, "TextTransformations": [ { "Priority": number, "Type": "string" } ] }, "SqliMatchStatement": { "FieldToMatch": { "AllQueryArguments": { }, "Body": { "OversizeHandling": "string" }, "Cookies": { "MatchPattern": { "All": { }, "ExcludedCookies": [ "string" ], "IncludedCookies": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Headers": { "MatchPattern": { "All": { }, "ExcludedHeaders": [ "string" ], "IncludedHeaders": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "JsonBody": { "InvalidFallbackBehavior": "string", "MatchPattern": { "All": { }, "IncludedPaths": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Method": { }, "QueryString": { }, "SingleHeader": { "Name": "string" }, "SingleQueryArgument": { "Name": "string" }, "UriPath": { } }, "SensitivityLevel": "string", "TextTransformations": [ { "Priority": number, "Type": "string" } ] }, "XssMatchStatement": { "FieldToMatch": { "AllQueryArguments": { }, "Body": { "OversizeHandling": "string" }, "Cookies": { "MatchPattern": { "All": { }, "ExcludedCookies": [ "string" ], "IncludedCookies": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Headers": { "MatchPattern": { "All": { }, "ExcludedHeaders": [ "string" ], "IncludedHeaders": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "JsonBody": { "InvalidFallbackBehavior": "string", "MatchPattern": { "All": { }, "IncludedPaths": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Method": { }, "QueryString": { }, "SingleHeader": { "Name": "string" }, "SingleQueryArgument": { "Name": "string" }, "UriPath": { } }, "TextTransformations": [ { "Priority": number, "Type": "string" } ] } }, "VendorName": "string", "Version": "string" }, "RuleGroupReferenceStatement": { "ARN": "string", "ExcludedRules": [ { "Name": "string" } ], "RuleActionOverrides": [ { "ActionToUse": { "Allow": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Block": { "CustomResponse": { "CustomResponseBodyKey": "string", "ResponseCode": number, "ResponseHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Captcha": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Challenge": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Count": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } } }, "Name": "string" } ] } }, "Name": "string", "OverrideAction": { "Count": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "None": { } }, "Priority": number, "VisibilityConfig": { "CloudWatchMetricsEnabled": boolean, "MetricName": "string", "SampledRequestsEnabled": boolean } } ], "Rules": [ { "Action": { "Allow": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Block": { "CustomResponse": { "CustomResponseBodyKey": "string", "ResponseCode": number, "ResponseHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Captcha": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Challenge": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Count": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } } }, "CaptchaConfig": { "ImmunityTimeProperty": { "ImmunityTime": number } }, "ChallengeConfig": { "ImmunityTimeProperty": { "ImmunityTime": number } }, "Name": "string", "OverrideAction": { "Count": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "None": { } }, "Priority": number, "RuleLabels": [ { "Name": "string" } ], "Statement": { "AndStatement": { "Statements": [ "Statement" ] }, "ByteMatchStatement": { "FieldToMatch": { "AllQueryArguments": { }, "Body": { "OversizeHandling": "string" }, "Cookies": { "MatchPattern": { "All": { }, "ExcludedCookies": [ "string" ], "IncludedCookies": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Headers": { "MatchPattern": { "All": { }, "ExcludedHeaders": [ "string" ], "IncludedHeaders": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "JsonBody": { "InvalidFallbackBehavior": "string", "MatchPattern": { "All": { }, "IncludedPaths": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Method": { }, "QueryString": { }, "SingleHeader": { "Name": "string" }, "SingleQueryArgument": { "Name": "string" }, "UriPath": { } }, "PositionalConstraint": "string", "SearchString": blob, "TextTransformations": [ { "Priority": number, "Type": "string" } ] }, "GeoMatchStatement": { "CountryCodes": [ "string" ], "ForwardedIPConfig": { "FallbackBehavior": "string", "HeaderName": "string" } }, "IPSetReferenceStatement": { "ARN": "string", "IPSetForwardedIPConfig": { "FallbackBehavior": "string", "HeaderName": "string", "Position": "string" } }, "LabelMatchStatement": { "Key": "string", "Scope": "string" }, "ManagedRuleGroupStatement": { "ExcludedRules": [ { "Name": "string" } ], "ManagedRuleGroupConfigs": [ { "AWSManagedRulesBotControlRuleSet": { "InspectionLevel": "string" }, "LoginPath": "string", "PasswordField": { "Identifier": "string" }, "PayloadType": "string", "UsernameField": { "Identifier": "string" } } ], "Name": "string", "RuleActionOverrides": [ { "ActionToUse": { "Allow": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Block": { "CustomResponse": { "CustomResponseBodyKey": "string", "ResponseCode": number, "ResponseHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Captcha": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Challenge": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Count": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } } }, "Name": "string" } ], "ScopeDownStatement": "Statement", "VendorName": "string", "Version": "string" }, "NotStatement": { "Statement": "Statement" }, "OrStatement": { "Statements": [ "Statement" ] }, "RateBasedStatement": { "AggregateKeyType": "string", "ForwardedIPConfig": { "FallbackBehavior": "string", "HeaderName": "string" }, "Limit": number, "ScopeDownStatement": "Statement" }, "RegexMatchStatement": { "FieldToMatch": { "AllQueryArguments": { }, "Body": { "OversizeHandling": "string" }, "Cookies": { "MatchPattern": { "All": { }, "ExcludedCookies": [ "string" ], "IncludedCookies": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Headers": { "MatchPattern": { "All": { }, "ExcludedHeaders": [ "string" ], "IncludedHeaders": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "JsonBody": { "InvalidFallbackBehavior": "string", "MatchPattern": { "All": { }, "IncludedPaths": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Method": { }, "QueryString": { }, "SingleHeader": { "Name": "string" }, "SingleQueryArgument": { "Name": "string" }, "UriPath": { } }, "RegexString": "string", "TextTransformations": [ { "Priority": number, "Type": "string" } ] }, "RegexPatternSetReferenceStatement": { "ARN": "string", "FieldToMatch": { "AllQueryArguments": { }, "Body": { "OversizeHandling": "string" }, "Cookies": { "MatchPattern": { "All": { }, "ExcludedCookies": [ "string" ], "IncludedCookies": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Headers": { "MatchPattern": { "All": { }, "ExcludedHeaders": [ "string" ], "IncludedHeaders": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "JsonBody": { "InvalidFallbackBehavior": "string", "MatchPattern": { "All": { }, "IncludedPaths": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Method": { }, "QueryString": { }, "SingleHeader": { "Name": "string" }, "SingleQueryArgument": { "Name": "string" }, "UriPath": { } }, "TextTransformations": [ { "Priority": number, "Type": "string" } ] }, "RuleGroupReferenceStatement": { "ARN": "string", "ExcludedRules": [ { "Name": "string" } ], "RuleActionOverrides": [ { "ActionToUse": { "Allow": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Block": { "CustomResponse": { "CustomResponseBodyKey": "string", "ResponseCode": number, "ResponseHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Captcha": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Challenge": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } }, "Count": { "CustomRequestHandling": { "InsertHeaders": [ { "Name": "string", "Value": "string" } ] } } }, "Name": "string" } ] }, "SizeConstraintStatement": { "ComparisonOperator": "string", "FieldToMatch": { "AllQueryArguments": { }, "Body": { "OversizeHandling": "string" }, "Cookies": { "MatchPattern": { "All": { }, "ExcludedCookies": [ "string" ], "IncludedCookies": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Headers": { "MatchPattern": { "All": { }, "ExcludedHeaders": [ "string" ], "IncludedHeaders": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "JsonBody": { "InvalidFallbackBehavior": "string", "MatchPattern": { "All": { }, "IncludedPaths": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Method": { }, "QueryString": { }, "SingleHeader": { "Name": "string" }, "SingleQueryArgument": { "Name": "string" }, "UriPath": { } }, "Size": number, "TextTransformations": [ { "Priority": number, "Type": "string" } ] }, "SqliMatchStatement": { "FieldToMatch": { "AllQueryArguments": { }, "Body": { "OversizeHandling": "string" }, "Cookies": { "MatchPattern": { "All": { }, "ExcludedCookies": [ "string" ], "IncludedCookies": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Headers": { "MatchPattern": { "All": { }, "ExcludedHeaders": [ "string" ], "IncludedHeaders": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "JsonBody": { "InvalidFallbackBehavior": "string", "MatchPattern": { "All": { }, "IncludedPaths": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Method": { }, "QueryString": { }, "SingleHeader": { "Name": "string" }, "SingleQueryArgument": { "Name": "string" }, "UriPath": { } }, "SensitivityLevel": "string", "TextTransformations": [ { "Priority": number, "Type": "string" } ] }, "XssMatchStatement": { "FieldToMatch": { "AllQueryArguments": { }, "Body": { "OversizeHandling": "string" }, "Cookies": { "MatchPattern": { "All": { }, "ExcludedCookies": [ "string" ], "IncludedCookies": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Headers": { "MatchPattern": { "All": { }, "ExcludedHeaders": [ "string" ], "IncludedHeaders": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "JsonBody": { "InvalidFallbackBehavior": "string", "MatchPattern": { "All": { }, "IncludedPaths": [ "string" ] }, "MatchScope": "string", "OversizeHandling": "string" }, "Method": { }, "QueryString": { }, "SingleHeader": { "Name": "string" }, "SingleQueryArgument": { "Name": "string" }, "UriPath": { } }, "TextTransformations": [ { "Priority": number, "Type": "string" } ] } }, "VisibilityConfig": { "CloudWatchMetricsEnabled": boolean, "MetricName": "string", "SampledRequestsEnabled": boolean } } ], "TokenDomains": [ "string" ], "VisibilityConfig": { "CloudWatchMetricsEnabled": boolean, "MetricName": "string", "SampledRequestsEnabled": boolean } } }

Response Elements

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

The following data is returned in JSON format by the service.

WebACL

The web ACL that is associated with the resource. If there is no associated resource, AWS WAF returns a null web ACL.

Type: WebACL object

Errors

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

WAFInternalErrorException

Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your request.

HTTP Status Code: 500

WAFInvalidOperationException

The operation isn't valid.

HTTP Status Code: 400

WAFInvalidParameterException

The operation failed because AWS WAF didn't recognize a parameter in the request. For example:

  • You specified a parameter name or value that isn't valid.

  • Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.

  • You tried to update a WebACL with a DefaultAction that isn't among the types available at DefaultAction.

  • Your request references an ARN that is malformed, or corresponds to a resource with which a web ACL can't be associated.

HTTP Status Code: 400

WAFNonexistentItemException

AWS WAF couldn’t perform the operation because your resource doesn't exist. If you've just created a resource that you're using in this operation, you might just need to wait a few minutes. It can take from a few seconds to a number of minutes for changes to propagate.

HTTP Status Code: 400

WAFUnavailableEntityException

AWS WAF couldn’t retrieve a resource that you specified for this operation. If you've just created a resource that you're using in this operation, you might just need to wait a few minutes. It can take from a few seconds to a number of minutes for changes to propagate. Verify the resources that you are specifying in your request parameters and then retry the operation.

HTTP Status Code: 400

See Also

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