AWS::WAFv2::RegexPatternSet - AWS CloudFormation
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS::WAFv2::RegexPatternSet

注意

这是 AWS WAF 的最新版本,名为 AWS WAFV2,于 2019 年 11 月发布。有关信息(包括如何从以前的发行版迁移 AWS WAF 资源),请参阅 AWS WAF 开发人员指南

可以使用 AWS::WAFv2::RegexPatternSet 以让 AWS WAF 检查 Web 请求组件,以查找一组特定的正则表达式模式。

在将规则添加到规则组或 Web ACL 时,您可以在规则语句 RegexPatternSetReferenceStatement 中提供正则表达式的 Amazon 资源名称 (ARN) 以使用该表达式。

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

JSON

{ "Type" : "AWS::WAFv2::RegexPatternSet", "Properties" : { "Description" : String, "Name" : String, "RegularExpressionList" : [ String, ... ], "Scope" : String, "Tags" : [ Tag, ... ] } }

YAML

Type: AWS::WAFv2::RegexPatternSet Properties: Description: String Name: String RegularExpressionList: - String Scope: String Tags: - Tag

属性

Description

集合的友好描述。在创建集合后,您无法更改其描述。

必需:否

类型:字符串

最低1

最高256

模式^[\w+=:#@/\-,\.][\w+=:#@/\-,\.\s]+[\w+=:#@/\-,\.]$

Update requires: No interruption

Name

集合的友好名称。在创建集合后,您无法更改名称。

必需:否

类型:字符串

最低1

最高128

模式^[\w\-]+$

Update requires: No interruption

RegularExpressionList

集合中的正则表达式模式。

必需:是

类型:字符串列表

Update requires: No interruption

Scope

指定它用于 AWS CloudFront 分配还是区域应用程序。区域应用程序可能是应用程序负载均衡器 (ALB) 或 API Gateway 阶段。有效值为 CLOUDFRONTREGIONAL

注意

对于 CLOUDFRONT,您必须在美国东部(弗吉尼亚北部)区域创建您的 WAFv2 资源 us-east-1

必需:是

类型:字符串

Update requires: No interruption

Tags

与 AWS 资源关联的键值对。键值对可以是您定义的任何内容。通常,标签键表示一个类别(如“environment”),标签值表示该类别中的特定值(如“test”、“development”或“production”)。您最多可以将 50 个标签添加到每个 AWS 资源中。

注意

要修改现有资源上的标签,请使用 AWS WAF 控制台或 API。借助 AWS CloudFormation,您只能在创建 AWS WAF 资源过程中向资源添加标签。

必需:否

类型Tag 的列表

Update requires: No interruption

返回值

Ref

资源的 Ref,其中包含资源名称、物理 ID 和范围,格式如下:name|id|scope

例如:my-webacl-name|1234a1a-a1b1-12a1-abcd-a123b123456|REGIONAL

Fn::GetAtt

Arn

正则表达式模式集的 Amazon 资源名称 (ARN)。

Id

正则表达式模式集的 ID。

示例

创建正则表达式模式集

下面显示了一个示例正则表达式模式集规范。

JSON

"Description": "Create RegexPatternSet example", "Resources": { "ExampleRegexPatternSet": { "Type": "AWS::WAFv2::RegexPatternSet", "Properties": { "Name": "ExampleRegexPatternSet1", "Scope": "REGIONAL", "Description": "This is an example RegexPatternSet", "RegularExpressionList": [ "^foobar$", "^example$" ] } } }

YAML

Description: Create RegexPatternSet example Resources: ExampleRegexPatternSet: Type: AWS::WAFv2::RegexPatternSet Properties: Name: ExampleRegexPatternSet Scope: REGIONAL Description: This is an example RegexPatternSet RegularExpressionList: - ^foobar$ - ^example$