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 realiza 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 potencialmente una mayor confiabilidad, habilitar la implementación de 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 de HTTP, envía una solicitud PUT a la API de actualización de propiedades de la organización. Configura 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). Configúralo como true para permitir la implementación de HTTP; de lo contrario, como 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 intentará usar HTTP. Esto puede causar demoras si deberías usar HTTP.
  • always: Todos los eventos de configuración usan HTTP.

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

Además de configurar estas propiedades en el cuerpo del mensaje, debes configurar el encabezado Content-Type como 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 HTTP en todos los proxies de API en todas las organizaciones, debes actualizar cada organización como se describió anteriormente.

Prueba la actualización

Para probar que la actualización se haya realizado correctamente, activa un evento de implementación en un proxy de API en la organización actualizada y, luego, observa los archivos de registro de Message Processor. La entrada de registro de los eventos de implementación debe contener mode:API.

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