步驟 1：建立 API Proxy

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

查看 Apigee Edge 說明文件。

在這個步驟中，您會建立簡單的 API Proxy，呼叫模擬目標服務。

Cloud 控制台中的 Apigee

  1. 在 Google Cloud 控制台中，前往「Proxy development」(Proxy 開發) >「API proxies」(API Proxy) 頁面。

    前往 API Proxy

  2. 請務必從「Google Cloud」窗格的專案挑選器中選取機構名稱。機構名稱與 Google Cloud 專案名稱相同。
  3. 點選「+ 建立」。
  4. 在「建立 Proxy」窗格的「Proxy 範本」下方，選取「反向 Proxy (最常見)」。反向 Proxy 只會將傳入流量轉送至後端服務。
  5. 在「Proxy 詳細資料」下方，輸入下列資訊：
    • Proxy name (Proxy 名稱)：輸入 myproxy。本節其餘步驟會假設這是您 Proxy 的名稱。
    • 基本路徑：系統會自動將此值設為您在 Proxy name 中輸入的值。基本路徑是向 API 發出要求時所用網址的一部分。Apigee 會使用這個網址比對連入要求，並將要求轉送至適當的 API Proxy。
    • 說明 (選用)：輸入新 API Proxy 的說明，例如「Testing Apigee with a simple proxy」。
    • 目標 (現有 API)：輸入 https://mocktarget.apigee.net。 這會定義 Apigee 在對 API Proxy 發出要求時叫用的目標網址。mocktarget 服務託管於 Apigee，並會傳回簡單的資料。不需要 API 金鑰或存取權杖。
    • 空間 (選用)：如果貴機構已啟用 Apigee Spaces，您可以從可用選項清單中選取空間，然後將 API Proxy 與該空間建立關聯。詳情請參閱「Apigee Spaces 總覽」。
    • 點選「下一步」。
  6. 在「Deploy (optional)」(部署 (選用)) 下，請勿變更「Deployment environments」(部署環境) 欄位。在本範例中，您只會建立 Proxy，不會在這個階段部署。您也可以忽略「服務帳戶」欄位。請將這個欄位留空。
  7. 按一下「建立」。

    Apigee 會建立新的 Proxy，並在「Proxy summary」窗格中顯示 Proxy 詳細資料摘要。

    myproxy 摘要窗格。

    「Deployments」(部署作業) 區段是空白的，因為 Proxy 尚未部署。

  8. 在「端點摘要」下方的「修訂版本」部分，按一下「查看」。

    端點檢視窗格會顯示：

    • Proxy 端點：您為 Proxy 設定的 Basepath，在本例中為 /myproxy。
    • 目標端點：您為目標設定的 basepath，在本例中為 https://mocktarget.apigee.net。
  9. 按一下「關閉」，返回 Proxy 摘要頁面。

傳統版 Apigee

如要在傳統 Apigee 使用者介面中建立簡單的 API Proxy，請按照下列步驟操作：

  1. 在瀏覽器中開啟 Apigee 使用者介面。
  2. 在 UI 的主要檢視畫面中，依序點選「Develop」>「API Proxies」。

    依序選取「開發」>「API Proxy」。

  3. 在「選取環境」下拉式清單中，選取要建立新 API Proxy 的環境。

    Apigee 使用者介面會顯示該環境的 API Proxy 清單。如果您尚未建立任何 Proxy，清單會是空白的。

  4. 按一下「建立新項目」。
    「建立 Proxy」按鈕

    「建立 Proxy」精靈會啟動：

    選取「反向 Proxy」的 API Proxy 窗格

  5. 選取「反向 Proxy」(最常見)。

    系統會顯示「Proxy details」(Proxy 詳細資料) 檢視畫面。

  6. 使用下列設定設定 Proxy：
    • Proxy Name：輸入 myproxy。本節的其餘步驟會假設這是您 Proxy 的 ID。
    • Proxy Base Path：系統會自動設為 /myproxy。Proxy Base Path 是用來向 API 發出要求的網址的一部分。Apigee 會使用這個網址比對連入要求，並將要求轉送至適當的 API Proxy。
    • 說明 (選填)：輸入新 API Proxy 的說明，例如「透過簡單的 Proxy 測試 Apigee」。
    • 目標 (現有 API)：輸入 https://mocktarget.apigee.net。 這會定義 Apigee 在對 API Proxy 發出要求時叫用的目標網址。mocktarget 服務託管於 Apigee，並會傳回簡單的資料。不需要 API 金鑰或存取權杖。

    API Proxy 的詳細資料應如下所示：

    顯示名稱、基本路徑、說明和目標的 Proxy 詳細資料

  7. 點選「下一步」。
  8. 在「Common policies」(通用政策) 畫面中，選取「Pass through (no authorization)」(直接傳遞 (不授權)) 做為安全選項。
  9. 點選「下一步」。
  10. 在「摘要」畫面中，按一下「建立」。(將「Optional Deployment」保留為未選取狀態)。

    Apigee 會產生 Proxy (有時也稱為「Proxy 套件」)：

    確認已建立 Proxy

  11. 按一下「前往 Proxy 清單」。

    Apigee 會顯示「Proxies」(Proxy) 檢視畫面，其中列出 API Proxy。新的 Proxy 狀態指標為灰色，表示尚未部署。

接下來，請部署 API Proxy。用戶端必須先部署 Proxy，才能使用 Proxy。

1 (NEXT) Step 2: Deploy the API proxy 3 4 5