啟用 HTTP 部署作業

根據預設,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 部署作業,您必須將這項屬性設為 true

use.http.for.configuration

指定要用於設定事件的方法。可能的值為:

  • never:所有設定事件都使用 RPC。此為預設值。
  • retry:所有設定事件會先使用 RPC;如果事件透過 RPC 失敗,Edge 會嘗試 HTTP如果您應使用 HTTP,這可能會導致延遲。
  • always:所有設定事件都使用 HTTP。

如要啟用 HTTP 部署,Apigee 建議將這個屬性設為 always

除了在郵件內文中設定這些屬性之外,您還必須 將 Content-Type 標頭設定為 application/jsonapplication/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

詳情請參閱記錄檔