使用 REST API 客户端调用 API

使用 Postman 调用我们的 Amazon S3 代理 API

1. 部署或重新部署 API。记下位于阶段编辑器顶部的调用 URL 旁边显示的 API 的基本 URL。

2. 启动 Postman。

3. 选择授权，然后选择 Amazon Signature。分别在 AccessKey 和 SecretKey 输入字段中输入您的 IAM 用户的访问密钥 ID 和秘密访问密钥。在 Amazon 区域文本框中输入您的 API 部署到的 Amazon 区域。在服务名称输入字段中键入 execute-api。

   您可以在 IAM 管理控制台的 IAM 用户账户的安全凭证选项卡中创建一对密钥。

4. 要在 apig-demo-5 区域内将名为 {region} 的存储桶添加到您的 Amazon S3 账户，请执行以下操作：

   注意

   请确保存储桶名称具有全局唯一性。

   1. 从下拉方法列表中选择 PUT 并键入方法 URL (https://api-id.execute-api.aws-region.amazonaws.com/stage/folder-name)

   2. 将 Content-Type 标头值设置为 application/xml。在设置内容类型之前，您可能需要先删除任何现有标头。

   3. 选择正文菜单项并键入以下 XML 片段作为请求正文：

      <CreateBucketConfiguration> 
        <LocationConstraint>{region}</LocationConstraint> 
      </CreateBucketConfiguration>

   4. 选择发送以提交请求。如果成功，您应该会收到一个负载为空的 200 OK 响应。

5. 要将文本文件添加到存储桶，请按照上述说明执行操作。如果您在 URL 中为 apig-demo-5 指定存储桶名称 {folder}，为 Readme.txt 指定文件名 {item}，并提供文本字符串 Hello, World! 作为文件内容（从而使其成为请求负载），则此请求将成为

   PUT /S3/apig-demo-5/Readme.txt HTTP/1.1
   Host: 9gn28ca086.execute-api.{region}.amazonaws.com
   Content-Type: application/xml
   X-Amz-Date: 20161015T062647Z
   Authorization: AWS4-HMAC-SHA256 Credential=access-key-id/20161015/{region}/execute-api/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-date, Signature=ccadb877bdb0d395ca38cc47e18a0d76bb5eaf17007d11e40bf6fb63d28c705b
   Cache-Control: no-cache
   Postman-Token: 6135d315-9cc4-8af8-1757-90871d00847e
   
   Hello, World!

   如果一切正常，您应该会收到一个负载为空的 200 OK 响应。

6. 要获取我们刚刚添加到 Readme.txt 存储桶的 apig-demo-5 文件的内容，请发出类似于以下的 GET 请求：

   GET /S3/apig-demo-5/Readme.txt HTTP/1.1
   Host: 9gn28ca086.execute-api.{region}.amazonaws.com
   Content-Type: application/xml
   X-Amz-Date: 20161015T063759Z
   Authorization: AWS4-HMAC-SHA256 Credential=access-key-id/20161015/{region}/execute-api/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature=ba09b72b585acf0e578e6ad02555c00e24b420b59025bc7bb8d3f7aed1471339
   Cache-Control: no-cache
   Postman-Token: d60fcb59-d335-52f7-0025-5bd96928098a

   如果成功，您应该会收到负载为 200 OK 文本字符串的 Hello, World! 响应。

7. 要列出 apig-demo-5 存储桶中的项目，请提交以下请求：

   GET /S3/apig-demo-5 HTTP/1.1
   Host: 9gn28ca086.execute-api.{region}.amazonaws.com
   Content-Type: application/xml
   X-Amz-Date: 20161015T064324Z
   Authorization: AWS4-HMAC-SHA256 Credential=access-key-id/20161015/{region}/execute-api/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature=4ac9bd4574a14e01568134fd16814534d9951649d3a22b3b0db9f1f5cd4dd0ac
   Cache-Control: no-cache
   Postman-Token: 9c43020a-966f-61e1-81af-4c49ad8d1392
   

   如果成功，您应该会收到 200 OK 响应且其 XML 负载在指定存储桶中显示单个项目，除非您在提交请求前将更多文件添加到存储桶中。

   <?xml version="1.0" encoding="UTF-8"?>
   <ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
       <Name>apig-demo-5</Name>
       <Prefix></Prefix>
       <Marker></Marker>
       <MaxKeys>1000</MaxKeys>
       <IsTruncated>false</IsTruncated>
       <Contents>
           <Key>Readme.txt</Key>
           <LastModified>2016-10-15T06:26:48.000Z</LastModified>
           <ETag>"65a8e27d8879283831b664bd8b7f0ad4"</ETag>
           <Size>13</Size>
           <Owner>
               <ID>06e4b09e9d...603addd12ee</ID>
               <DisplayName>user-name</DisplayName>
           </Owner>
           <StorageClass>STANDARD</StorageClass>
       </Contents>
   </ListBucketResult>