Você precisa fazer várias atualizações pequenas e não disruptivas em uma API existente hospedada no APIM. Requisitos: não interromper os chamadores existentes, ser capaz de reverter as alterações se necessário, fornecer documentação para desenvolvedores sobre as alterações e permitir testes antes da publicação. O que você deve fazer?

Adicionar uma nova revisão à API é a melhor abordagem porque permite fazer alterações na API sem afetar os chamadores existentes. As revisões fornecem um ambiente de teste isolado para as alterações, permitindo que você as valide antes de torná-las públicas. Se houver problemas, você pode reverter facilmente para uma revisão anterior. Além disso, as revisões permitem que você documente as alterações para os desenvolvedores, atendendo a todos os requisitos. O versionamento baseado em cabeçalho ou string de consulta criaria uma nova versão da API, o que interromperia os chamadores existentes, pois eles teriam que atualizar seus códigos para usar a nova versão. Criar um produto é para agrupar APIs e não para gerenciar alterações em uma API existente. Aplicar uma política personalizada é para modificar o comportamento da API, não para gerenciar suas versões ou revisões.