Você está visualizando a documentação do Apigee Edge.
  Acesse a
      documentação da
      Apigee X. info
Este tópico descreve como o Apigee X (às vezes chamado simplesmente de "Apigee") é diferente do Apigee Edge. Essas informações são destinadas aos clientes atuais da Apigee Edge que estão considerando migrar para a Apigee X.
Para mais informações sobre os recursos da Apigee X, consulte o resumo de recursos da Apigee X.
A tabela a seguir lista os produtos de gerenciamento de API da Apigee comparados neste tópico:
| Produto | Onde está hospedado | Gerenciado por | 
|---|---|---|
| Apigee Edge para nuvem pública | Nuvem da Apigee | Apigee | 
| Apigee Edge para nuvem privada | O data center particular do cliente. | Cliente | 
| Apigee X | 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. | 
Comparação dos recursos do Apigee Edge com o Apigee X
As seções a seguir comparam os recursos da nuvem pública/privada da Apigee Edge com a disponibilidade de recursos na Apigee X e na híbrida.
Os limites da Apigee X também são diferentes dos limites da Apigee Edge.
Resumo das diferenças nos recursos atuais
Na tabela a seguir, descrevemos as diferenças no nível de recurso entre a Apigee X (e a híbrida) e a Apigee Edge para plataformas de nuvem pública e privada.
| Recurso da Apigee Edge | Suporte na Apigee X e na híbrida | 
|---|---|
| Revisões de proxy de API | 
           Imutável quando implantado  | 
      
| Verificações de integridade ativas | Suporte para MIGs externos (que usam VMs). Não é compatível com o Private Service Connect. Para informações sobre os tipos de roteamento, consulte Configurar o roteamento. | 
| Adaptador da Apigee para Istio | Obsoleto: recomendamos que você use o adaptador da Apigee para Envoy. | 
| Empresas e desenvolvedores | 
           Uma solução semelhante, mas não idêntica, está disponível. Consulte Como usar o AppGroups para organizar a propriedade de apps.  | 
      
| CwC (código com configuração) | 
           Planejado  | 
      
| Deployments | 
          
  | 
      
| Ambientes | 
          
 Para mais informações, consulte Sobre ambientes e grupos de ambiente.  | 
      
| Destinos hospedados | 
           Use o Cloud Run ou o Cloud Functions.  | 
      
| Processamento do 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. No Apigee Edge, a caixa dos nomes de campos do cabeçalho é preservada. | 
| Papéis do IAM para controle de acesso granular baseado em função | 
           Planejado  | 
      
JSONPath usando [@.length-x] | 
        
           O uso de  Para este exemplo: {
    "books": [
      {
        "name": "A",
      },
      {
        "name": "B",
      }
    ]
}A entrada:   | 
      
| Keystores/Truststores | 
           Northbound gerenciado como secrets do Kubernetes  | 
      
| KVMs | 
          
 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.  | 
      
| Microgateway | Recomendamos o uso do Adaptador da Apigee para Envoy. | 
| Monetização | Consulte Diferenças com a monetização. | 
| Node.js | 
          
  | 
      
| mTLS no sentido norte | Suporte dos balanceadores de carga do Google Cloud. Consulte Apigee X TLS mútuo de entrada usando o balanceador de carga de aplicativo externo. | 
| OAuth | A nova política RevokeOAuthv2 revoga por ID de usuário final, pelo ID do app ou ambos. Essa política substitui a API Apigee Edge para revogar os tokens do OAuth2. | 
| Políticas | 
          
  | 
      
| reasonPhrase | Incompatível. | 
| Recursos | Não é possível usar recursos no nível da organização | 
| Papéis e permissões | 
          
 Para mais informações, consulte Usuários e papéis.  | 
      
| Apigee Sense | Use a Segurança avançada da API. | 
| 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 | Veja Diferenças com o Trace. | 
| Hosts virtuais | Para a Apigee híbrida: 
 Para a Apigee X: 
  | 
      
Diferenças com o Trace
A tabela a seguir compara as diferenças na maneira como o Trace opera na Apigee X e na híbrida em comparação à Apigee Edge Cloud:
| Recurso | Apigee Edge Cloud | Apigee X e híbrida | 
|---|---|---|
| Atualidade | Em tempo real, síncrona | Pequeno atraso, assíncrona | 
| Nome/ID da sessão | Aceita o nome da sessão do usuário | Não aceita o nome da sessão do usuário. | 
| Filtros | Compatibilidade básica com filtros, como filtragem de parâmetros de consulta e cabeçalho | 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 a duração da sessão de depuração e por quanto tempo os dados são retidos. O valor padrão é de 20 minutos quando iniciado por chamadas de API e 10 minutos quando iniciado na IU.  | 
   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 | Máximo de 20 por processador de mensagens | O padrão é 10 por processador de mensagens, e o máximo é 15. | 
| API | Apigee Edge Cloud | Apigee X | 
| A Apigee X expõe a API Debug Session e a API Debug Session Data, mas não é compatível com os seguintes elementos nas APIs da Apigee X: | ||
| Interromper sessão de depuração | ||
| Excluir transações específicas | ||
Diferenças na monetização
A tabela a seguir fornece uma comparação dos principais recursos entre a monetização da Apigee Edge e a monetização da Apigee X.
| Monetização da Apigee Edge | Monetização da Apigee X/híbrida | 
|---|---|
| Os planos de taxas estão associados a pacotes de produtos da API que podem ser vinculados a vários produtos da API | Os planos de taxas estão associados aos produtos de API (relação um para um) | 
| Os desenvolvedores de apps compram planos de taxas | Desenvolvedores de apps compram produtos de API | 
| As cotas são gerenciadas no nível do proxy da API | As cotas são gerenciadas no nível do produto de API (nível de negócios) | 
| Os planos de preços publicados só podem expirar. Eles não podem ser editados ou excluídos | Os planos de taxas publicados podem expirar, ser editados, movidos para rascunho ou excluídos | 
| Configuração complexa (sem assistente ou ferramenta de visualização) | Configuração simplificada dos planos de taxas usando o assistente e a ferramenta de visualização | 
A política MonetizationLimitsCheck bloqueia o acesso após a primeira chamada de API ser processada se o desenvolvedor do app não tiver comprado uma assinatura | 
      A política MonetizationLimitsCheck bloqueia o acesso imediatamente se o desenvolvedor do app não tiver comprado uma assinatura ou exceder a cota | 
    
| Os dados de monetização para transações podem ser capturados usando variáveis personalizadas na política de registro de transações. | A Apigee captura automaticamente os dados de monetização, e os dados de monetização para transações podem ser substituídos usando a política DataCapture. Consulte Capturar dados de monetização para mais informações. | 
| As contas pré-pagas e pós-pagas podem ser configuradas tanto para os desenvolvedores quanto para os planos de tarifas. | As contas pré-pagas e pós-pagas só podem ser configuradas para desenvolvedores. | 
Quais recursos do Apigee Edge não têm suporte no Apigee X?
O Google não planeja oferecer suporte aos seguintes recursos:
- Extensões do Apigee Edge
 - Armazenamento de especificações da OpenAPI
 - APIs para pesquisar ou revogar tokens de acesso OAuth (porque os tokens são criptografados com hash)
 - OAuth v1 ou política do OAuth OAuthv1.0a
 - Trireme (EOL em 10/10/2019)
 - Os cabeçalhos com o prefixo "X-Apigee-" não são aceitos no Apigee X e são removidos das solicitações e respostas antes do envio para destinos e clientes.
 - A propriedade 
    
proxy_read_timeoutdo Apigee Edge não é compatível com o Apigee X. Consulte Como definir io.timeout.millis e api.timeout para ver as configurações de tempo limite relacionadas do Apigee X. 
Comparação de APIs
Em geral, a maioria das APIs do Apigee Edge tem equivalentes. Nesta seção, apresentamos o seguinte:
- Resumo das mudanças de comportamento em todas as APIs da Apigee Edge em comparação com as APIs da Apigee X
 - Diferenças entre as APIs de métricas da Apigee Edge e da Apigee X
 - Lista de APIs Edge não compatíveis (que não têm equivalentes da API Apigee X).
 
Resumo das mudanças usando a API
Veja a seguir as alterações de comportamento em todas as APIs da Apigee X em comparação com as APIs da Apigee Edge.
| Comportamento | APIs Apigee Edge | APIs da Apigee X | 
|---|---|---|
| Domínio de base | api.enterprise.apigee.com | 
      apigee.googleapis.com | 
    
| Tipos de mídia | application/jsonapplication/xml | 
      application/json | 
    
| Autenticação | OAuth2, SAML, Basic | OAuth2 | 
| Carimbos de data/hora em chaves | Formato int64
         | 
      Formato String
         | 
    
Estrutura do parâmetro de consulta expand=false | 
      [
        "helloworld",
        "weather"
      ] | 
      {
  "proxies": [
    {
      "name": "helloworld"
    },
    {
      "name": "weather"
    }
  ]
} | 
    
| Parâmetros de consulta prefixados por sublinhado | Compatível (_optimal=true) | 
      Não compatível (optimal=true) | 
    
Propriedades em payloads:
        
  | 
      Compatível | Sem suporte | 
| Valores padrão em payloads | Incluído | Não incluso | 
| Estrutura de tratamento de erros | {
        "code": "...",
        "message": "..",
        "contexts": []
      } | 
      {
  "error": {
    "code": 409,
    "message": "...",
    "status": "ABORTED",
    "details": [...]
  }
}
 | 
    
| Resposta de exclusão de cache | Retorna: 200 OK e detalhes do cache | 
      Retorna: 204 No Content | 
    
| Operações da API de cache | Opções List, create, get, update, delete, clear all, and clear. | 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. | 
Diferenças entre as APIs de métricas da Apigee Edge e da Apigee X
O Resumo das alterações usando a API lista as diferenças gerais entre a API Apigee Edge e a API Apigee X. A tabela a seguir lista as diferenças específicas das APIs de métricas:
| Recurso | APIs Apigee Edge | APIs da Apigee X | 
|---|---|---|
| endpoint de API | api.enterprise.apigee.com
    | 
   apigee.googleapis.com
    | 
  
| E-mails de análise diários | Nenhuma API compatível | |
| API Async Query List | Confira uma lista de consultas de análise assíncronas | A propriedade userId foi omitida da resposta.
   Consulte
     Método: organizations.environments.queries.list.
    | 
  
| APIs de relatórios personalizados | API Reports | As propriedades createdBy e lastModifiedBy foram removidas
     da resposta.
   Consulte a API Reports.
    | 
  
APIs Apigee Edge incompatíveis
A tabela a seguir lista as APIs da Apigee Edge não compatíveis (que não têm API Apigee X equivalentes).
| Categoria da API | APIs Apigee Edge incompatíveis | 
|---|---|
| Monitoramento de APIs | Nenhuma API compatível | 
| Proxies de API | 
  | 
  
| Auditorias | Use a API Stackdriver Logging. | 
| Registros em cache | Nenhuma API compatível | 
| Empresas | Nenhuma API compatível | 
| Apps da empresa | Nenhuma API compatível | 
| Família de apps da empresa | Nenhuma API compatível | 
| Chaves de apps da empresa | Nenhuma API compatível | 
| Sessões de depuração | 
      
 Para mais informações, consulte Diferenças com o Trace.  | 
  
| App do desenvolvedor | Acessar contagem de recursos da API | 
| Família de apps do desenvolvedor | Nenhuma API compatível | 
| Extensões | Nenhuma API compatível | 
| Armazenamento de chaves: truststore | Testar um keystore ou truststore | 
| LDAP | Nenhuma API compatível | 
| Monetização | Nenhuma API compatível | 
| OAuth V2 | Nenhuma API compatível | 
| Políticas | Nenhuma API compatível | 
| Arquivos de recurso | 
  | 
  
| Apigee Sense | Nenhuma API compatível | 
| Usuários e funções do usuário | Use as APIs relacionadas ao Google Identity and Access Management (IAM), conforme descrito em Como gerenciar usuários, papéis e permissões usando APIs. | 
| Hosts virtuais | Nenhuma API compatível | 
Apigee Edge para nuvem privada x Apigee híbrida
A tabela a seguir compara a Apigee Edge para nuvem privada e a Apigee híbrida:
| Serviço | Produto ou área de recurso da Apigee | ||
|---|---|---|---|
| Apigee Edge para nuvem privada | Apigee híbrida | ||
| Google Analytics | Servidores Qpid e Postgres | 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 | processador de mensagens | 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 | Nó ou anel do Cassandra | O Cassandra fornece persistência para os recursos KMS, KVM, cota e cache. | |
| Implantação | ZooKeeper | 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 IU da Apigee Edge está hospedada no servidor de gerenciamento | A interface da Apigee é hospedada no plano de gerenciamento. | |
| Balanceamento de carga | Roteador | Um controlador de entrada do Istio envia solicitações ao app em contêiner Processador de mensagens (MP) no plano de ambiente de execução. | |
| APIs | Servidor de gerenciamento | As APIs da Apigee X são acessadas por meio do servidor de gerenciamento e do MART. O MART interage com o repositório de dados local do Cassandra e atua como provedor de API para que as APIs da Apigee X acessem e gerenciem entidades de dados de ambiente de execução. | |
| Métricas | Cada componentes configuradoscom JMX | Gerenciado por um único servidor Prometheus por cluster para todos os serviços. | |