本頁適用於 Apigee 和 Apigee Hybrid。
查看
Apigee Edge 說明文件。
本步驟的操作說明
請按照下列步驟建立及部署測試 API Proxy。最後,請向 API Proxy 傳送 HTTP 要求來測試 API Proxy。
建立及部署 API Proxy
Apigee 的佈建程序不會自動為您建立及部署 API Proxy。您必須手動建立及部署 Proxy。
Cloud 控制台中的 Apigee UI
如要建立及部署第一個 Proxy,請按照下列步驟操作:
- 在瀏覽器中開啟 Cloud 控制台中的 Apigee UI。
- 請務必在 UI 左上角的下拉式選單中選取貴機構名稱。機構名稱與 Google Cloud 專案名稱相同。
- 在左側導覽窗格中,依序按一下「Proxy development」>「API proxies」。
- 按一下「+ 建立」。
「Create a proxy」(建立 Proxy) 頁面隨即開啟。
- 在「Proxy template」方塊中,選取「Reverse proxy (most common)」。
- 在「步驟 1:Proxy 詳細資料」中,使用下列值設定 Proxy:
參數名稱 值 Proxy 名稱 hello-world
基本路徑 /hello-world
目標 (現有 API) mocktarget.apigee.net
- 點選「下一步」。
- 在「步驟 2:部署 (選用)」中:
- 部署環境:選用。使用核取方塊選取一或多個要部署 Proxy 的環境。如果您不想在此時部署 Proxy,請將「部署環境」欄位留空。您之後隨時可以部署 Proxy。
- 服務帳戶:選填。將服務帳戶附加至部署作業,讓 Proxy 能依服務帳戶的角色和權限指定,存取 Google Cloud服務。
- 按一下「建立」。
系統會建立新的 API Proxy,並在所選環境中部署。
- 系統會開啟新建立 Proxy 的「Proxy summary」頁面。 「狀態」下方顯示綠色勾號,表示已成功部署 Proxy。如果尚未部署 Proxy,請參閱「 部署 API Proxy」,並按照步驟手動部署 Proxy。
- 在左側導覽窗格中,依序選取「管理」>「環境」>「環境群組」。
- 複製環境群組的主機名稱。您將在後續步驟中使用這個主機名稱呼叫 API Proxy。
Apigee UI
如要建立及部署第一個 Proxy,請按照下列步驟操作:
- 登入 Apigee UI。
- 請務必在 UI 左上角的下拉式選單中選取貴機構名稱。機構名稱與 Google Cloud 專案名稱相同。
- 按一下主畫面中的「API Proxy」。
- 從「Select Environment」下拉式清單中選取環境。
- 按一下「建立新檔案」。
- 按一下「Reverse proxy (most common)」(反向 Proxy,最常見)。
- 在「Proxy details」頁面中,使用下列值設定 Proxy:
參數名稱 值 名稱 hello-world
基本路徑 /hello-world
目標 (現有 API) https://mocktarget.apigee.net
- 點選「下一步」。
- 在「常見政策」頁面的「安全性:授權」下方,選取「傳送 (不需授權)」。
- 點選「下一步」。
- 在「摘要」頁面的「選用部署」下方,選取要部署 Proxy 的環境。
- 按一下「建立並部署」。
系統會建立新的 API Proxy,並在所選環境中部署。
- 按一下「前往 Proxy 清單」。「狀態」下方顯示綠色勾號,表示已成功部署 Proxy。如果尚未部署 Proxy,請參閱「 部署 API Proxy」,並按照步驟手動部署 Proxy。
- 在左側導覽面板中,依序選取「管理」>「環境」>「群組」。
- 按一下「在 Google Cloud 控制台中查看」。
- 複製環境群組的主機名稱。您將在後續步驟中使用這個主機名稱呼叫 API Proxy。
- 關閉 Google Cloud 控制台。
呼叫具有內部存取權的 Proxy
如果您在 步驟 4:自訂存取路由中允許內部存取權,請按照 呼叫僅限內部存取權的 API Proxy中的操作說明操作。
呼叫可外部存取的 Proxy
如果您在 步驟 4:自訂存取轉送中允許外部存取權,請按照下列步驟操作:
- 為主機設定 DNS 項目。完成此任務的方法有兩種:
- 在註冊商處建立 A 記錄,將環境群組主機名稱指向「Configure DNS」下方精靈頁面顯示的 IP。舉例來說,如果主機名稱是
sales.example.com
,IP 為 10.23.0.2,請將sales.example.com
的記錄指向10.23.0.2
位址。 - 使用 Google Cloud DNS 將網址對應至 IP 位址。
- 在註冊商處建立 A 記錄,將環境群組主機名稱指向「Configure DNS」下方精靈頁面顯示的 IP。舉例來說,如果主機名稱是
- 在終端機視窗中傳送下列要求,即可測試 API 代理程式:
curl -v -H "Host:YOUR_ENV_GROUP_HOSTNAME" \ https://YOUR_INSTANCE_IP_OR_DNS/hello-world
其中:
Host
標頭 (YOUR_ENV_GROUP_HOSTNAME) 的值是「環境」>「環境群組」頁面中的主機名稱。
成功的要求會傳回字串:
Hello, Guest!
。如果要求未成功,請參閱疑難排解。
後續步驟
- 瀏覽 Apigee 教學課程,包括: