本頁適用於 Apigee 和 Apigee Hybrid。
查看
Apigee Edge 說明文件。
Apigee API Proxy 有兩個端點:Proxy 端點和目標端點。Proxy 端點是用戶端介面。它會接收來自用戶端的要求,並將回應傳回給用戶端。目標端點是 API 產生者介面。它會從 Apigee 向 API 供應者 (例如後端服務或 API) 傳送訊息。如要進一步瞭解端點,請參閱「什麼是 API Proxy?」。
在這個步驟中,您將變更 API 代理程式的目標端點,改為 https://mocktarget.apigee.net/xml
,這是會傳回測試 XML 資料的資源。變更完成後,您將重新部署並測試修訂版 API 代理程式。
Cloud 控制台中的 Apigee
- 在瀏覽器中開啟 Cloud 控制台中的 Apigee UI。
- 請確認您在頁面頂端的下拉式選單中,選取建立 API Proxy 的 Google Cloud 專案。
- 依序選取「Proxy development」>「API Proxies」
- 在 Proxy 表格中,選取您在步驟 1:建立 API Proxy 中建立的 Proxy myproxy。
- 按一下「開發」分頁標籤。
探索「Develop」檢視畫面
在「Develop」檢視畫面的左側窗格中,您可以:
- 在「Search proxy」欄位中搜尋代理程式中的文字。
- 新增政策。
- 新增 Proxy 和目標端點。
- 新增其他資源。
如果不想查看左側窗格,請按一下關閉按鈕 將其收合。
「Develop」檢視畫面的右側窗格會顯示 Proxy 的視覺和文字編輯器:
- 視覺化編輯器會以圖形方式顯示要求和回應流程。
- 您可以使用文字編輯器編輯 Proxy 或目標的 XML。
注意事項:
- 您可以向上或向下拖曳兩個編輯器之間的分隔線,擴大任一編輯器的顯示區域。
- 如要展開視覺編輯器的顯示區域,請按一下文字編輯器右側的切換按鈕,這麼做會關閉文字編輯器窗格。再次點選切換鈕按鈕,重新開啟文字編輯器窗格。
變更目標端點
如要變更 Proxy 的目標端點,請按照下列步驟操作:
- 在「Proxy revision」窗格中,依序選取「Target Endpoints」>「default」。
這會在視覺編輯器中顯示目標端點的圖表:
在視覺編輯器下方,文字編輯器會顯示目標端點的 XML 程式碼:
在文字編輯器中,將
<URL>
變更為https://mocktarget.apigee.net/xml
。(在現有網址後方加上「/xml」)。新的網址如下所示:
... <HTTPTargetConnection> <Properties/> <URL>https://mocktarget.apigee.net/xml</URL> </HTTPTargetConnection> ...
- 按一下 Proxy 編輯器右上方的「Save」旁邊的箭頭,然後選取「Save as new revision」。
- 如要部署變更,請按一下「Deploy」(部署)。
- 在「Deploy」對話方塊中,選取要部署的修訂版本和環境,然後按一下「Deploy」。
傳統版 Apigee UI
如要變更 Proxy 的目標端點,請按照下列步驟操作:
- 登入 Apigee UI。
- 依序選取「Develop」>「API Proxy」。
- 從清單中選取 Proxy,即可顯示 API Proxy 詳細資料。如果清單中沒有列出您的 Proxy,請確認您選取的機構正確無誤,如「切換機構」一文所述。
按一下「開發」分頁標籤:
系統會將您導向 API Proxy 編輯器。您可以透過 Proxy 編輯器查看 API Proxy 的結構,並設定其流程。(流程只是 API Proxy 要求透過 Apigee 平台的逐步路徑。其他教學課程將介紹「流程」的概念。
- 在「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>
元素定義。 將網址變更為
"https://mocktarget.apigee.net/xml"
。(將「/xml」附加至現有網址)。新的網址會在回應主體中傳回一小段 XML。
端點設定現在應如下所示:
... <HTTPTargetConnection> <Properties/> <URL>https://mocktarget.apigee.net/xml</URL> </HTTPTargetConnection> ...
如要儲存對等網路設定的變更,請按一下「儲存」按鈕。
Apigee 會將變更儲存至新的 Proxy 修訂版本。
- 如要部署新修訂版本,請選取「Deploy to: test」,然後按一下「Deploy 2」。
- 在確認對話方塊中,按一下「部署」。
如果發生錯誤,Apigee 會儲存您的變更,但不會部署 Proxy。發生錯誤時:
- 修正 Proxy 設定。Apigee 可能會以彈出式視窗提供語法指引。
- 如果 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