

# 使用 API Gateway 控制台测试 REST API 方法
<a name="how-to-test-method"></a>

使用 API Gateway 控制台测试 REST API 方法。

**Topics**
+ [先决条件](#how-to-test-method-prerequisites)
+ [使用 API Gateway 控制台测试方法](#how-to-test-method-console)

## 先决条件
<a name="how-to-test-method-prerequisites"></a>
+ 您必须指定要测试的方法的设置。按照[API Gateway 中用于 REST API 的方法](how-to-method-settings.md)中的说明进行操作。

## 使用 API Gateway 控制台测试方法
<a name="how-to-test-method-console"></a>

**重要**  
使用 API Gateway 控制台测试方法可能会导致对资源进行无法撤销的更改。使用 API Gateway 控制台测试方法与在 API Gateway 控制台之外调用方法相同。例如，如果您使用 API Gateway 控制台调用用于删除 API 资源的方法，并且方法调用成功，那么将删除 API 资源。

**测试方法**

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

1. 选择一个 REST API。

1. 在**资源**窗格中，选择要测试的方法。

1. 选择**测试**选项卡。您可能需要选择右箭头按钮，以显示该选项卡。  
![\[使用“测试”选项卡来测试您的 API。它位于”方法响应”选项卡旁边。\]](http://docs.aws.amazon.com/zh_cn/apigateway/latest/developerguide/images/api-gateway-test-new-console.png)

    在任何显示的框中输入值（例如**查询字符串**、**标头**和**请求正文**。控制台会以默认 application/json 形式将这些值包括在方法请求中。

   对于您可能需要指定的其它选项，请联系 API 所有者。

1. 选择**测试**。此时将显示以下信息：
   + **请求**是为方法调用的资源路径。
   + **状态**是响应的 HTTP 状态代码。
   + **延迟（毫秒）**是收到调用方请求和返回响应之间的时间。
   + **响应正文**是 HTTP 响应正文。
   + **响应标头**是 HTTP 响应标头。
**提示**  
根据映射的不同，HTTP 状态代码、响应正文和响应标头可能不同于从 Lambda 函数、HTTP 代理或 AWS 服务代理发送的内容。
   + **日志** 是模拟的 Amazon CloudWatch Logs 条目，如果在 API Gateway 控制台之外调用此方法，则会写入这些条目。
**注意**  
尽管 CloudWatch Logs 条目是模拟的，但方法调用的结果是真实的。

 除了使用 API Gateway 控制台之外，您还可以使用 AWS CLI 或适用于 API Gateway 的 AWS 开发工具包来测试调用方法。要使用 AWS CLI 执行此操作，请参阅 [test-invoke-method](https://docs.aws.amazon.com/cli/latest/reference/apigateway/test-invoke-method.html)。