步驟 3：呼叫 API Proxy

本頁內容適用於 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 說明文件。

在這個步驟中，您將測試剛建立及部署的 API Proxy。

Cloud 控制台中的 Apigee

  1. 在 Google Cloud 控制台中，依序前往「Apigee」>「管理」>「環境」頁面。

    前往「環境」

  2. 請務必從頁面頂端的下拉式選單中，選取您建立 API 代理的 Google Cloud 專案。
  3. 選取「環境群組」分頁標籤。
  4. 在表格中，找出包含部署 myproxy 環境的環境群組資料列。主機名稱會顯示在該列的「主機名稱」欄中。例如：mydomain.com。
  5. 呼叫 API Proxy。呼叫 Proxy 的方式取決於 Apigee 執行個體是否已設定外部或內部網路存取權。如果您不確定 Apigee 執行個體的設定方式，請與 Apigee 管理員聯絡。
    • 外部存取權：如果 Apigee 執行個體已設定外部存取權，請按照下列方式呼叫 Proxy： 
      curl https://YOUR_ENV_GROUP_HOSTNAME/myproxy

      其中 YOUR_ENV_GROUP_HOSTNAME 是您在上一個步驟中取得的主機名稱。

      例如：

      curl https://mydomain.com/myproxy

      以下是另一個範例，其中主機使用萬用字元 DNS 服務 nip.io：

      curl https://198.51.100.251.nip.io/myproxy
    • 內部存取：如果 Apigee 執行個體已設定為內部網路存取，您需要採取額外步驟，才能存取內部負載平衡器及其 IP 位址。詳情請參閱「呼叫僅限內部存取的 Proxy」。
  6. 如果呼叫 Proxy 成功，會傳回下列輸出內容：

    Hello, Guest!

傳統版 Apigee UI

  1. 在瀏覽器中開啟 Apigee 使用者介面。
  2. 請務必從頁面頂端的下拉式選單中，選取您建立 API 代理的 Google Cloud 專案。
  3. 在 Cloud 控制台使用者介面中，依序選取「Admin」>「Environments」>「Groups」。
  4. 按一下「在 Google Cloud 控制台中查看」。
  5. 選取「環境群組」分頁標籤。
  6. 在表格中，找出包含部署 myproxy 環境的環境群組資料列。主機名稱會顯示在該列的「主機名稱」欄中。例如：mydomain.com。
  7. 呼叫 API Proxy。呼叫 Proxy 的方式取決於 Apigee 執行個體是否已設定外部或內部網路存取權。如果您不確定 Apigee 執行個體的設定方式，請與 Apigee 管理員聯絡。
    • 外部存取權：如果 Apigee 執行個體已設定外部存取權，請按照下列方式呼叫 Proxy： 
      curl https://YOUR_ENV_GROUP_HOSTNAME/myproxy

      其中 YOUR_ENV_GROUP_HOSTNAME 是您在上一個步驟中取得的主機名稱。

      例如：

      curl https://mydomain.com/myproxy

      以下是另一個範例，其中主機使用萬用字元 DNS 服務 nip.io：

      curl https://198.51.100.251.nip.io/myproxy
    • 內部存取：如果 Apigee 執行個體已設定為內部網路存取，您需要採取一些額外步驟，才能存取內部負載平衡器及其 IP 位址。詳情請參閱「呼叫僅限內部存取的 Proxy」。
  8. 如果呼叫 Proxy 成功，會傳回下列輸出內容：

    Hello, Guest!

如果發生錯誤，請檢查下列事項：

  • 如果看到逾時錯誤 (不尋常)，請嘗試 取消部署並重新部署新的 API 代理。
  • 如果無法解析主機 (例如收到 404 錯誤)，請再次確認您使用的是正確的主機名稱和 Proxy 名稱。
  • 請確認環境群組主機名稱已透過 Cloud Load Balancer 設定。請參閱 判斷是否已為主機名稱設定 Cloud Load Balancer。
  • 如果看到傳輸層安全標準 (TLS)/安全資料傳輸層 (SSL) 錯誤 (例如 SSL 交握錯誤)，請與 DNS 供應商聯絡，確認主機名稱的 DNS A 記錄設定正確無誤。確認記錄包含在 Apigee 佈建期間建立的負載平衡器 IP。如果不確定 IP 位址為何，請參閱「 判斷 Cloud Load Balancer 是否已設定主機名稱」。
  • 如果看到 TLS/SSL 憑證錯誤，表示與負載平衡器相關聯的 SSL 憑證可能沒有正確的主機名稱，因此遭到拒絕。憑證是在佈建程序中建立。 「 判斷 Cloud Load Balancer 是否已設定主機名稱」一文中的疑難排解步驟，說明如何找出並檢查憑證。
  • 如果無法解決問題，請聯絡 Apigee 佈建人員尋求進一步協助。

在下一個步驟中，您將變更 API Proxy 的目標端點。

1 2 3 (NEXT) Step 4: Change the target endpoint 5