HTTP-Bereitstellung aktivieren

Standardmäßig verwendet Edge RPC, um API-Proxys bereitzustellen. Dieser Modus funktioniert zwar für die meisten Installationen sehr gut, bei größeren Topologien mit vielen MP kann es jedoch zu Zeitüberschreitungen kommen, wenn eine große Anzahl von gleichzeitigen Aufrufen über RPC erfolgt. Apigee plant, diese Implementierung in der Zukunft einzustellen.

Daher empfiehlt Apigee, bei größeren Bereitstellungen HTTP anstelle von RPC für die Bereitstellung zu verwenden.

Die HTTP-Bereitstellung bietet nicht nur eine potenziell höhere Zuverlässigkeit, sondern verbessert auch den Inhalt und das Format von Ausnahmen, die während des Bereitstellungsvorgangs auftreten können.

In diesem Abschnitt wird beschrieben, wie Sie HTTP für die Bereitstellung aktivieren.

Organisation aktualisieren

Wenn Sie die HTTP-Bereitstellung aktivieren möchten, senden Sie eine PUT-Anfrage an die API zum Aktualisieren von Organisationsattributen. Legen Sie im Text der Anfrage die folgenden Attribute fest:

Attribut	Beschreibung
allow.deployment.over.http	Bestimmt, ob Edge API-Proxys zusätzlich zu RPC über HTTP bereitstellen kann. Legen Sie true fest, um die HTTP-Bereitstellung zuzulassen, andernfalls false. Der Standardwert ist false. Sie müssen dieses Attribut auf true festlegen, um HTTP-Bereitstellungen zu aktivieren.
use.http.for.configuration	Gibt an, welche Methode für Konfigurationsereignisse verwendet werden soll. Folgende Werte sind möglich: never: Für alle Konfigurationsereignisse wird RPC verwendet. Das ist die Standardeinstellung. retry: Für alle Konfigurationsereignisse wird zuerst RPC verwendet. Wenn ein Ereignis über RPC fehlschlägt, versucht Edge, HTTP zu verwenden. Dies kann zu Verzögerungen führen, wenn Sie eigentlich HTTP verwenden sollten. always: Für alle Konfigurationsereignisse wird HTTP verwendet. Um HTTP-Bereitstellungen zu aktivieren, empfiehlt Apigee, diese Eigenschaft auf always festzulegen.

Sie müssen diese Eigenschaften nicht nur im Nachrichtentext festlegen, sondern auch den Content-Type-Header auf application/json oder application/xml festlegen.

Im folgenden Beispiel wird die API zum Aktualisieren von Organisationseigenschaften mit einem JSON-Nachrichtentext aufgerufen.

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

Um die HTTP-Bereitstellung auf allen API-Proxys in allen Ihren Organisationen zu aktivieren, müssen Sie jede Organisation wie oben beschrieben aktualisieren.

Update testen

Um zu prüfen, ob das Update erfolgreich war, lösen Sie ein Bereitstellungsereignis für einen API-Proxy in der aktualisierten Organisation aus und sehen Sie sich dann die Protokolldateien des Nachrichten-Prozessors an. Der Logeintrag für die Bereitstellungsereignisse sollte mode:API enthalten.

Weitere Informationen finden Sie unter Protokolldateien.