Partilhar via


Tutorial: Use revisões para fazer alterações ininterruptas na API com segurança

APLICA-SE A: Todas as camadas de gerenciamento de API

Quando sua API estiver pronta para uso e for usada por desenvolvedores, você eventualmente precisará fazer alterações nessa API e, ao mesmo tempo, não interromper os chamadores de sua API. É também útil dar a conhecer aos programadores as alterações que efetuou.

No Gerenciamento de API do Azure, use revisões para fazer alterações de API ininterruptas para que você possa modelar e testar as alterações com segurança. Quando estiver pronto, você poderá fazer uma revisão atual e substituir sua API atual.

Para obter informações detalhadas, consulte Versões e revisões.

Neste tutorial, irá aprender a:

  • Adicionar uma nova revisão
  • Fazer alterações ininterruptas na sua revisão
  • Tornar a revisão atual e adicionar uma entrada de registo de alterações
  • Navegar até ao portal do programador para ver as alterações e o registo de alterações
  • Acessar uma revisão da API

Captura de ecrã das revisões da API no portal do Azure.

Pré-requisitos

Adicionar uma nova revisão

  1. Entre no portal do Azure e vá para sua instância de Gerenciamento de API.

  2. No menu à esquerda, em APIs, selecione APIs.

  3. Selecione API de conferência de demonstração na lista de APIs (ou outra API à qual você deseja adicionar revisões).

  4. Selecione a guia Revisões .

  5. Selecione + Adicionar revisão.

    Captura de tela da adição de uma revisão de API no portal.

    Gorjeta

    Você também pode selecionar Adicionar revisão no menu de contexto (...) da API.

  6. Forneça uma descrição para a sua nova revisão, para ajudar a lembrar para que ela é usada.

  7. Selecione Criar.

  8. A sua nova revisão está agora criada.

    Nota

    A API original permanece em Revisão 1. Trata-se da revisão que os utilizadores continuam a chamar, até optar por tornar uma revisão diferente atual.

Fazer alterações ininterruptas na sua revisão

  1. Selecione Demo Conference API na lista de APIs.

  2. Selecione o separador Estrutura junto à parte superior do ecrã.

  3. Tenha em atenção que o seletor de revisões (diretamente acima do separador de estrutura) mostra a Revisão 2 como atualmente selecionada.

    Gorjeta

    Utilize o seletor de revisões para alternar entre revisões em que quer trabalhar.

  4. Selecione + Adicionar Operação.

  5. Defina sua nova operação como POST e o Nome para exibição, Nome e URL da operação como teste.

  6. Guarde a nova operação.

    Captura de tela mostrando como adicionar uma operação em uma revisão no portal.

  7. Agora você fez uma alteração na Revisão 2. Use o seletor de revisão na parte superior da página para voltar para a Revisão 1.

  8. Observe que sua nova operação não aparece na Revisão 1.

Tornar a revisão atual e adicionar uma entrada de registo de alterações

  1. Selecione o separador Revisões no menu junto à parte superior da página.

  2. Abra o menu de contexto (...) para Revisão 2.

  3. Selecione Tornar atual.

  4. Marque a caixa de seleção Publicar no log de alterações públicas para esta API , se quiser postar anotações sobre essa alteração. Forneça uma descrição para sua alteração que os desenvolvedores possam ver, por exemplo: Revisões de teste. Adicionada nova operação de "teste".

  5. Revisão 2 é agora atual.

    Captura de ecrã do menu de revisão na janela Revisões no portal.

Navegar até ao portal do programador para ver as alterações e o registo de alterações

Se você já tentou o portal do desenvolvedor, você pode revisar as alterações da API e o log de alterações lá.

  1. No portal do Azure, navegue até sua instância de Gerenciamento de API.
  2. No menu à esquerda, em APIs, selecione APIs.
  3. Selecione Portal do desenvolvedor no menu superior.
  4. No portal do desenvolvedor, selecione APIs e, em seguida, selecione API de conferência de demonstração.
  5. Tenha em atenção que a nova operação test está agora disponível.
  6. Selecione Changelog perto do nome da API.
  7. Observe que sua entrada de log de alterações aparece na lista.

Acessar uma revisão da API

Cada revisão da sua API pode ser acessada usando uma URL especialmente formada. Adicione ;rev={revisionNumber} no final do caminho da URL da API, mas antes da cadeia de caracteres de consulta, para acessar uma revisão específica dessa API. Por exemplo, você pode usar essa URL para acessar a revisão 2 da API de conferência de demonstração:

https://apim-hello-world.azure-api.net/conf;rev=2/speakers

Você pode encontrar os caminhos de URL para as revisões da sua API na guia Revisões no portal do Azure.

Captura de ecrã dos URLs de revisão no portal.

Gorjeta

Você pode acessar a revisão atual da API usando o caminho da API sem a ;rev cadeia de caracteres, além da URL completa que acrescenta ao caminho da ;rev={revisionNumber} API.

Resumo

Neste tutorial, ficou a saber como:

  • Adicionar uma nova revisão
  • Fazer alterações ininterruptas na sua revisão
  • Tornar a revisão atual e adicionar uma entrada de registo de alterações
  • Navegar até ao portal do programador para ver as alterações e o registo de alterações
  • Acessar uma revisão da API

Próximos passos

Avance para o tutorial seguinte: