HTTP-Bereitstellung aktivieren

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

Daher empfiehlt Apigee, für größere Bereitstellungen HTTP anstelle von RPC zu verwenden.

Die Aktivierung der HTTP-Bereitstellung kann nicht nur die Zuverlässigkeit erhöhen, sondern auch den Inhalt und das Format von Ausnahmen verbessern, die während des Bereitstellungsprozesses auftreten können.

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

Organisation aktualisieren

Senden Sie eine PUT-Anfrage an die Update organization properties API, um die HTTP-Bereitstellung zu aktivieren. Legen Sie im Anfragetext die folgenden Attribute fest:

Attribut Beschreibung
allow.deployment.over.http Bestimmt, ob Edge API-Proxys über HTTP (zusätzlich zu RPC) bereitstellen kann. Legen Sie true fest, um die HTTP-Bereitstellung zuzulassen. Andernfalls false. Der Standardwert ist false.

Wenn Sie HTTP-Bereitstellungen aktivieren möchten, müssen Sie dieses Attribut auf true festlegen.
use.http.for.configuration

Gibt an, welche Methode für Konfigurationsereignisse verwendet werden soll. Folgende Werte sind möglich:

  • never: Alle Konfigurationsereignisse verwenden RPC. Das ist die Standardeinstellung.
  • retry: Alle Konfigurationsereignisse verwenden zuerst RPC. Wenn ein Ereignis über RPC fehlschlägt, versucht Edge es mit HTTP. Dies kann zu Verzögerungen führen, wenn Sie HTTP verwenden sollten.
  • always: Alle Konfigurationsereignisse verwenden HTTP.

Wenn Sie HTTP-Deployments aktivieren möchten, empfiehlt Apigee, dieses Attribut auf always festzulegen.

Zusätzlich zum Festlegen dieser Properties im Text der Nachricht müssen Sie den Header Content-Type auf application/json oder application/xml setzen.

Im folgenden Beispiel wird die API zum Aktualisieren von Organisationsattributen 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"
      } ]
    }
  }'

Wenn Sie die HTTP-Bereitstellung für alle API-Proxys in allen Ihren Organisationen aktivieren möchten, müssen Sie jede Organisation wie oben beschrieben aktualisieren.

Update testen

Um zu testen, ob die Aktualisierung erfolgreich war, lösen Sie ein Bereitstellungsereignis für einen API-Proxy in der aktualisierten Organisation aus und sehen Sie sich dann die Logdateien des Message Processors an. Der Logeintrag für die Bereitstellungsereignisse sollte mode:API enthalten.

Weitere Informationen finden Sie unter Logdateien.