Ativar implantação HTTP

Por padrão, o Edge usa RPC para implantar proxies de API. Esse modo funciona muito bem para a maioria das instalações, mas topologias maiores com muitos MPs podem passar por tempos limite quando um grande número de chamadas simultâneas é feito via RPC. A Apigee planeja descontinuar essa implementação no futuro.

Por isso, a Apigee recomenda que implantações maiores usem HTTP em vez de RPC.

Além de oferecer maior confiabilidade, ativar a implantação HTTP também melhora o conteúdo e o formato das exceções que podem ser geradas durante o processo de implantação.

Esta seção descreve como ativar o HTTP para implantação.

Atualizar sua organização

Para ativar a implantação HTTP, envie uma solicitação PUT para Atualizar a API de propriedades da organização. Defina as seguintes propriedades no corpo da solicitação:

Propriedade	Descrição
allow.deployment.over.http	Determina se o Edge pode implantar proxies de API por HTTP (além do RPC). Defina como true para permitir a implantação HTTP. Caso contrário, defina como false. O padrão é false. Para ativar as implantações HTTP, defina essa propriedade como true.
use.http.for.configuration	Especifica qual método usar para eventos de configuração. Os valores possíveis são: never: todos os eventos de configuração usam RPC. Esse é o padrão. retry: todos os eventos de configuração usam primeiro o RPC. Se um evento falhar pelo RPC, o Edge tentará usar o HTTP. Isso pode causar atrasos se você estiver usando HTTP. always: todos os eventos de configuração usam HTTP. Para ativar implantações HTTP, a Apigee recomenda definir essa propriedade como always.

Além de definir essas propriedades no corpo da mensagem, você precisa definir o cabeçalho Content-Type como application/json ou application/xml.

O exemplo a seguir chama a API Update Organization Properties com um corpo de mensagem 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 ativar a implantação HTTP em todos os proxies de API em todas as suas organizações, atualize cada organização conforme descrito acima.

Testar a atualização

Para testar se a atualização foi bem-sucedida, acione um evento de implantação em um proxy de API na organização atualizada e confira os arquivos de registro do processador de mensagens. A entrada de registro para os eventos de implantação precisa conter mode:API.

Para mais informações, consulte Arquivos de registro.