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.

Por lo tanto, 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. 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 en true para permitir la implementación de HTTP; de lo contrario, false. El valor predeterminado es false.

Para habilitar las implementaciones de 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 prueba 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 establecer esta propiedad en always.

Además de establecer 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 actualización de propiedades de la organización 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 en todas tus 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, consulta los archivos de registro del 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.