Você está visualizando a documentação do Apigee Edge.
Acesse a
documentação da
Apigee X. info
Como cliente atual do Apigee Edge, você pode migrar sua instalação para o Apigee X para aproveitar novos recursos ou diferentes disponibilidades regionais.
Esta página descreve antipadrões na configuração que você precisa resolver antes de migrar para o Apigee X, além de outras mudanças no comportamento que você precisa conhecer antes da migração.
A lista mais ampla de antipadrões do Apigee Edge descreve práticas de uso que devem ser evitadas em qualquer caso. Esta página descreve as práticas de uso desaconselhadas específicas que vão bloquear uma migração. Resolva esses problemas agora para evitar problemas ao migrar para o Apigee X.
Apps sem produtos de API | ||||||||||||||||||||||||
Resumo | Requer mudanças no lado do cliente? | Resolução | ||||||||||||||||||||||
Há apps sem produtos de API. Diferença entre a Apigee Edge e a Apigee X:
|
Não. |
Resolução: apps sem produtos de APIAssocie todas as credenciais do app a pelo menos um produto de API. Para mais informações sobre como fazer isso, consulte Registrar apps e gerenciar chaves de API. Uma maneira fácil é atribuir o acesso de cada app a todos os produtos de API. Isso será equivalente ao que é possível no Apigee Edge. O desafio será se você quiser seguir uma abordagem de "privilégio mínimo". Nesse caso, será necessário determinar a lista mínima de produtos de API a que cada credencial do app precisa ter acesso. Você pode analisar isso com os relatórios do Apigee Edge Analytics com base no ID do cliente. |
||||||||||||||||||||||
Cache sem tempo de expiração | ||||||||||||||||||||||||
Resumo | Requer mudanças no lado do cliente? | Resolução | ||||||||||||||||||||||
Os caches não têm um tempo de validade. Diferença entre a Apigee Edge e a Apigee X:
|
Não |
Resolução: cache sem tempo de expiraçãoDefina um tempo de expiração para todos os caches. |
||||||||||||||||||||||
Expressões de filtro JSONPath em caminhos indefinidos | ||||||||||||||||||||||||
Resumo | Requer mudanças no lado do cliente? | Resolução | ||||||||||||||||||||||
Para caminhos não definitivos, a consulta do resultado de uma expressão de filtro não faz parte da especificação JSONPath. Consulte https://goessner.net/articles/JsonPath/. Diferença entre a Apigee Edge e a Apigee X: Ao navegar nessa estrutura de exemplo, { "books": [ { "name": "A", }, { "name": "B", } ] } Com a expressão
Com a expressão
|
Sim |
Resolução: expressões de filtro JSONPath em caminhos indefinidosEncontre e substitua as consultas afetadas. |
||||||||||||||||||||||
Expressões JSONPath para índices que não estão presentes | ||||||||||||||||||||||||
Resumo | Requer mudanças no lado do cliente? | Resolução | ||||||||||||||||||||||
As expressões JSONPath com um índice que não está presente têm comportamentos diferentes no Apigee X
em comparação com o Apigee Edge. A Apigee X retorna um erro Diferença entre a Apigee Edge e a Apigee X: Ao navegar nessa estrutura de exemplo, { "books": [ { "name": "A", }, { "name": "B", } ] } Com a expressão
|
Sim |
Solução: expressões JSONPath para índices que não estão presentesEncontre e substitua as consultas afetadas. |
||||||||||||||||||||||
Expressões JSONPath com um índice de matriz que não retorna um objeto de matriz | ||||||||||||||||||||||||
Resumo | Requer mudanças no lado do cliente? | Resolução | ||||||||||||||||||||||
As expressões JSONPath com um índice de matriz ou fatias retornam um objeto de matriz no Apigee X. Diferença entre a Apigee Edge e a Apigee X: Ao navegar nessa estrutura de exemplo, { "books": [ { "name": "A", }, { "name": "B", } ] } Com a expressão
Com a expressão
Com a expressão
|
Sim |
Resolução: expressões JSONPath com um índice de matriz que não retorna um objeto de matrizEncontrar e substituir expressões que podem retornar resultados diferentes após o upgrade. |
||||||||||||||||||||||
Restrições de nome do keystore |
||||||||||||||||||||||||
Resumo | Requer mudanças no lado do cliente? | Resolução | ||||||||||||||||||||||
Os nomes de chaveiro do Apigee X só podem conter letras, números e hifens. Os nomes de keystore do Edge não impõem essas restrições. |
Não |
Resolução: restrições de nome do keystoreVerifique os nomes do keystore e atualize-os para remover caracteres não compatíveis, se necessário. |
||||||||||||||||||||||
Vários caminhos base implantados para um proxy de API |
||||||||||||||||||||||||
Resumo | Requer mudanças no lado do cliente? | Resolução | ||||||||||||||||||||||
Várias revisões de um proxy de API são implantadas em um ambiente, e cada revisão tem um caminho base diferente. Diferença entre a Apigee Edge e a Apigee X:
|
Não |
Resolução: vários caminhos base implantados para um proxy de APIAtualize todos os pacotes para que apenas uma revisão de um pacote seja implantada em um ambiente, independentemente do caminho base. |
||||||||||||||||||||||
Mensagens HTTP que não estão em compliance |
||||||||||||||||||||||||
Resumo | Requer mudanças no lado do cliente? | Resolução | ||||||||||||||||||||||
Os clientes ou o proxy da API enviam mensagens (solicitações ou respostas) que não estão em conformidade com o padrão HTTP. Por exemplo, nomes de cabeçalho inválidos, duplicações em alguns cabeçalhos restritos e assim por diante. Não é possível migrar para o Apigee X se a execução da API tiver um ou mais dos seguintes erros:
|
Sim, possivelmente. |
Resolução: mensagens HTTP incompatíveisCorrija todos os erros nos protocolos HTTP antes de migrar para o Apigee X. Se um erro for originado de um aplicativo cliente, peça ao desenvolvedor do app cliente para corrigir o problema. |
||||||||||||||||||||||
O tempo de expiração do token OAuth 2.0 é inválido. |
||||||||||||||||||||||||
Resumo | Requer mudanças no lado do cliente? | Resolução | ||||||||||||||||||||||
Os limites de validade do token OAuth 2.0 estão fora do intervalo prescrito. Diferença entre a Apigee Edge e a Apigee X:
|
Não |
Resolução: o tempo de expiração do token OAuth 2.0 é inválido
Use a política OAuthV2 e especifique o tempo de expiração em
|
||||||||||||||||||||||
Limites de produtos excedidos |
||||||||||||||||||||||||
Resumo | Requer mudanças no lado do cliente? | Resolução | ||||||||||||||||||||||
A configuração do Apigee Edge não é compatível com os limites do produto definidos. Alguns limites de produtos que são documentados, mas não aplicados no Apigee Edge, são aplicados no Apigee X. |
Não |
Solução: limites de produtos excedidosCorrija qualquer uso que exceda os limites do produto antes de migrar para o Apigee X. |
||||||||||||||||||||||
Políticas ServiceCallout com especificadores de conexão de destino de endpoint e caminho |
||||||||||||||||||||||||
Resumo | Requer mudanças no lado do cliente? | Resolução | ||||||||||||||||||||||
Na política ServiceCallout, o elemento
O Apigee Edge documenta esse requisito, mas não o aplica. A Apigee X vai interromper o processamento se encontrar uma |
Não |
Resolução: políticas de ServiceCallout com especificadores de conexão de destino de endpoint e caminho
Verifique as configurações da política ServiceCallout e elimine todas as
|
||||||||||||||||||||||
Restrições de nome do servidor de destino |
||||||||||||||||||||||||
Resumo | Requer mudanças no lado do cliente? | Resolução | ||||||||||||||||||||||
Os nomes dos servidores de destino do Apigee X só podem conter letras, números, hifens e pontos. Os nomes de servidor de destino de borda não impõem essas restrições. |
Não |
Resolução: Restrições de nome do servidor de destinoVerifique os nomes dos servidores de destino e atualize-os para remover caracteres não compatíveis, se necessário. |
||||||||||||||||||||||
Certificado de teste em um host virtual |
||||||||||||||||||||||||
Resumo | Requer mudanças no lado do cliente? | Resolução | ||||||||||||||||||||||
Um ou mais hosts virtuais usam o certificado de "teste sem custo financeiro" fornecido pela Apigee. Isso faz com que o host virtual responda a solicitações em domínios como Diferença entre a Apigee Edge e a Apigee X:
|
Sim |
Resolução: certificado de teste em um host virtualVocê precisa configurar seu próprio domínio e provisionar os certificados de forma adequada.
Qualquer aplicativo cliente que dependa do nome de domínio legado do
formulário |
||||||||||||||||||||||
DNS não resolvido |
||||||||||||||||||||||||
Resumo | Requer mudanças no lado do cliente? | Resolução | ||||||||||||||||||||||
Os endpoints de destino têm nomes de domínio não resolvidos. Diferença entre a Apigee Edge e a Apigee X:
|
Não |
Resolução: DNS não resolvidoAtualize o endpoint de destino com um nome de domínio válido. |