aws-sdk-wafv2

WAF是一种Web应用防火墙，可让您监控转发到Amazon CloudFront分发、Amazon API Gateway REST API、应用程序负载均衡器、AppSync GraphQL API、Amazon Cognito用户池、App Runner服务或Amazon Web Services Verified Access实例的HTTP和HTTPS请求。WAF还允许您控制对您内容的访问，以保护WAF正在监控的Amazon Web Services资源。根据您指定的条件，例如请求的IP地址或查询字符串的值，受保护的资源会根据请求内容、HTTP 403状态代码（禁止）或自定义响应对请求做出响应。

本API指南是为需要了解WAF API操作、数据类型和错误详细信息的开发者编写的。有关WAF功能和配置以及使用WAF的指南，请参阅WAF开发者指南。

您可以使用WAF端点和配额中列出的端点进行调用。

• 对于区域应用程序，您可以使用列表中的任何端点。区域应用程序可以是应用程序负载均衡器（ALB）、Amazon API Gateway REST API、AppSync GraphQL API、Amazon Cognito用户池、App Runner服务或Amazon Web Services Verified Access实例。
• 对于Amazon CloudFront应用程序，您必须使用列出给美国东部（弗吉尼亚北部）的API端点：us-east-1。

或者，您可以使用Amazon Web Services SDK之一来访问针对您所使用的编程语言或平台定制的API。有关更多信息，请参阅Amazon Web Services SDKs。

我们目前提供两种WAF API版本：这个API和之前的版本，即经典WAF API。这个新API提供了与旧版本相同的功能，并具有以下主要改进

• 您可以使用一个API同时用于全球和区域应用程序。当您需要区分范围时，请指定一个范围参数并将其设置为CLOUDFRONT或REGIONAL。
• 您可以通过单个调用定义一个Web ACL或规则组，并通过单个调用进行更新。您将所有规则规范定义为JSON格式，并将它们传递给您的规则组或Web ACL调用。
• WAF对规则使用的限制更接近于每种类型的运行成本。规则组包括容量设置，因此您在使用规则组时知道其最大成本。

入门指南

许多服务和操作都有示例，请查看GitHub中的示例文件夹。

SDK为每个AWS服务提供一个crate。您必须在Rust项目中添加作为依赖项以执行异步代码。要将aws-sdk-wafv2添加到您的项目中，请将以下内容添加到您的Cargo.toml文件中

[dependencies]
aws-config = { version = "1.1.7", features = ["behavior-version-latest"] }
aws-sdk-wafv2 = "1.43.0"
tokio = { version = "1", features = ["full"] }

然后在代码中，可以使用以下方式创建一个客户端

use aws_sdk_wafv2 as wafv2;

#[::tokio::main]
async fn main() -> Result<(), wafv2::Error> {
    let config = aws_config::load_from_env().await;
    let client = aws_sdk_wafv2::Client::new(&config);

    // ... make some calls with the client

    Ok(())
}

有关可以执行的调用以及每个调用输入和输出的信息，请参阅客户端文档。

使用SDK

在SDK发布之前，我们将向开发者指南中添加有关使用SDK的信息。请随时通过提交问题并描述您试图做什么来为指南建议额外的部分。

获取帮助

• GitHub讨论区 - 用于想法、RFC和一般问题
• GitHub问题 - 用于错误报告和功能请求
• 生成文档（最新版本）
• 使用示例

许可证

本项目采用Apache-2.0许可证。