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. | |