本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
Amazon WAF V2 的操作、资源和条件键
Amazon WAF V2（服务前缀:wafv2）提供以下特定于服务的资源、操作和条件上下文密钥以在 IAM 权限策略中使用。
参考：
Amazon WAF V2 定义的操作
您可以在 IAM 策略语句的 Action 元素中指定以下操作。可以使用策略授予在 Amazon中执行操作的权限。您在策略中使用一项操作时，通常使用相同的名称允许或拒绝对 API 操作或 CLI 命令的访问。但在某些情况下，单一动作可控制对多项操作的访问。还有某些操作需要多种不同的动作。
操作表的资源类型列指示每项操作是否支持资源级权限。如果该列没有任何值，您必须在策略语句的 Resource 元素中指定策略应用的所有资源（“*”）。通过在 IAM policy 中使用条件来筛选访问权限，以控制是否可以在资源或请求中使用特定标签键。如果操作具有一个或多个必需资源，则调用方必须具有使用这些资源来使用该操作的权限。必需资源在表中以星号 (*) 表示。如果您在 IAM policy 中使用 Resource 元素限制资源访问权限，则必须为每种必需的资源类型添加 ARN 或模式。某些操作支持多种资源类型。如果资源类型是可选的（未指示为必需），则可以选择使用一种可选资源类型。
操作表的条件键列包括可以在策略语句的 Condition 元素中指定的键。有关与服务资源关联的条件键的更多信息，请参阅资源类型表的条件键列。
注意
资源条件键在资源类型表中列出。您可以在操作表的资源类型（* 为必需）列中找到应用于某项操作的资源类型的链接。资源类型表中的资源类型包括条件密钥列，这是应用于操作表中操作的资源条件键。
有关下表中各列的详细信息，请参阅操作表。
| 操作 | 描述 | 访问级别 | 资源类型（* 为必需） | 条件键 | 相关操作 |
|---|---|---|---|---|---|
| AssociateWebACL | 授予权限以将 WebACL 与资源关联。 | Write |
apigateway:SetWebACL apprunner:AssociateWebAcl appsync:SetWebACL cognito-idp:AssociateWebACL ec2:AssociateVerifiedAccessInstanceWebAcl elasticloadbalancing:SetWebAcl |
||
| CheckCapacity | 授予权限以计算指定范围和规则集的 Web ACL 容量单位 (WCU) 要求。 | 读取 | |||
| CreateAPIKey | 授予创建 API 密钥的权限，以便在客户端应用程序中集成 CAPTCHA API 时使用 JavaScript | 写入 | |||
| CreateIPSet | 授予创建 IPSet 的权限 | 写入 | |||
| CreateRegexPatternSet | 授予创建 RegexPatternSet | 写入 | |||
| CreateRuleGroup | 授予创建 RuleGroup | 写入 | |||
| CreateWebACL | 授予创建 WebACL 的权限 | 写入 | |||
| DeleteAPIKey | 授予删除 API 密钥的权限 | 写入 | |||
| DeleteFirewallManagerRuleGroups | 如果不再由 Firewall Manager 管理，则授予 FirewallManagedRulesGroups 从 WebACL 中删除的权限 | 写入 | |||
| DeleteIPSet | 授予删除 IPSet 的权限 | 写入 | |||
| DeleteLoggingConfiguration | 授予 LoggingConfiguration 从 WebACL 中删除的权限 | 写入 | |||
| DeletePermissionPolicy | 授予在 PermissionPolicy 上删除的权限 RuleGroup | 权限管理 | |||
| DeleteRegexPatternSet | 授予删除权限 RegexPatternSet | 写入 | |||
| DeleteRuleGroup | 授予删除权限 RuleGroup | 写入 | |||
| DeleteWebACL | 授予删除 WebACL 的权限 | 写入 | |||
| DescribeAllManagedProducts | 授予权限以检索托管规则组的产品信息 | 读取 | |||
| DescribeManagedProductsByVendor | 授予权限以按给定供应商检索托管规则组的产品信息 | 读取 | |||
| DescribeManagedRuleGroup | 授予权限以查看托管规则组的高级信息。 | 读取 | |||
| DisassociateFirewallManager [仅权限] | 授予权限以取消 Firewall Manager 与 WebACL 的关联 | 写入 | |||
| DisassociateWebACL | 授予权限以取消 WebACL 与应用程序资源的关联 | 写入 |
apigateway:SetWebACL apprunner:DisassociateWebAcl appsync:SetWebACL cognito-idp:DisassociateWebACL ec2:DisassociateVerifiedAccessInstanceWebAcl elasticloadbalancing:SetWebAcl |
||
| GenerateMobileSdkReleaseUrl | 授予权限以为指定版本的移动 SDK 生成预签名下载 URL | 读取 | |||
| GetDecryptedAPIKey | 授予以解密状态返回 API 密钥的权限。使用此权限查看为密钥定义的令牌域 | 读取 | |||
| GetIPSet | 授予检索 IPSet 详细信息的权限 | 读取 | |||
| GetLoggingConfiguration | 授予检索 Web LoggingConfiguration ACL 的权限 | 读取 | |||
| GetManagedRuleSet | 授予检索有关 a 的详细信息的权限 ManagedRuleSet | 读取 | |||
| GetMobileSdkRelease | 授予权限以检索指定版本的移动 SDK 的信息，包括版本注释和标签 | 读取 | |||
| GetPermissionPolicy | 授予检索 a PermissionPolicy 的权限 RuleGroup | 读取 | |||
| GetRateBasedStatementManagedKeys | 授予权限以查看基于速率的规则当前阻止的键。 | 读取 | |||
| GetRegexPatternSet | 授予检索有关 a 的详细信息的权限 RegexPatternSet | 读取 | |||
| GetRuleGroup | 授予检索有关 a 的详细信息的权限 RuleGroup | 读取 | |||
| GetSampledRequests | 授予检索有关 Web 请求采样的详细信息的权限 | Read | |||
| GetWebACL | 授予检索 WebACL 详细信息的权限 | Read | |||
| GetWebACLForResource | 授予检索与资源关联的 WebACL 的权限 | 读取 |
apprunner:DescribeWebAclForService cognito-idp:GetWebACLForResource ec2:GetVerifiedAccessInstanceWebAcl wafv2:GetWebACL |
||
| ListAPIKeys | 授予检索为指定范围定义的 API 密钥列表的权限 | 列出 | |||
| ListAvailableManagedRuleGroupVersions | 授予检索可供您使用的托管规则组版本阵列的权限 | 列出 | |||
| ListAvailableManagedRuleGroups | 授予权限以查看可供您使用的托管规则组数组。 | 列出 | |||
| ListIPSets | 授予您管理的 IP 集检索 IP SetSummary 对象数组的权限 | 列出 | |||
| ListLoggingConfigurations | 授予检索 LoggingConfiguration 对象数组的权限 | 列出 | |||
| ListManagedRuleSets | 授予检索 ManagedRuleSet 对象数组的权限 | 列出 | |||
| ListMobileSdkReleases | 授予权限以检索移动 SDK 和指定设备平台可用版本列表 | 列出 | |||
| ListRegexPatternSets | 授予为你管理的正则表达式模式集检索 RegexPatternSetSummary 对象数组的权限 | 列出 | |||
| ListResourcesForWebACL | 授予权限以查看与指定 Web ACL 关联的资源的 Amazon Resource Name (ARN) 数组。 | 列出 |
apprunner:ListAssociatedServicesForWebAcl cognito-idp:ListResourcesForWebACL ec2:DescribeVerifiedAccessInstanceWebAclAssociations |
||
| ListRuleGroups | 授予您管理的规则组检索 RuleGroupSummary 对象数组的权限 | 列出 | |||
| ListTagsForResource | 授予权限以列出资源的标签 | Read | |||
| ListWebACLs | 授予权限以查看您管理的 Web ACL 的 WebACLSummary 对象数组。 | List | |||
| PutFirewallManagerRuleGroups [仅权限] | 授予在 WebACL FirewallManagedRulesGroups 中创建的权限 | 写入 | |||
| PutLoggingConfiguration | 授予启用 LoggingConfiguration、开始记录 Web ACL 的权限 | 写入 |
iam:CreateServiceLinkedRole |
||
| PutManagedRuleSetVersions | 授予允许创建新版本或更新现有版本的权限 ManagedRuleSet | 写入 | |||
| PutPermissionPolicy | 授予将 IAM policy 附加到资源，以用于在账户之间共享规则组的权限 | 权限管理 | |||
| TagResource | 授予将标签与 Amazon 资源关联的权限 | 标记 | |||
| UntagResource | 授予取消标签与资源的关联的 Amazon 权限 | 标记 | |||
| UpdateIPSet | 授予权限以更新输入 | 写入 | |||
| UpdateManagedRuleSetVersionExpiryDate | 授予更新版本到期日期的权限 ManagedRuleSet | 写入 | |||
| UpdateRegexPatternSet | 授予更新权限 RegexPatternSet | 写入 | |||
| UpdateRuleGroup | 授予更新权限 RuleGroup | 写入 | |||
| UpdateWebACL | 授予权限以更新 WebACL | 写入 | |||
Amazon WAF V2 定义的资源类型
以下资源类型是由该服务定义的，可以在 IAM 权限策略语句的 Resource 元素中使用这些资源类型。操作表中的每个操作指定了可以使用该操作指定的资源类型。您也可以在策略中包含条件键，从而定义资源类型。这些键显示在资源类型表的最后一列。有关下表中各列的详细信息，请参阅资源类型表。
| 资源类型 | ARN | 条件键 |
|---|---|---|
| webacl |
arn:${Partition}:wafv2:${Region}:${Account}:${Scope}/webacl/${Name}/${Id}
|
|
| ipset |
arn:${Partition}:wafv2:${Region}:${Account}:${Scope}/ipset/${Name}/${Id}
|
|
| managedruleset |
arn:${Partition}:wafv2:${Region}:${Account}:${Scope}/managedruleset/${Name}/${Id}
|
|
| rulegroup |
arn:${Partition}:wafv2:${Region}:${Account}:${Scope}/rulegroup/${Name}/${Id}
|
|
| regexpatternset |
arn:${Partition}:wafv2:${Region}:${Account}:${Scope}/regexpatternset/${Name}/${Id}
|
|
| loadbalancer/app/ |
arn:${Partition}:elasticloadbalancing:${Region}:${Account}:loadbalancer/app/${LoadBalancerName}/${LoadBalancerId}
|
|
| apigateway |
arn:${Partition}:apigateway:${Region}::/restapis/${ApiId}/stages/${StageName}
|
|
| appsync |
arn:${Partition}:appsync:${Region}:${Account}:apis/${GraphQLAPIId}
|
|
| userpool |
arn:${Partition}:cognito-idp:${Region}:${Account}:userpool/${UserPoolId}
|
|
| apprunner |
arn:${Partition}:apprunner:${Region}:${Account}:service/${ServiceName}/${ServiceId}
|
|
| verified-access-instance |
arn:${Partition}:ec2:${Region}:${Account}:verified-access-instance/${VerifiedAccessInstanceId}
|
Amazon WAF V2 的条件键
Amazon WAF V2 定义了以下可在 IAM 策略Condition元素中使用的条件键。您可以使用这些键进一步细化应用策略语句的条件。有关下表中各列的详细信息，请参阅条件键表。
要查看适用于所有服务的全局条件键，请参阅可用的全局条件键。
| 条件键 | 描述 | 类型 |
|---|---|---|
| aws:RequestTag/${TagKey} | 按每个标签的允许值集筛选访问 | 字符串 |
| aws:ResourceTag/${TagKey} | 按与资源关联的标签值筛选访问权限 | 字符串 |
| aws:TagKeys | 按请求中是否具有必需标签来筛选访问 | ArrayOfString |
| wafv2:LogDestinationResource | 按日志目标 ARN 筛选访问权限 API PutLoggingConfiguration | ARN |
| wafv2:LogScope | 按日志范围筛选日志配置 API 的访问权限 | 字符串 |