步驟 4:變更目標端點

本頁適用於 ApigeeApigee Hybrid

查看 Apigee Edge 說明文件。

Apigee API Proxy 有兩個端點:Proxy 端點和目標端點。Proxy 端點是用戶端介面。它會接收來自用戶端的要求,並將回應傳回給用戶端。目標端點是 API 產生者介面。它會從 Apigee 向 API 供應者 (例如後端服務或 API) 傳送訊息。如要進一步瞭解端點,請參閱「什麼是 API Proxy?」。

在這個步驟中,您將變更 API 代理程式的目標端點,改為 https://mocktarget.apigee.net/xml,這是會傳回測試 XML 資料的資源。變更完成後,您將重新部署並測試修訂版 API 代理程式。

Cloud 控制台中的 Apigee

  1. 在瀏覽器中開啟 Cloud 控制台中的 Apigee UI
  2. 請確認您在頁面頂端的下拉式選單中,選取建立 API Proxy 的 Google Cloud 專案。
  3. 依序選取「Proxy development」>「API Proxies」
  4. 在 Proxy 表格中,選取您在步驟 1:建立 API Proxy 中建立的 Proxy myproxy
  5. 按一下「開發」分頁標籤。

探索「Develop」檢視畫面

在「Develop」檢視畫面的左側窗格中,您可以:

  • 在「Search proxy」欄位中搜尋代理程式中的文字。
  • 新增政策。
  • 新增 Proxy 和目標端點。
  • 新增其他資源。

如果不想查看左側窗格,請按一下關閉按鈕 關閉搜尋窗格按鈕。 將其收合。

「Develop」檢視畫面的右側窗格會顯示 Proxy 的視覺和文字編輯器:

  • 視覺化編輯器會以圖形方式顯示要求和回應流程。
  • 您可以使用文字編輯器編輯 Proxy 或目標的 XML。

可選取分隔線的圖像和文字編輯器。

注意事項:

  • 您可以向上或向下拖曳兩個編輯器之間的分隔線,擴大任一編輯器的顯示區域。
  • 如要展開視覺編輯器的顯示區域,請按一下文字編輯器右側的切換按鈕,這麼做會關閉文字編輯器窗格。再次點選切換鈕按鈕,重新開啟文字編輯器窗格。

變更目標端點

如要變更 Proxy 的目標端點,請按照下列步驟操作:

  1. 在「Proxy revision」窗格中,依序選取「Target Endpoints」>「default」

    Proxy Explorer 中選取的目標端點。

    這會在視覺編輯器中顯示目標端點的圖表:

    Proxy Explorer 中選取的目標端點。

    在視覺編輯器下方,文字編輯器會顯示目標端點的 XML 程式碼:

    文字編輯器中顯示的目標端點 XML。

  2. 在文字編輯器中,將 <URL> 變更為 https://mocktarget.apigee.net/xml。(在現有網址後方加上「/xml」)。

    新的網址如下所示:

    ...
    <HTTPTargetConnection>
      <Properties/>
      <URL>https://mocktarget.apigee.net/xml</URL>
    </HTTPTargetConnection>
    ...
  3. 按一下 Proxy 編輯器右上方的「Save」旁邊的箭頭,然後選取「Save as new revision」
  4. 如要部署變更,請按一下「Deploy」(部署)
  5. 在「Deploy」對話方塊中,選取要部署的修訂版本和環境,然後按一下「Deploy」

傳統版 Apigee UI

如要變更 Proxy 的目標端點,請按照下列步驟操作:

  1. 登入 Apigee UI
  2. 依序選取「Develop」>「API Proxy」
  3. 從清單中選取 Proxy,即可顯示 API Proxy 詳細資料。如果清單中沒有列出您的 Proxy,請確認您選取的機構正確無誤,如「切換機構」一文所述。
  4. 按一下「開發」分頁標籤:

    「Develop」分頁。

    系統會將您導向 API Proxy 編輯器。您可以透過 Proxy 編輯器查看 API Proxy 的結構,並設定其流程。(流程只是 API Proxy 要求透過 Apigee 平台的逐步路徑。其他教學課程將介紹「流程」的概念。

  5. 在「Navigator」窗格中,依序選取「Target Endpoints」>「default」>「PreFlow」

    Apigee 會在「Code」窗格中顯示端點設定:

    <TargetEndpoint name="default">
      <Description/>
      <FaultRules/>
      <PreFlow name="PreFlow">
        <Request/>
        <Response/>
      </PreFlow>
      <PostFlow name="PostFlow">
        <Request/>
        <Response/>
      </PostFlow>
      <Flows/>
      <HTTPTargetConnection>
        <Properties/>
        <URL>https://mocktarget.apigee.net</URL>
      </HTTPTargetConnection>
    </TargetEndpoint>

    目標端點是由 <HTTPTargetConnection> 元素定義。

  6. 將網址變更為 "https://mocktarget.apigee.net/xml"。(將「/xml」附加至現有網址)。

    新的網址會在回應主體中傳回一小段 XML。

    端點設定現在應如下所示:

    ...
    <HTTPTargetConnection>
      <Properties/>
      <URL>https://mocktarget.apigee.net/xml</URL>
    </HTTPTargetConnection>
    ...
  7. 如要儲存對等網路設定的變更,請按一下「儲存」按鈕。

    Apigee 會將變更儲存至新的 Proxy 修訂版本。

  8. 如要部署新修訂版本,請選取「Deploy to: test」,然後按一下「Deploy 2」
  9. 在確認對話方塊中,按一下「部署」

    如果發生錯誤,Apigee 會儲存您的變更,但不會部署 Proxy。發生錯誤時:

    1. 修正 Proxy 設定。Apigee 可能會以彈出式視窗提供語法指引。
    2. 如果 Apigee 未自動部署變更,請手動將變更部署至 test 環境,方法是點選「Deployment」>「test」

    您可以查看「部署」下拉式選單旁的部署修訂版本狀態,確認代理伺服器修訂版本是否已成功部署。例如:

測試 Proxy

如要測試 API Proxy 修訂版本,請按照「呼叫 API Proxy」一節的說明呼叫 Proxy。

這次,mocktarget 端點會在回應主體中傳回 XML:

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <city>San Jose</city>
  <firstName>John</firstName>
  <lastName>Doe</lastName>
  <state>CA</state>
</root>

由於 API 代理程式會傳回 XML 資料,因此您會在下一個步驟中新增將 XML 轉換為 JSON 的政策。

1 2 4 (NEXT) Step 5: Add a policy