Visão geral dos recursos técnicos da Apigee

Esta página se aplica à Apigee e à Apigee híbrida.

Confira a documentação da Apigee Edge.

Neste tópico, você vê o resumo dos recursos da Apigee e a comparação entre eles e a Apigee híbrida.

A tabela a seguir lista os produtos de gerenciamento de API da Apigee comparados neste tópico:

Produto Onde está hospedado Gerenciado por
Apigee Google Cloud Apigee
Apigee híbrida O Google Cloud e o data center particular do cliente A Apigee administra o plano de gerenciamento e o cliente gerencia o plano de ambiente de execução.

Resumo dos recursos da Apigee

A tabela a seguir fornece um resumo em nível de recurso da Apigee (e híbrida).

Recurso Suporte na Apigee e no ambiente híbrido
Revisões de proxy de API

Imutável quando implantado
Adaptador da Apigee para Istio Obsoleto: recomendamos que você use o adaptador da Apigee para Envoy.
Organização do app Organize apps usando AppGroups ou associações de desenvolvedores de apps. Consulte Como organizar a propriedade de apps cliente.
Deployments
  • Implantações assíncronas
  • A recuperação do status de implantação é baseada na última vez em que o plano de ambiente de execução "fez check-in" com o plano de gerenciamento.
Ambientes
  • Compatibilidade para grupos de ambiente
  • Autoatendimento nas IUs e APIs da Apigee
  • Flexibilidade na topologia de exibição
  • Um pod de MP pode exibir apenas um ambiente

Para mais informações, consulte Sobre ambientes e grupos de ambiente.
Suporte a proxy baseado em gRPC

Processar solicitações unárias de API do protocolo gRPC para um servidor de destino gRPC. Consulte Como criar proxies da API gRPC.
Caso de nome de campo do cabeçalho HTTP/1.1

Converte nomes de campo de cabeçalho HTTP/1.1 em letras minúsculas quando encaminhados para o back-end. Esse comportamento pode afetar aplicativos que precisam ser preservados.

Keystores/Truststores
  • Northbound gerenciado como secrets do Kubernetes
KVMs
  • É possível criar KVMs criptografadas com escopo de ambiente na IU da Apigee. As KVMs são sempre criptografadas. Não é possível adicionar, atualizar ou visualizar entradas KVM na IU.
  • Use o atributo private. com todas as variáveis ao acessar uma KVM com o comando GET para ocultar as informações da KVM em uma sessão de depuração (Trace). Se o atributo private. não for usado, a KVM ainda será criptografada. No entanto, as informações da KVM aparecerão descriptografadas na sessão de depuração (Trace) e nenhuma exceção será gerada.
  • Gerencie entradas da KVM usando a API keyvaluemaps.entries ou a política KeyValueMapOperations.
  • É possível usar conjuntos de propriedades para alguns dos casos de uso como KVMs. Consulte Como usar conjuntos de propriedades.
  • O elemento <MapName> permite que a política KeyValueMapOperations identifique qual KVM usar dinamicamente, no ambiente de execução.

Para mais informações sobre como criar KVMs na IU, consulte Como usar mapas de chave-valor. Consulte também Como acessar dados de configuração para informações sobre como escolher o mecanismo de persistência de dados correto.
Monetização Compatível com a Apigee e a Apigee híbrida. Consulte Visão geral da monetização para conhecer os recursos.
Node.js
  • Os proxies da API Node.js não são compatíveis.
  • A Apigee recomenda que você hospede aplicativos Node.js como contêineres separados no Kubernetes (mesmo cluster ou diferente)
OAuth A nova política RevokeOAuthv2 revoga por ID de usuário final, pelo ID do app ou ambos.
Políticas Consulte Visão geral da política.
Recursos Não é possível usar recursos no nível da organização
Papéis e permissões
  • Gerenciado por meio do serviço de IAM do Console do Google Cloud
  • Algumas funções prontas para uso estão disponíveis
  • É possível criar papéis personalizados que podem incluir outras permissões do Google Cloud

Para mais informações, consulte Usuários e papéis.
Serviços de SOAP no assistente de criação de proxy Incompatível. Consulte o wsdl2apigee, um projeto de código aberto que fornece utilitários SOAP para uso com a Apigee.
Sessões de rastreamento/depuração Consulte Suporte do Trace.
Hosts virtuais

Para o híbrido:

  • A entrada é implementada com o Anthos Service Mesh.
  • As chaves e os certificados são implantados diretamente no Kubernetes.

Para a Apigee:

  • Cada instância expõe um endpoint HTTPS por meio de um certificado autoassinado. Para fazer o download da CA do certificado, consulte a organização.

Suporte de trace/depuração

A tabela a seguir mostra a compatibilidade com a Apigee e o Trace híbrido:

Recurso Apigee e suporte híbrido
Momento oportuno Pequeno atraso, assíncrona
Nome/ID da sessão Não aceita o nome da sessão do usuário.
Filtros Suporte para lógica de filtragem complexa, incluindo operações lógicas "E" e "OU". Acesso a qualquer variável de fluxo mencionada na referência de variáveis de fluxo. A sintaxe é a mesma usada com condicionais, como mostrado na referência de condições.
Tempo limite da sessão

Define somente a duração da sessão de depuração. O ponto de partida é quando o processador de mensagens recebe a solicitação para ser executada no modo de depuração.

O valor padrão será 5 minutos se a sessão tiver sido iniciada com a API e 10 minutos se tiver sido iniciada na IU.

Os dados são mantidos por 24 horas até que sejam excluídos automaticamente pela Apigee híbrida.
Validade da sessão Período em que a solicitação de criação da sessão é válida. Se a sessão de depuração não for iniciada dentro desse tempo, os sincronizadores poderão ignorar a solicitação de criação da sessão. Certifique-se de manter os relógios dos sincronizadores sincronizados, conforme descrito em Pré-requisitos.
Contagem de solicitações de trace O padrão é 10 por processador de mensagens, e o máximo é 15.
APIs A Apigee expõe a API Debug Session e a API Debug Session Data

Visão geral da API

Veja a seguir um resumo das funcionalidades e APIs da Apigee.

Comportamento APIs Apigee
Domínio de base apigee.googleapis.com
Tipos de mídia application/json
Autenticação OAuth2
Carimbos de data/hora em chaves Formato String 
{
  "createdAt": "1234",
  "lastModifiedAt": "5678"
}
Estrutura do parâmetro de consulta expand=false 
{
  "proxies": [
    {
      "name": "helloworld"
    },
    {
      "name": "weather"
    }
  ]
}
Parâmetros de consulta prefixados por sublinhado Não compatível (optimal=true)
Propriedades em payloads:
  • created_by
  • modified_by
  • self
 Incompatível
Valores padrão em payloads Não incluso
Estrutura de tratamento de erros 
{
  "error": {
    "code": 409,
    "message": "...",
    "status": "ABORTED",
    "details": [...]
  }
}
Resposta de exclusão de cache Retorna: 204 No Content
Operações da API de cache List e delete apenas. O cache L1 de curta duração é criado automaticamente quando você implanta um proxy de API. Para mais informações, consulte Caches internos.

APIs de métricas da Apigee

Resumo das APIs de métricas da Apigee:

Recurso APIs Apigee
endpoint de API apigee.googleapis.com
E-mails de análise diários Nenhuma API compatível
API Async Query List A propriedade userId foi omitida da resposta. Consulte Método: organizations.environments.queries.list.
APIs de relatórios personalizados As propriedades createdBy e lastModifiedBy foram removidas da resposta. Consulte a API Reports.

Recursos da Apigee híbrida

A tabela a seguir resume os recursos híbridos:

Serviço Área híbrida
Analytics Um pod de coleta de dados no plano do ambiente de execução usa fluentd e UDCA (Agente universal de coleta de dados, na sigla em inglês) para reunir análise e alimentar os dados para a UAP (plataforma de análise unificada) no plano de gerenciamento.
Gateway de proxy de API O Processador de mensagens (MP, na sigla em inglês) processa as solicitações recebidas. Os MPs são implementados como um ou mais apps em contêiner no plano do ambiente de execução.
Persistência O Cassandra fornece persistência para os recursos KMS, KVM, cota e cache.
Implantação O Synchronizer garante que as configurações de proxy de API, as informações de ambiente e outros dados sejam atualizados entre o plano de gerenciamento e o de tempo de execução.
Interface do usuário administrativa A interface da Apigee é um app em contêiner hospedado no plano de gerenciamento.
Balanceamento de carga Um controlador de entrada Istio envia solicitações ao app em contêiner Router/Message Processor (RMP) no plano de ambiente de execução.
APIs As APIs Apigee são acessadas por meio do servidor de gerenciamento e do MART. O MART interage com o armazenamento de dados local do Cassandra e atua como provedor de API para que as APIs Apigee acessem e gerenciem entidades de dados de ambiente de execução.
Métricas Gerenciado por um único servidor Prometheus por cluster para todos os serviços.