教程：创建 REST API 作为 Amazon S3 代理

登录AWS Management Console，然后通过以下网址打开 IAM 控制台：https://console.aws.amazon.com/iam/。

选择角色。

选择 Create role（创建角色）。

在选择受信任实体的类型下选择 AWS 服务，然后选择 API Gateway 并选择允许 API Gateway 将日志推送到 CloudWatch Logs。

选择下一步，然后再次选择下一步。

对于角色名称，输入 APIGatewayS3ProxyPolicy，然后选择创建角色。

在 Roles 列表中，选择您刚创建的角色。您可能需要滚动或使用搜索栏来查找角色。

对于所选角色，选择添加权限选项卡。

从下拉列表中选择附加策略。

在搜索栏中，输入 AmazonS3FullAccess 然后选择添加权限。

记下新创建的角色 ARN，稍后将使用它。

在创建 Amazon S3 桶的同一 AWS 区域，创建名为 MyS3 的 API。此 API 的根资源 (/) 表示 Amazon S3 服务。在此步骤中，您将创建另外两个资源：/{folder} 和 /{item}。

选择创建资源。

将代理资源保持为关闭状态。

对于资源路径，选择 /。

对于资源名称，输入 {folder}。

将 CORS（跨源资源共享）保持为未选中。

选择创建资源。

选择 /{folder} 资源，然后选择创建资源。

使用上述步骤创建 /{folder} 的子资源，名为 {item}。

最终的 API 应类似以下内容：

选择 / 资源，然后选择创建方法。

对于方法类型，选择 GET。

对于集成类型，选择 AWS 服务。

对于 AWS 区域，选择您创建 Amazon S3 桶的 AWS 区域。

对于 AWS 服务，选择 Amazon Simple Storage Service。

将 AWS 子域保留为空白。

对于 HTTP 方法，选择 GET。

对于操作类型，选择使用路径覆盖。

利用路径覆盖，API Gateway 可将客户端请求作为对应的 Amazon S3 REST API 路径样式请求转发到 Amazon S3，其中 Amazon S3 资源用 s3-host-name/bucket/key 模式的资源路径表示。API Gateway 设置 s3-host-name 并将客户端指定的 bucket 和 key 从客户端传递到 Amazon S3。

对于路径覆盖，输入 /。

对于执行角色，输入 APIGatewayS3ProxyPolicy 的角色 ARN。

选择方法请求设置。

您可以使用方法请求设置来控制谁可以调用 API 的此方法。

对于授权，从下拉菜单中选择 AWS_IAM。

选择创建方法。

在方法响应选项卡的响应 200 下，选择编辑。

选择添加标头，然后执行以下操作：

1. 对于标头名称，输入 Content-Type。

2. 选择添加标头。

重复上述步骤以创建 Timestamp 标头和 Content-Length 标头。

选择保存。

在方法响应选项卡的方法响应下，选择创建响应。

对于 HTTP 状态代码，输入 400。

您不为此响应设置任何标头。

选择保存。

重复以下步骤以创建 500 响应。

您不为此响应设置任何标头。

在集成响应选项卡上的默认 - 响应下，选择编辑。

对于 Content-Length 标头，输入 integration.response.header.Content-Length 作为映射值。

对于 Content-Type 标头，输入 integration.response.header.Content-Type 作为映射值。

对于 Timestamp 标头，输入 integration.response.header.Date 作为映射值。

选择保存。结果应类似以下内容：

在集成响应选项卡的集成响应下，选择创建响应。

对于 HTTP 状态正则表达式，输入 4\d{2}。这会将所有 4xx HTTP 响应状态代码映射到方法响应。

对于方法响应状态代码，选择 400。

选择创建。

重复以下步骤，为 500 方法响应创建集成响应。对于 HTTP 状态正则表达式，输入 5\d{2}。

选择测试选项卡。您可能需要选择右箭头按钮，以显示该选项卡。

选择测试。结果应类似下图内容：

选择 /{folder} 资源，然后选择创建方法。

对于方法类型，选择 GET。

对于集成类型，选择 AWS 服务。

对于 AWS 区域，选择您创建 Amazon S3 桶的 AWS 区域。

对于 AWS 服务，选择 Amazon Simple Storage Service。

将 AWS 子域保留为空白。

对于 HTTP 方法，选择 GET。

对于操作类型，选择使用路径覆盖。

对于路径覆盖，输入 {bucket}。

对于执行角色，输入 APIGatewayS3ProxyPolicy 的角色 ARN。

选择创建方法。

在集成请求选项卡的集成请求设置下，选择编辑。

选择 URL 路径参数，然后选择添加路径参数。

对于名称，请输入 bucket。

对于映射自，输入 method.request.path.folder。

选择保存。

选择测试选项卡。您可能需要选择右箭头按钮，以显示该选项卡。

在路径下，对于文件夹，输入桶名称。

选择测试。

测试结果将包含桶中对象的列表。

选择 /{item} 资源，然后选择创建方法。

对于方法类型，选择 GET。

对于集成类型，选择 AWS 服务。

对于 AWS 区域，选择您创建 Amazon S3 桶的 AWS 区域。

对于 AWS 服务，选择 Amazon Simple Storage Service。

将 AWS 子域保留为空白。

对于 HTTP 方法，选择 GET。

对于操作类型，选择使用路径覆盖。

对于路径覆盖，输入 {bucket}/{object}。

对于执行角色，输入 APIGatewayS3ProxyPolicy 的角色 ARN。

选择创建方法。

在集成请求选项卡的集成请求设置下，选择编辑。

选择 URL 路径参数。

选择添加路径参数。

对于名称，请输入 bucket。

对于映射自，输入 method.request.path.folder。

选择添加路径参数。

对于名称，请输入 object。

对于映射自，输入 method.request.path.item。

选择保存。

选择测试选项卡。您可能需要选择右箭头按钮，以显示该选项卡。

在路径下，对于文件夹，输入桶名称。

在路径下，对于项目，输入项目名称。

选择测试。

响应正文将包含该项目的内容。

该请求正确返回纯文本（“Hello world”）作为给定 Amazon S3 存储桶（amzn-s3-demo-bucket）中指定文件（test.txt）的内容。

将受影响文件的介质类型注册到 API 的 binaryMediaTypes。您可以在控制台中执行此操作：

1. 选择 API 的 API 设置。

2. 在二进制媒体类型下，选择管理媒体类型。

3. 选择添加二进制媒体类型，然后输入所需的媒体类型，例如 image/png。

4. 选择保存更改以保存设置。

将 Content-Type（用于上传）和/或 Accept（用于下载）标头添加到方法请求，以要求客户端指定所需的二进制介质类型并将其映射到集成请求。

在集成请求（用于上传）和集成响应（用于下载）中，将内容处理 设置为 Passthrough。确保未为受影响的内容类型定义任何映射模板。有关更多信息，请参阅集成传递行为和选择 VTL 映射模板。