Vista geral das funcionalidades técnicas do Apigee

Esta página aplica-se ao Apigee e ao Apigee Hybrid.

Veja a documentação do Apigee Edge.

Este tópico resume as funcionalidades no Apigee e compara as funcionalidades e a funcionalidade entre o Apigee e o Apigee Hybrid.

A tabela seguinte apresenta os produtos de gestão de APIs da Apigee que são comparados neste tópico:

Produto Onde está alojado Gerida por
Apigee Google Cloud Apigee
Apigee Hybrid O Google Cloud e o centro de dados privado do cliente O Apigee gere o plano de gestão e o cliente gere o plano de tempo de execução.

Resumo das funcionalidades do Apigee

A tabela seguinte fornece um resumo ao nível das funcionalidades do Apigee (e híbrido).

Funcionalidade Apoio técnico no Apigee e no híbrido
Revisões do proxy de API

Imutável quando implementado

Adaptador da Apigee para o Istio Descontinuado: recomendamos que use o Adaptador do Apigee para o Envoy em alternativa.
Organização de apps Organize as apps através de AppGroups ou associações de apps de programadores. Consulte o artigo Organizar a propriedade da app cliente.
Implementações
  • Implementações assíncronas
  • A obtenção do estado de implementação baseia-se na última vez que o plano de tempo de execução fez "check-in" com o plano de gestão
Ambientes
  • Suporte para grupos de ambientes
  • Self-service através da IU e das APIs do Apigee
  • Flexibilidade na topologia de publicação
  • Um MP pod só pode publicar um ambiente

Para mais informações, consulte o artigo Acerca dos ambientes e dos grupos de ambientes.

Suporte de proxy baseado em gRPC

Processar pedidos de API de protocolo gRPC unários para um servidor de destino gRPC. Consulte o artigo Criar proxies de API gRPC.

Nome do campo do cabeçalho HTTP/1.1

Converte os nomes dos campos de cabeçalho HTTP/1.1 em minúsculas quando são encaminhados para o back-end. Este comportamento pode afetar as aplicações que esperam que a capitalização seja preservada.

Repositórios de chaves/repositórios de confiança
  • Northbound gerido como Secrets do Kubernetes
KVMs
  • Pode criar KVMs encriptados com âmbito de ambiente na IU do Apigee. Os KVMs são sempre encriptados. Não pode adicionar, atualizar nem ver entradas KVM na IU.
  • Use o atributo private. com todas as variáveis quando aceder a um KVM com o comando GET para ocultar as informações do KVM numa sessão de depuração (rastreio). Se o atributo private. não for usado, a KVM continua encriptada. No entanto, as informações da KVM aparecem desencriptadas na sessão de rastreio de depuração e não é gerada nenhuma exceção.
  • Pode gerir as entradas de KVM através da API keyvaluemaps.entries ou da política KeyValueMapOperations.
  • Pode usar conjuntos de propriedades para alguns dos mesmos exemplos de utilização que as KVMs. Consulte o artigo Usar conjuntos de propriedades.
  • O elemento <MapName> permite que a política KeyValueMapOperations identifique que KVM usar dinamicamente, no momento da execução.

Para mais informações sobre como criar KVMs na IU, consulte o artigo Usar mapas de chaves-valores. Consulte também Aceder aos dados de configuração para obter informações sobre como escolher o mecanismo de persistência de dados adequado.

Rentabilização Suportado no Apigee e no Apigee Hybrid. Consulte a vista geral da rentabilização para ver as funcionalidades.
Node.js
  • Os proxies de API Node.js não são suportados.
  • A Apigee recomenda que aloje as aplicações Node.js como contentores separados no Kubernetes (cluster igual ou diferente)
OAuth Nova política RevokeOAuthv2 revoga por ID do utilizador final, ID da app ou ambos.
Políticas Consulte a vista geral da política.
Resources Não é possível usar recursos ao nível da organização
Funções e autorizações
  • Gerido através do serviço IAM da consola do Google Cloud
  • Estão disponíveis algumas funções predefinidas organizadas
  • Pode criar funções personalizadas que podem incluir outras autorizações do Google Cloud

Para mais informações, consulte o artigo Utilizadores e funções.

Serviços SOAP no assistente de criação de um proxy Não suportado. Consulte wsdl2apigee, um projeto de código aberto que fornece utilitários SOAP para utilização com o Apigee.
Rastreie/depure sessões Consulte o apoio técnico de rastreio.
Anfitriões virtuais

Para híbrido:

  • O acesso é implementado através do Anthos Service Mesh.
  • As chaves e os certificados são implementados diretamente no Kubernetes.

Para o Apigee:

  • Cada instância expõe um ponto final HTTPS através de um certificado autoassinado. Pode transferir a CA do certificado consultando a organização.

Apoio técnico de rastreio/depuração

A tabela seguinte mostra o suporte do Apigee e do Trace híbrido:

Funcionalidade Suporte híbrido e do Apigee
Oportunidade Ligeiro atraso; assíncrono
Nome/ID da sessão Não aceita o nome da sessão do utilizador
Filtros Suporte para lógica de filtragem complexa, incluindo operações lógicas AND e OR. Acesso a qualquer variável de fluxo mencionada na referência de variáveis de fluxo. A sintaxe é a mesma que a usada com condicionais, conforme mostrado na referência de condições.
Limite de tempo da sessão

Define apenas a duração da sessão de depuração. O ponto de partida é quando o processador de mensagens recebe o pedido para ser executado no modo de depuração.

O valor predefinido é de 5 minutos se a sessão tiver sido iniciada com a API e de 10 minutos se tiver sido iniciada na IU.

Os dados são mantidos durante 24 horas antes de serem eliminados automaticamente pelo híbrido.

Validade da sessão Período durante o qual o pedido de criação de sessão é válido. Se a sessão de depuração não for iniciada dentro deste período, os sincronizadores podem ignorar o pedido de criação da sessão. Certifique-se de que mantém os relógios dos sincronizadores sincronizados, conforme descrito nos pré-requisitos.
Contagem de pedidos de rastreio A predefinição é 10 por processador de mensagens e o máximo é 15.
APIs O Apigee expõe a API Debug Session e a API Debug Session Data

Vista geral da API

O seguinte resume as APIs e a funcionalidade do Apigee.

Comportamento APIs Apigee
Domínio base apigee.googleapis.com
Tipos de suportes application/json
Autenticação OAuth2
Indicações de tempo nas teclas Formato String
{
  "createdAt": "1234",
  "lastModifiedAt": "5678"
}
Estrutura do parâmetro de consulta expand=false
{
  "proxies": [
    {
      "name": "helloworld"
    },
    {
      "name": "weather"
    }
  ]
}
Parâmetros de consulta com prefixo de sublinhado Não suportado (optimal=true)
Propriedades nos payloads:
  • created_by
  • modified_by
  • self
Não suportado
Valores predefinidos em payloads Não incluída
Estrutura de processamento de erros
{
  "error": {
    "code": 409,
    "message": "...",
    "status": "ABORTED",
    "details": [...]
  }
}
Resposta de eliminação da cache Devoluções: 204 No Content
Operações da API Cache Listar e eliminar apenas. A cache de nível 1 de curta duração é criada automaticamente quando implementa um proxy de API. Para mais informações, consulte o artigo Funcionamento interno da cache.

APIs de métricas do Apigee

Resumo das APIs de métricas do Apigee:

Funcionalidade APIs Apigee
Ponto final da API apigee.googleapis.com
Emails de estatísticas diárias Nenhuma API suportada
API Async Query List A propriedade userId é omitida da resposta. Consulte Method: organizations.environments.queries.list.
APIs de relatórios personalizados As propriedades createdBy e lastModifiedBy foram removidas da resposta. Consulte a API Reports.

Funcionalidades do Apigee Hybrid

A tabela seguinte resume as funcionalidades híbridas:

Serviço área híbrida
Analytics Um pod de recolha de dados no plano de tempo de execução usa o fluentd e o UDCA (agente de recolha de dados universal) para recolher estatísticas e introduzir os dados na UAP (plataforma de estatísticas unificada) no plano de gestão.
API Proxy Gateway O processador de mensagens (MP) processa os pedidos recebidos. Os MPs são implementados como uma ou mais apps contentorizadas no plano de tempo de execução.
Persistência O Cassandra oferece persistência para as funcionalidades de KMS, KVM, quota e cache.
Implementação O sincronizador garante que as configurações do proxy de API, as informações do ambiente e outros dados são mantidos atualizados entre o plano de gestão e o plano de tempo de execução.
Interface do utilizador administrativa A IU do Apigee é uma app contentorizada alojada no plano de gestão.
Balanceamento de carga Um controlador Istio Ingress envia pedidos para a app contentorizada Router/Message Processor (RMP) no plano de tempo de execução.
APIs As APIs Apigee são acedidas através do servidor de gestão e do MART. O MART interage com o arquivo de dados Cassandra local e funciona como um fornecedor de APIs para as APIs Apigee acederem e gerirem entidades de dados de tempo de execução.
Métricas Gerido por um único servidor Prometheus por cluster para todos os serviços.