教程：使用Amazon集成构建 API Gateway REST API

1. 完成 开始使用 API Gateway 的先决条件 中的步骤。

2. 创建名为 MyDemoAPI 的新 API。有关更多信息，请参阅 教程：使用 HTTP 非代理集成构建 REST API。

3. 至少将 API 部署到名为 test 的阶段一次。有关更多信息，请参阅中的部署 API选择 Amazon Lambda 集成教程。

4. 完成中的剩余步骤选择 Amazon Lambda 集成教程

5. 在 Amazon Simple Notification Service (Amazon SNS) 中至少创建一个主题。您将使用已部署的 API 获取 Amazon SNS 中与您的Amazon账户相关联的主题列表。要了解如何在 Amazon SNS 中创建主题，请参阅创建主题。(您不需要复制步骤 5 中提到的主题 ARN。)

创建 Amazon 服务代理执行角色

1. 登录 Amazon Web Services Management Console，然后使用以下网址打开 IAM 控制台：https://console.aws.amazon.com/iam/。

2. 选择角色。

3. 选择 Create role(创建角色)。

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

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

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

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

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

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

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

    注意

    为简单起见，本教程使用托管策略。作为最佳实践，您应创建自己的 IAM 策略以授予所需的最低权限。

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

创建资源

1. 通过以下网址登录到 Amazon API Gateway 控制台：https://console.aws.amazon.com/apigateway。

2. 选择 API。

3. 选择根资源 /（由一个正斜杠 (/) 表示），然后选择创建资源。

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

5. 将资源路径保持为 /。

6. 对于资源名称，输入 mydemoawsproxy。

7. 将 CORS（跨源资源共享）保持为关闭状态。

8. 选择创建资源。

创建 GET 方法

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

2. 对于方法类型，选择 GET。

3. 对于集成类型，选择 Amazon Web Service。

4. 对于 Amazon Web Services 区域，选择您创建 Amazon SNS 主题的 Amazon Web Services 区域。

5. 对于 Amazon Web Service，选择 Amazon SNS。

6. 将 Amazon 子域保留为空白。

7. 对于 HTTP 方法，选择 GET。

8. 对于操作类型，选择使用操作名称。

9. 对于操作名称，输入 ListTopics。

10. 对于执行角色，输入 APIGatewaySNSProxyPolicy 的角色 ARN。

11. 选择创建方法。

测试 GET 方法

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

2. 选择测试。

   结果显示与以下内容类似的响应：

   {
     "ListTopicsResponse": {
       "ListTopicsResult": {
         "NextToken": null,
         "Topics": [
           {
             "TopicArn": "arn:aws:sns:us-east-1:80398EXAMPLE:MySNSTopic-1"
           },
           {
             "TopicArn": "arn:aws:sns:us-east-1:80398EXAMPLE:MySNSTopic-2"
           },
           ...
           {
             "TopicArn": "arn:aws:sns:us-east-1:80398EXAMPLE:MySNSTopic-N"
           }
         ]
       },
       "ResponseMetadata": {
         "RequestId": "abc1de23-45fa-6789-b0c1-d2e345fa6b78"
       }
     }
   }

部署 API

1. 选择部署 API。

2. 对于阶段，选择新建阶段。

3. 对于阶段名称，输入 test。

4. （可选）对于描述，输入描述。

5. 选择 Deploy (部署)。

1. 在主导航窗格中，选择阶段。

2. 在阶段详细信息下，选择复制图标以复制您 API 的调用 URL。

   它应如下所示：

   https://my-api-id.execute-api.region-id.amazonaws.com/test

3. 将 URL 输入到新浏览器标签页的地址框中。

4. 附加 /mydemoawsproxy，使 URL 如下所示：

   https://my-api-id.execute-api.region-id.amazonaws.com/test/mydemoawsproxy

   浏览到该 URL。此时应显示以下信息：

   {"ListTopicsResponse":{"ListTopicsResult":{"NextToken": null,"Topics":[{"TopicArn": "arn:aws:sns:us-east-1:80398EXAMPLE:MySNSTopic-1"},{"TopicArn": "arn:aws:sns:us-east-1:80398EXAMPLE:MySNSTopic-2"},...{"TopicArn": "arn:aws:sns:us-east-1:80398EXAMPLE:MySNSTopic-N}]},"ResponseMetadata":{"RequestId":"abc1de23-45fa-6789-b0c1-d2e345fa6b78}}}

删除相关联的 IAM 资源

1. 通过以下网址打开 IAM 控制台：https://console.aws.amazon.com/iam/。

2. 在详细信息区域中，选择角色。

3. 选择 APIGatewayAWSProxyExecRole，然后依次选择角色操作、删除角色。在系统提示时，选择 Yes, Delete。

4. 在详细信息区域中，选择策略。

5. 选择 APIGatewayAWSProxyExecPolicy，然后选择策略操作和删除。系统提示时，选择删除。