

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 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. 在以下網址登入 API Gateway 主控台：[https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway)。

1. 選擇 REST API。

1. 在 **Resources (資源)** 窗格中，選擇您要測試的方法。

1. 選擇**測試**標籤。您可能需要選擇向右箭頭按鈕才能顯示此索引標籤。  
![\[使用測試標籤來測試您的 API。其位於方法回應標籤旁。\]](http://docs.aws.amazon.com/zh_tw/apigateway/latest/developerguide/images/api-gateway-test-new-console.png)

    在顯示的任何方塊 (例如**查詢字串**、**標頭**和**請求內文**) 中輸入值。主控台預設應用程式/json 表單中的方法要求包含這些值。

   如要了解可能需要指定的其他選項，請聯絡 API 擁有者。

1. 選擇 **Test (測試)**。下列資訊會隨即顯示：
   + **Request (請求)** 是針對方法所呼叫的資源路徑。
   + **Status (狀態)** 是回應的 HTTP 狀態碼。
   + **延遲 (ms)** 是從呼叫者收到請求，到傳回回應之間的時間。
   + **回應內文**是 HTTP 回應內文。
   + **回應標頭**是 HTTP 回應標頭。
**提示**  
根據映射，HTTP 狀態碼、回應內文與回應標頭可能會與 Lambda 函數、HTTP 代理或 AWS 服務代理所傳送的內容不同。
   + **Logs (日誌)** 是模擬的 Amazon CloudWatch Logs 項目，如果在 API Gateway 主控台之外呼叫此方法，將會寫入該項目。
**注意**  
雖然 CloudWatch Logs 項目是模擬的，但方法呼叫的結果是真實的。

 除了使用 API Gateway 主控台之外，您還可以使用適用於 API Gateway 的 AWS CLI 或 AWS 軟體開發套件來測試方法的叫用。若要使用 AWS CLI 來執行這項操作，請參閱 [test-invoke-method](https://docs.aws.amazon.com/cli/latest/reference/apigateway/test-invoke-method.html)。