根據預設,Edge 會使用 RPC 部署 API Proxy。雖然大多數人 電腦安裝時,如果 MP 數量較多的大型拓撲可能會發生逾時錯誤 的並行呼叫是透過 RPC 進行。Apigee 預計在日後淘汰這項實作。
因此,Apigee 建議規模較大的部署作業使用 HTTP,而非 RPC。
除了可能提供更高的可靠性外,啟用 HTTP 部署功能也一併改善了 部署期間可能擲回的例外狀況內容和格式。
本節說明如何啟用部署的 HTTP。
更新機構
如要啟用 HTTP 部署作業,請將 PUT
要求傳送至 Update organization properties API。在要求的主體中設定下列屬性:
屬性 | 說明 |
---|---|
allow.deployment.over.http |
決定 Edge 能否透過 HTTP (除了 RPC) 部署 API Proxy。設為 true 可允許 HTTP 部署作業;否則設為 false 。預設值為
false 。
如要啟用 HTTP 部署作業,您必須將這項屬性設為 |
use.http.for.configuration |
指定要用於設定事件的方法。可能的值為:
如要啟用 HTTP 部署,Apigee 建議將這個屬性設為
|
除了在郵件內文中設定這些屬性之外,您還必須
將 Content-Type
標頭設定為 application/json
或
application/xml
。
以下範例會透過 JSON 訊息呼叫 Update organizationProperties API
curl -u admin_email:admin_password "http://management_server_IP:8080/v1/organizations/org_name" -X POST -H "Content-Type: application/json" -d '{ "properties" : { "property" : [ { "name" : "allow.deployment.over.http", "value" : "true" }, { "name" : "use.http.for.configuration", "value" : "always" } ] } }'
如要為所有機構的所有 API Proxy 啟用 HTTP 部署功能,您必須更新每個 機構。
測試更新
如要測試更新是否成功,請觸發
然後查看訊息處理器的記錄檔系統會記錄
部署事件應包含 mode:API
。
詳情請參閱記錄檔。