Você está lendo a documentação do Apigee Edge.
Acesse a
documentação da Apigee X. info
Na terça-feira, 2 de junho de 2015, lançamos uma nova versão do Apigee Edge na nuvem.
Se você tiver dúvidas, entre em contato com o suporte do Apigee Edge.
Para conferir uma lista de todas as notas de versão do Apigee Edge, consulte Notas de versão da Apigee.
Novos recursos e melhorias
Confira a seguir os novos recursos e melhorias desta versão.
Disponibilidade geral do SmartDocs
O SmartDocs está saindo da versão Beta e entrando em disponibilidade geral. As atualizações e os novos recursos incluem:
- Suporte ao Swagger 2.0, incluindo importação por arquivo ou URL, e suporte a objetos de segurança com nomes personalizados.
- Melhorias no design visual dos modelos que geram o SmartDocs.
- Melhorias de usabilidade e fluxo de trabalho no portal do desenvolvedor, disponíveis no menu "Conteúdo > SmartDocs" no Drupal.
- O que era conhecido como autenticação de "token personalizado" agora é chamado de "chave de API".
- Objetos de "segurança" de autenticação definidos no nível da revisão.
- Configuração da autenticação do cliente no nível do modelo. As novas revisões não redefinem mais as credenciais de cliente do SmartDocs pré-configuradas.
Para mais descrições de recursos, consulte esta postagem do blog.
Para a documentação do SmartDocs, consulte Como usar o SmartDocs para documentar APIs.
Nova versão Beta do editor de proxy de API
Uma nova versão Beta do editor de proxy de API está disponível. Para acessar, clique no link "Acessar a versão Beta" ao editar um proxy de API. É possível alternar entre os "clássico" e "Beta" editores.
Nova política OAuthV2
A nova política DeleteOAuthV2Info permite excluir códigos de autorização e tokens de acesso. Para mais informações, consulte a política Delete OAuthV2 Info.
Novas entidades na política de acesso a entidades
A política de acesso a entidades fornece acesso às seguintes novas entidades: consumerkey-scopes, authorizationcode, requesttoken e verifier. Para mais informações, consulte Política de acesso a entidades.
Exibição de certificados SSL que estão prestes a expirar
A página "Certificados SSL" na interface de gerenciamento (Administrador > Certificados SSL) indica quando os certificados SSL vão expirar em 10, 15, 30 ou 90 dias, dependendo da sua seleção no novo campo suspenso de expiração.
Nome do app do desenvolvedor exibido na interface de gerenciamento
Os apps de desenvolvedor no Edge têm um nome interno que não muda e um nome de exibição que pode ser alterado. Em uma página de app de desenvolvedor na interface de gerenciamento (Publicar > Apps de desenvolvedor > nome do app), o "Nome" interno do app é exibido junto com o "Nome de exibição", facilitando a identificação visual dos apps pelos nomes internos para solução de problemas e gerenciamento de APIs.
A versão clássica de relatórios personalizados está sendo removida da interface de gerenciamento
A versão clássica opcional de relatórios de análise personalizados não está mais disponível na interface de gerenciamento.
Processo de upgrade do SmartDocs
Se você já estava usando o SmartDocs durante o período Beta, os novos recursos e funcionalidades na versão de disponibilidade geral exigem que você faça upgrade do SmartDocs no portal do desenvolvedor.
Todas as páginas do SmartDocs que já foram publicadas no portal do desenvolvedor vão continuar funcionando, mas é necessário seguir o processo de atualização antes de editar ou publicar mudanças em páginas atuais ou novas.
Embora seja possível renderizar e publicar o SmartDocs no portal do desenvolvedor, ele é gerado a partir do modelo de API que reside nos serviços de gerenciamento de API do Edge da Apigee. Todas as mudanças feitas em um modelo de API no Edge serão as mesmas em todos os ambientes do Pantheon (semelhante a como os desenvolvedores existem em ambientes do Pantheon).
Para fazer upgrade do SmartDocs Beta para a disponibilidade geral
- Atualize e teste a versão 15.05.27 nos ambientes dev ou test ambientes no Pantheon.
- Crie um novo modelo para substituir qualquer modelo de API que você esteja usando.
- Se você estava importando documentos Swagger ou WADL, importe-os novamente para uma nova revisão.
- Se você estava mantendo o modelo de API pelo módulo SmartDocs, exporte como JSON do SmartDocs e importe para o novo modelo usando o anexo de arquivo.
- Defina as propriedades de segurança da revisão do modelo. Na página Conteúdo >
SmartDocs > modelo, selecione Configurações de segurança.
- Verifique qualquer autenticação pré-configurada na página de configurações do modelo (Conteúdo >
SmartDocs) clicando em Configurações na coluna "Operações".
- Atualize todos os modelos personalizados para usar a versão 6 dos recursos CSS e JS e faça mudanças para refletir quaisquer novos nomes de objetos, como authSchemes e apiSchema. Para informações sobre como atualizar modelos do SmartDocs, consulte Como usar o SmartDocs para documentar APIs.
- Renderize e publique novamente a revisão do modelo.
- Depois de validar a nova documentação, atualize o portal de produção para a versão 15.05.27.
Se você é um cliente corporativo do Edge e tem dúvidas ou preocupações sobre o processo de upgrade, envie um e-mail para marsh@apigee.com e cnovak@apigee.com. Caso contrário, use a comunidade da Apigee para receber a melhor resposta.
Bugs corrigidos
Os bugs abaixo foram corrigidos nesta versão.
| ID do problema | Descrição |
|---|---|
| TBD-72 | Problema na política de registro de mensagens |
| MGMT-2124 | As permissões da função do cliente são redefinidas ao salvar as permissões na interface |
| MGMT-2048 | O usuário com função personalizada que limita as permissões de implantação a um ambiente pode implantar em outros |
| MGMT-2041 | Remover o elemento FaultRules do modelo de anexo padrão O elemento FaultRules, que não é usado em políticas ou etapas de proxy de API, não é mais adicionado automaticamente quando você cria proxies de API ou adiciona políticas. |
| MGMT-2034 | A busca de WSDL retorna falha: "Erro ao buscar WSDL: erro ao processar WSDL." |
| MGMT-1812 | Adicionar validação de TargetEndpoint durante a importação Semelhante ao ProxyEndpoint, o TargetEndpoint será validado para o esquema e as expressões adequados usados nas condições durante a importação do proxy de API. |
| MGMT-1345 | A importação de WSDL com vários namespaces resulta em uma etapa de criação de SOAP incorreta |
| MGMT-800 | A criação de um recurso com o nome "padrão" resulta em uma interface quebrada |
| MGMT-602 | Visualização de desenvolvimento de proxy de API: adicionar uma política de cache de resposta quando o endpoint não tem PreFlow/PostFlow causa erro |
| MGMT-460 | A renomeação da política resulta em comportamento instável, política duplicada que não pode ser removida |
| DEVRT-1565 | Intervalos de 15 minutos para CHARGES |
| AXAPP-1728 | Ignorar variáveis de monetização na análise |
| AXAPP-1690 | "Erro de API inválido" em relatórios personalizados |
| AXAPP-1533 | O mapa geográfico de análise gera um erro de chamada de API inválida |
| APIRT-52 | Relatórios personalizados: o código de status de resposta para muitas APIs é nulo |