AWS WAF 的操作、资源和条件键

AWS WAF（服务前缀:waf）提供以下特定于服务的资源、操作和条件上下文密钥，供在 IAM 权限策略中使用。

参考：

了解如何配置该服务。
查看适用于该服务的 API 操作列表。
了解如何使用 IAM 权限策略保护该服务及其资源。

主题

AWS WAF 定义的操作
AWS WAF 定义的资源类型
AWS WAF 的条件键

AWS WAF 定义的操作

您可以在 IAM 策略语句的 Action 元素中指定以下操作。可以使用策略授予在 AWS中执行操作的权限。您在策略中使用一项操作时，通常使用相同的名称允许或拒绝对 API 操作或 CLI 命令的访问。但在某些情况下，单一动作可控制对多项操作的访问。还有某些操作需要多种不同的动作。

“操作” 表的 “访问级别” 列描述了如何对操作进行分类（列出、读取、权限管理或标记）。此分类可以帮助您了解当您在策略中使用操作时，相应操作授予的访问级别。有关访问级别的更多信息，请参阅策略摘要中的访问级别。

操作表的资源类型列指示每项操作是否支持资源级权限。如果该列没有任何值，您必须在策略语句的 Resource 元素中指定策略应用的所有资源（“*”）。通过在 IAM policy 中使用条件来筛选访问权限，以控制是否可以在资源或请求中使用特定标签键。如果操作具有一个或多个必需资源，则调用方必须具有使用这些资源来使用该操作的权限。必需资源在表中以星号 (*) 表示。如果您在 IAM policy 中使用 Resource 元素限制资源访问权限，则必须为每种必需的资源类型添加 ARN 或模式。某些操作支持多种资源类型。如果资源类型是可选的（未指示为必需），则可以选择使用一种可选资源类型。

操作表的条件键列包括可以在策略语句的 Condition 元素中指定的键。有关与服务资源关联的条件键的更多信息，请参阅资源类型表的条件键列。

“操作” 表格的 “依赖操作” 列显示成功调用操作可能需要的其他权限。除了操作本身的权限外，可能还需要这些权限。当操作指定依赖操作时，这些依赖关系可能适用于为该操作定义的其他资源，而不仅仅是表格中列出的第一个资源。

注意

资源条件键在资源类型表中列出。您可以在操作表的资源类型（* 为必需）列中找到应用于某项操作的资源类型的链接。资源类型表中的资源类型包括条件密钥列，这是应用于操作表中操作的资源条件键。

有关下表中各列的详细信息，请参阅操作表。

操作	描述	访问级别	资源类型（* 为必需）	条件键	相关操作
CreateByteMatchSet	授予创建 ByteMatchSet	写入	bytematchset*
CreateGeoMatchSet	授予创建 GeoMatchSet	写入	geomatchset*
CreateIPSet	授予创建 IPSet	写入	ipset*
CreateRateBasedRule	授予创建权限 RateBasedRule 以限制来自单个 IP 地址的请求量	写入	ratebasedrule*
CreateRateBasedRule	授予创建权限 RateBasedRule 以限制来自单个 IP 地址的请求量	写入		aws:RequestTag/${TagKey} aws:TagKeys
CreateRegexMatchSet	授予创建 RegexMatchSet	写入	regexmatchset*
CreateRegexPatternSet	授予创建 RegexPatternSet	写入	regexpatternset*
CreateRule	授予创建规则以筛选 Web 请求的权限	写入	rule*
CreateRule	授予创建规则以筛选 Web 请求的权限	写入		aws:RequestTag/${TagKey} aws:TagKeys
CreateRuleGroup	授予创建的权限 RuleGroup，这是一组可以在 WebACL 中使用的预定义规则	写入	rulegroup*
CreateRuleGroup	授予创建的权限 RuleGroup，这是一组可以在 WebACL 中使用的预定义规则	写入		aws:RequestTag/${TagKey} aws:TagKeys
CreateSizeConstraintSet	授予创建 SizeConstraintSet	写入	sizeconstraintset*
CreateSqlInjectionMatchSet	授予创建 SqlInjectionMatchSet	写入	sqlinjectionmatchset*
CreateWebACL	授予创建 WebACL 的权限，其中包含筛选 Web 请求的规则	权限管理	webacl*
CreateWebACL	授予创建 WebACL 的权限，其中包含筛选 Web 请求的规则	权限管理		aws:RequestTag/${TagKey} aws:TagKeys
CreateWebACLMigrationStack	授予在 S3 存储桶中创建 CloudFormation Web ACL 模板的权限，以便将 Web ACL 从 AWS WAF Classic 迁移到 W AWS AF v2	写入	webacl*		s3:PutObject
CreateXssMatchSet	授予创建权限 XssMatchSet，用于检测包含跨站脚本攻击的请求	写入	xssmatchset*
DeleteByteMatchSet	授予删除权限 ByteMatchSet	写入	bytematchset*
DeleteGeoMatchSet	授予删除权限 GeoMatchSet	写入	geomatchset*
DeleteIPSet	授予删除的权限 IPSet	写入	ipset*
DeleteLoggingConfiguration	授予 LoggingConfiguration 从 Web ACL 中删除的权限	写入	webacl*
DeletePermissionPolicy	授予从规则组中删除 IAM policy 的权限	权限管理	rulegroup*
DeleteRateBasedRule	授予删除权限 RateBasedRule	写入	ratebasedrule*
DeleteRegexMatchSet	授予删除权限 RegexMatchSet	写入	regexmatchset*
DeleteRegexPatternSet	授予删除权限 RegexPatternSet	写入	regexpatternset*
DeleteRule	授予删除规则的权限	写入	rule*
DeleteRuleGroup	授予删除权限 RuleGroup	写入	rulegroup*
DeleteSizeConstraintSet	授予删除权限 SizeConstraintSet	写入	sizeconstraintset*
DeleteSqlInjectionMatchSet	授予删除的权限 SqlInjectionMatchSet	写入	sqlinjectionmatchset*
DeleteWebACL	授予删除 WebACL 的权限	权限管理	webacl*
DeleteXssMatchSet	授予删除的权限 XssMatchSet	写入	xssmatchset*
GetByteMatchSet	授予检索权限 ByteMatchSet	读取	bytematchset*
GetChangeToken	授予检索要在创建、更新和删除请求中使用的更改令牌的权限	Read
GetChangeTokenStatus	授予检索更改令牌状态的权限	读取
GetGeoMatchSet	授予检索权限 GeoMatchSet	读取	geomatchset*
GetIPSet	授予检索权限 IPSet	读取	ipset*
GetLoggingConfiguration	授予检索 Web ACL LoggingConfiguration 的权限	读取	webacl*
GetPermissionPolicy	授予检索规则组的 IAM policy 的权限	读取	rulegroup*
GetRateBasedRule	授予检索权限 RateBasedRule	读取	ratebasedrule*
GetRateBasedRuleManagedKeys	授予检索当前被屏蔽的 IP 地址数组的权限 RateBasedRule	读取	ratebasedrule*
GetRegexMatchSet	授予检索权限 RegexMatchSet	读取	regexmatchset*
GetRegexPatternSet	授予检索权限 RegexPatternSet	读取	regexpatternset*
GetRule	授予检索规则的权限	读取	rule*
GetRuleGroup	授予检索权限 RuleGroup	读取	rulegroup*
GetSampledRequests	授予检索有关 Web 请求示例集的详细信息的权限	读取	webacl
GetSizeConstraintSet	授予检索权限 SizeConstraintSet	读取	sizeconstraintset*
GetSqlInjectionMatchSet	授予检索权限 SqlInjectionMatchSet	读取	sqlinjectionmatchset*
GetWebACL	授予检索 WebACL 的权限	读取	webacl*
GetXssMatchSet	授予检索权限 XssMatchSet	读取	xssmatchset*
ListActivatedRulesInRuleGroup	授予检索 ActivatedRule 对象数组的权限	列表
ListByteMatchSets	授予检索 ByteMatchSetSummary 对象数组的权限	列表
ListGeoMatchSets	授予检索 GeoMatchSetSummary 对象数组的权限	列表
ListIPSets	授予检索 IPSet摘要对象数组的权限	列表
ListLoggingConfigurations	授予检索 LoggingConfiguration 对象数组的权限	列表
ListRateBasedRules	授予检索 RuleSummary 对象数组的权限	列表
ListRegexMatchSets	授予检索 RegexMatchSetSummary 对象数组的权限	列表
ListRegexPatternSets	授予检索 RegexPatternSetSummary 对象数组的权限	列表
ListRuleGroups	授予检索 RuleGroup 对象数组的权限	列表
ListRules	授予检索 RuleSummary 对象数组的权限	列表
ListSizeConstraintSets	授予检索 SizeConstraintSetSummary 对象数组的权限	列表
ListSqlInjectionMatchSets	授予检索 SqlInjectionMatchSet 对象数组的权限	列表
ListSubscribedRuleGroups	授予检索您订阅的 RuleGroup 对象数组的权限	列表
ListTagsForResource	授予检索资源标签的权限	读取	ratebasedrule
			rule
			rulegroup
			webacl
ListWebACLs	授予检索 Web ACLSummary 对象数组的权限	列表
ListXssMatchSets	授予检索 XssMatchSet 对象数组的权限	列表
PutLoggingConfiguration	授予将 LoggingConfiguration 与指定的 Web ACL 关联的权限	写入	webacl*		iam:CreateServiceLinkedRole
PutPermissionPolicy	授予将 IAM policy 附加到规则组，以在账户之间共享规则组的权限	Permissions management	rulegroup*
TagResource	授予将标签添加到资源的权限	Tagging	ratebasedrule
			rule
			rulegroup
			webacl
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	授予从资源中删除标签的权限	标记	ratebasedrule
			rule
			rulegroup
			webacl
				aws:TagKeys
UpdateByteMatchSet	授予在中插入或删除 ByteMatchTuple 对象的权限 ByteMatchSet	写入	bytematchset*
UpdateGeoMatchSet	授予在中插入或删除 GeoMatchConstraint 对象的权限 GeoMatchSet	写入	geomatchset*
UpdateIPSet	授予在中插入或删除 IPSet描述符对象的权限 IPSet	写入	ipset*
UpdateRateBasedRule	授予修改基于费率的规则的权限	写入	ratebasedrule*
UpdateRegexMatchSet	授予在中插入或删除 RegexMatchTuple 对象的权限 RegexMatchSet	写入	regexmatchset*
UpdateRegexPatternSet	授予在中插入或删除 RegexPatternStrings 的权限 RegexPatternSet	写入	regexpatternset*
UpdateRule	授予修改配方的权限	写入	rule*
UpdateRuleGroup	授予在中插入或删除 ActivatedRule 对象的权限 RuleGroup	写入	rulegroup*
UpdateSizeConstraintSet	授予在中插入或删除 SizeConstraint 对象的权限 SizeConstraintSet	写入	sizeconstraintset*
UpdateSqlInjectionMatchSet	授予在中插入或删除 SqlInjectionMatchTuple 对象的权限 SqlInjectionMatchSet	写入	sqlinjectionmatchset*
UpdateWebACL	授予在 WebACL 中插入或删除 ActivatedRule 对象的权限	权限管理	webacl*
UpdateXssMatchSet	授予在中插入或删除 XssMatchTuple 对象的权限 XssMatchSet	写入	xssmatchset*

AWS WAF 定义的资源类型

以下资源类型是由该服务定义的，可以在 IAM 权限策略语句的 Resource 元素中使用这些资源类型。操作表中的每个操作指定了可以使用该操作指定的资源类型。您也可以在策略中包含条件键，从而定义资源类型。这些键显示在资源类型表的最后一列。有关下表中各列的详细信息，请参阅资源类型表。

资源类型	ARN	条件键
bytematchset	`arn:${Partition}:waf::${Account}:bytematchset/${Id}`
ipset	`arn:${Partition}:waf::${Account}:ipset/${Id}`
ratebasedrule	`arn:${Partition}:waf::${Account}:ratebasedrule/${Id}`	aws:ResourceTag/${TagKey}
rule	`arn:${Partition}:waf::${Account}:rule/${Id}`	aws:ResourceTag/${TagKey}
sizeconstraintset	`arn:${Partition}:waf::${Account}:sizeconstraintset/${Id}`
sqlinjectionmatchset	`arn:${Partition}:waf::${Account}:sqlinjectionset/${Id}`
webacl	`arn:${Partition}:waf::${Account}:webacl/${Id}`	aws:ResourceTag/${TagKey}
xssmatchset	`arn:${Partition}:waf::${Account}:xssmatchset/${Id}`
regexmatchset	`arn:${Partition}:waf::${Account}:regexmatch/${Id}`
regexpatternset	`arn:${Partition}:waf::${Account}:regexpatternset/${Id}`
geomatchset	`arn:${Partition}:waf::${Account}:geomatchset/${Id}`
rulegroup	`arn:${Partition}:waf::${Account}:rulegroup/${Id}`	aws:ResourceTag/${TagKey}

AWS WAF 的条件键

AWS WAF 定义了以下可在 IAM 策略Condition元素中使用的条件键。您可以使用这些键进一步细化应用策略语句的条件。有关下表中各列的详细信息，请参阅条件键表。

要查看适用于所有服务的全局条件密钥，请参阅AWS 全局条件上下文密钥。

条件键	描述	类型
aws:RequestTag/${TagKey}	根据每个标签的允许值集筛选操作	字符串
aws:ResourceTag/${TagKey}	根据与资源关联的标签值筛选操作	字符串
aws:TagKeys	根据在请求中是否具有必需标签以筛选操作	ArrayOfString

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

Amazon VPC Lattice Services

AWS WAF 区域版