create_regex_pattern_set
¶
create_regex_pattern_set(
name: EntityName,
scope: Scope,
regular_expression_list: RegularExpressionList,
*,
config_overrides: Optional[WAFV2ClientConfig] = None,
description: Optional[EntityDescription] = None,
tags: Optional[TagList] = None,
) -> CreateRegexPatternSetResponse
Creates a RegexPatternSet, which you reference in a RegexPatternSetReferenceStatement, to have WAF inspect a web request component for the specified patterns.
Parameters:
-
name(EntityName) –The name of the set. You cannot change the name after you create the set.
-
scope(Scope) –Specifies whether this is for a global resource type, such as a Amazon CloudFront distribution. For an Amplify application, use
CLOUDFRONT.To work with CloudFront, you must also specify the Region US East (N. Virginia) as follows:
-
CLI - Specify the Region when you use the CloudFront scope:
--scope=CLOUDFRONT --region=us-east-1. -
API and SDKs - For all calls, use the Region endpoint us-east-1.
-
-
description(Optional[EntityDescription], default:None) –A description of the set that helps with identification.
-
regular_expression_list(RegularExpressionList) –Array of regular expression strings.
-
tags(Optional[TagList], default:None) –An array of key:value pairs to associate with the resource.
Raises:
-
WAFDuplicateItemException–WAF couldn’t perform the operation because the resource that you tried to save is a duplicate of an existing one.
-
WAFInternalErrorException–Your request is valid, but WAF couldn’t perform the operation because of a system problem. Retry your request.
-
WAFInvalidOperationException–The operation isn't valid.
-
WAFInvalidParameterException–The operation failed because 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
WebACLwith aDefaultActionthat 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.
-
-
WAFLimitsExceededException–WAF couldn’t perform the operation because you exceeded your resource limit. For example, the maximum number of
WebACLobjects that you can create for an Amazon Web Services account. For more information, see WAF quotas in the WAF Developer Guide. -
WAFOptimisticLockException–WAF couldn’t save your changes because you tried to update or delete a resource that has changed since you last retrieved it. Get the resource again, make any changes you need to make to the new copy, and retry your operation.
-
WAFTagOperationException–An error occurred during the tagging operation. Retry your request.
-
WAFTagOperationInternalErrorException–WAF couldn’t perform your tagging operation because of an internal error. Retry your request.
-
UnknownServiceError–The service returned an error code this client does not model.