Abilita deployment HTTP

Per impostazione predefinita, Edge utilizza RPC per il deployment dei proxy API. Sebbene questa modalità funzioni molto bene per la maggior parte delle installazioni, le topologie più grandi con molti MP potrebbero riscontrare timeout quando viene effettuato un numero elevato di chiamate simultanee tramite RPC. Apigee prevede di ritirare questa implementazione in futuro.

Di conseguenza, Apigee consiglia di utilizzare HTTP anziché RPC per il deployment per i deployment più grandi.

Oltre a offrire potenzialmente una maggiore affidabilità, l'abilitazione del deployment HTTP migliora anche il contenuto e il formato delle eccezioni che potrebbero essere generate durante il processo di deployment.

Questa sezione descrive come attivare HTTP per il deployment.

Aggiornare l'organizzazione

Per abilitare il deployment HTTP, invia una richiesta PUT all'API Aggiorna proprietà dell'organizzazione. Imposta le seguenti proprietà nel corpo della richiesta:

Proprietà Descrizione
allow.deployment.over.http Determina se Edge può eseguire il deployment di proxy API tramite HTTP (oltre a RPC). Imposta su true per consentire il deployment HTTP; in caso contrario, false. Il valore predefinito è false.

Per attivare i deployment HTTP, devi impostare questa proprietà su true.
use.http.for.configuration

Specifica il metodo da utilizzare per gli eventi di configurazione. I valori possibili sono:

  • never: tutti gli eventi di configurazione utilizzano RPC. Questa è l'impostazione predefinita.
  • retry: tutti gli eventi di configurazione utilizzano prima RPC; se un evento non riesce tramite RPC, Edge prova con HTTP. Ciò può causare ritardi se utilizzi HTTP.
  • always: tutti gli eventi di configurazione utilizzano HTTP.

Per abilitare i deployment HTTP, Apigee consiglia di impostare questa proprietà su always.

Oltre a impostare queste proprietà nel corpo del messaggio, devi impostare l'intestazione Content-Type su application/json o application/xml.

L'esempio seguente chiama l'API Update Organization Properties con un corpo del messaggio JSON.

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"
      } ]
    }
  }'

Per attivare il deployment HTTP su tutti i proxy API in tutte le tue organizzazioni, devi aggiornare ogni organizzazione come descritto sopra.

Testa l'aggiornamento

Per verificare che l'aggiornamento sia andato a buon fine, attiva un evento di deployment su un proxy API nell'organizzazione aggiornata e poi controlla i file di log di Message Processor. La voce di log per gli eventi di deployment deve contenere mode:API.

Per ulteriori informazioni, consulta File di log.