Habilitar la implementación HTTP

De forma predeterminada, Edge usa RPC para implementar proxies de API. Si bien este modo funciona muy bien para la mayoría de las instalaciones, las topologías más grandes con muchos MP pueden experimentar tiempos de espera cuando se realizan una gran cantidad de llamadas simultáneas a través de RPC. Apigee planea dar de baja esta implementación en el futuro.

Como resultado, Apigee recomienda que las implementaciones más grandes usen HTTP en lugar de RPC para la implementación.

Además de proporcionar una mayor confiabilidad, habilitar la implementación HTTP también mejora el contenido y el formato de las excepciones que se pueden generar durante el proceso de implementación.

En esta sección, se describe cómo habilitar HTTP para la implementación.

Actualiza tu organización

Para habilitar la implementación HTTP, envía una solicitud PUT a la API de Update organization properties. Establece las siguientes propiedades en el cuerpo de la solicitud:

Propiedad Descripción
allow.deployment.over.http Determina si Edge puede implementar proxies de API a través de HTTP (además de RPC). Establece true para permitir la implementación de HTTP; de lo contrario, es false. El valor predeterminado es false.

Para habilitar las implementaciones HTTP, debes establecer esta propiedad en true.

use.http.for.configuration

Especifica qué método usar para los eventos de configuración. Los valores posibles son:

  • never: Todos los eventos de configuración usan RPC. Esta es la opción predeterminada.
  • retry: Todos los eventos de configuración usan RPC primero. Si un evento falla a través de RPC, Edge intenta HTTP. Esto puede causar retrasos si debes usar HTTP.
  • always: Todos los eventos de configuración usan HTTP.

Para habilitar las implementaciones HTTP, Apigee recomienda establecer esta propiedad en always.

Además de configurar estas propiedades en el cuerpo del mensaje, debes establecer el encabezado Content-Type en application/json o application/xml.

En el siguiente ejemplo, se llama a la API de Update organization properties con un cuerpo de mensaje 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"
      } ]
    }
  }'

Para habilitar la implementación de HTTP en todos los proxies de API de todas tus organizaciones, debes actualizar cada organización como se describió anteriormente.

Prueba la actualización

Para probar que la actualización se realizó correctamente, activa un evento de implementación en un proxy de API en la organización actualizada y, luego, consulta los archivos de registro del procesador de mensajes. La entrada de registro de los eventos de implementación debe contener mode:API.

Para obtener más información, consulta Archivos de registro.