文档 AWS SDK 示例 GitHub 存储库中还有更多 [S AWS DK 示例](https://github.com/awsdocs/aws-doc-sdk-examples)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# AWS WAF Classic 使用示例 AWS CLI
<a name="cli_2_waf_code_examples"></a>

以下代码示例向您展示了如何使用with来执行操作和实现常见场景 AWS WAF Classic。 AWS Command Line Interface 

*操作*是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。

每个示例都包含一个指向完整源代码的链接，您可以从中找到有关如何在上下文中设置和运行代码的说明。

**Topics**
+ [操作](#actions)

## 操作
<a name="actions"></a>

### `put-logging-configuration`
<a name="waf_PutLoggingConfiguration_cli_2_topic"></a>

以下代码示例演示了如何使用 `put-logging-configuration`。

**AWS CLI**  
**使用指定的 Kinesis Firehose 流 ARN 为 Web ACL ARN 创建日志记录配置**  
以下`put-logging-configuration`示例显示了 WAF 的 CloudFront日志配置。  

```
aws waf put-logging-configuration \
    --logging-configuration ResourceArn=arn:aws:waf::123456789012:webacl/3bffd3ed-fa2e-445e-869f-a6a7cf153fd3,LogDestinationConfigs=arn:aws:firehose:us-east-1:123456789012:deliverystream/aws-waf-logs-firehose-stream,RedactedFields=[]
```
输出：  

```
{
    "LoggingConfiguration": {
        "ResourceArn": "arn:aws:waf::123456789012:webacl/3bffd3ed-fa2e-445e-869f-a6a7cf153fd3",
        "LogDestinationConfigs": [
            "arn:aws:firehose:us-east-1:123456789012:deliverystream/aws-waf-logs-firehose-stream"
        ]
    }
}
```
+  有关 API 的详细信息，请参阅*AWS CLI 命令参考[PutLoggingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/put-logging-configuration.html)*中的。

### `update-byte-match-set`
<a name="waf_UpdateByteMatchSet_cli_2_topic"></a>

以下代码示例演示了如何使用 `update-byte-match-set`。

**AWS CLI**  
**更新字节匹配集**  
以下`update-byte-match-set`命令删除 a 中的 ByteMatchTuple 对象（过滤器） ByteMatchSet：  

```
aws waf update-byte-match-set --byte-match-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",ByteMatchTuple={FieldToMatch={Type="HEADER",Data="referer"},TargetString="badrefer1",TextTransformation="NONE",PositionalConstraint="CONTAINS"}
```
有关更多信息，请参阅《AWS WAF 开发人员指南》**中的“使用字符串匹配条件”。  
+  有关 API 的详细信息，请参阅*AWS CLI 命令参考[UpdateByteMatchSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/update-byte-match-set.html)*中的。

### `update-ip-set`
<a name="waf_UpdateIpSet_cli_2_topic"></a>

以下代码示例演示了如何使用 `update-ip-set`。

**AWS CLI**  
**更新 IP 集**  
以下`update-ip-set`命令 IPSet 使用 IPv4 地址更新并删除 IPv6 地址：  

```
aws waf update-ip-set --ip-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="INSERT",IPSetDescriptor={Type="IPV4",Value="12.34.56.78/16"},Action="DELETE",IPSetDescriptor={Type="IPV6",Value="1111:0000:0000:0000:0000:0000:0000:0111/128"}
```
或者，也可以使用 JSON 文件来指定输入。例如：  

```
aws waf update-ip-set --ip-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1  --updates file://change.json
```
以下是 JSON 文件的内容：  

```
[
{
"Action": "INSERT",
"IPSetDescriptor":
{
"Type": "IPV4",
"Value": "12.34.56.78/16"
}
},
{
"Action": "DELETE",
"IPSetDescriptor":
{
"Type": "IPV6",
"Value": "1111:0000:0000:0000:0000:0000:0000:0111/128"
}
}
]
```
有关更多信息，请参阅《AWS WAF 开发人员指南》**中的“使用 IP 匹配条件”。  
+  有关 API 的详细信息，请参阅*AWS CLI 命令参考[UpdateIpSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/update-ip-set.html)*中的。

### `update-rule`
<a name="waf_UpdateRule_cli_2_topic"></a>

以下代码示例演示了如何使用 `update-rule`。

**AWS CLI**  
**更新规则**  
以下 `update-rule` 命令删除规则中的 Predicate 对象：  

```
aws waf update-rule --rule-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",Predicate={Negated=false,Type="ByteMatch",DataId="MyByteMatchSetID"}
```
有关更多信息，请参阅《AWS WAF 开发人员指南》**中的“使用规则”。  
+  有关 API 的详细信息，请参阅*AWS CLI 命令参考[UpdateRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/update-rule.html)*中的。

### `update-size-constraint-set`
<a name="waf_UpdateSizeConstraintSet_cli_2_topic"></a>

以下代码示例演示了如何使用 `update-size-constraint-set`。

**AWS CLI**  
**更新大小约束集**  
以下`update-size-constraint-set`命令删除大小约束集中的 SizeConstraint 对象（滤镜）：  

```
aws waf update-size-constraint-set --size-constraint-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",SizeConstraint={FieldToMatch={Type="QUERY_STRING"},TextTransformation="NONE",ComparisonOperator="GT",Size=0}
```
有关更多信息，请参阅《AWS WAF 开发人员指南》**中的“使用大小约束条件”。  
+  有关 API 的详细信息，请参阅*AWS CLI 命令参考[UpdateSizeConstraintSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/update-size-constraint-set.html)*中的。

### `update-sql-injection-match-set`
<a name="waf_UpdateSqlInjectionMatchSet_cli_2_topic"></a>

以下代码示例演示了如何使用 `update-sql-injection-match-set`。

**AWS CLI**  
**更新 SQL 注入匹配集**  
以下`update-sql-injection-match-set`命令删除 SQL 注入匹配集中的 SqlInjectionMatchTuple 对象（过滤器）：  

```
aws waf update-sql-injection-match-set --sql-injection-match-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",SqlInjectionMatchTuple={FieldToMatch={Type="QUERY_STRING"},TextTransformation="URL_DECODE"}
```
有关更多信息，请参阅《AWS WAF 开发人员指南》**中的“使用 SQL 注入匹配条件”。  
+  有关 API 的详细信息，请参阅*AWS CLI 命令参考[UpdateSqlInjectionMatchSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/update-sql-injection-match-set.html)*中的。

### `update-web-acl`
<a name="waf_UpdateWebAcl_cli_2_topic"></a>

以下代码示例演示了如何使用 `update-web-acl`。

**AWS CLI**  
**更新 Web ACL**  
以下 `update-web-acl` 命令删除 Web ACL 中的 `ActivatedRule` 对象。  
aws waf — a123fae4-b567-8e90 update-web-acl -123 web-acl-id 4-5ab67ac8ca90 — change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 — updates action= “删除”，=' \$1Priority=1，=” -1-Example”，Action= \$1type= “Allow”\$1，type= “Regular”\$1 'ActivatedRuleRuleIdWAFRule  
输出：  

```
{
    "ChangeToken": "12cs345-67cd-890b-1cd2-c3a4567d89f1"
}
```
有关更多信息，请参阅 *AWS WAF、Fi AWS rew ACLs all Manager 和 AWS Shield 高级开发者指南*[中的使用 Web](https://docs.aws.amazon.com/waf/latest/developerguide/classic-web-acl-working-with.html)。  
+  有关 API 的详细信息，请参阅*AWS CLI 命令参考[UpdateWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/update-web-acl.html)*中的。

### `update-xss-match-set`
<a name="waf_UpdateXssMatchSet_cli_2_topic"></a>

以下代码示例演示了如何使用 `update-xss-match-set`。

**AWS CLI**  
**更新套 XSSMatch装**  
以下`update-xss-match-set`命令删除中的 XssMatchTuple 对象（滤镜） XssMatchSet：  

```
aws waf update-xss-match-set --xss-match-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",XssMatchTuple={FieldToMatch={Type="QUERY_STRING"},TextTransformation="URL_DECODE"}
```
有关更多信息，请参阅《AWS WAF 开发人员指南》**中的“使用跨站点脚本匹配条件”。  
+  有关 API 的详细信息，请参阅*AWS CLI 命令参考[UpdateXssMatchSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/waf/update-xss-match-set.html)*中的。