Workspaces breaking changes, parte 2 (março de 2025)
APLICA-SE A: Premium
Importante
Essas alterações recentes se aplicam apenas a espaços de trabalho de visualização no Gerenciamento de API do Azure. Se você criou espaços de trabalho após a versão geralmente disponível em agosto de 2024 e usa espaços de trabalho com gateways de espaço de trabalho, seus espaços de trabalho não devem ser afetados por essas alterações.
Os espaços de trabalho de Gerenciamento de API do Azure agora estão disponíveis ao público em geral e introduzimos várias atualizações de recursos com essa versão. Como parte do nosso desenvolvimento contínuo de espaços de trabalho, estamos removendo o suporte para espaços de trabalho de visualização (criados antes de agosto de 2024). Se você criou espaços de trabalho de visualização no Gerenciamento de API do Azure e deseja continuar a usá-los, precisará migrar seus espaços de trabalho para a versão disponível em geral.
Após 31 de março de 2025, seus espaços de trabalho de visualização e APIs gerenciadas neles podem parar de funcionar se você não tiver migrado para os recursos de espaço de trabalho mais recentes. APIs e recursos gerenciados fora de espaços de trabalho não são afetados por essa alteração.
O meu serviço é afetado por estas alterações?
Seu serviço pode ser afetado por essas alterações se você criou espaços de trabalho de visualização em sua instância de Gerenciamento de API, antes da versão geralmente disponível dos espaços de trabalho em agosto de 2024. Os espaços de trabalho criados após a data de lançamento geralmente disponível que usam gateways de espaço de trabalho para o tempo de execução da API não são afetados pelas alterações de quebra.
Alterações interruptivas
A seguir estão as alterações significativas que exigem que você tome medidas para migrar seus espaços de trabalho de visualização para a versão disponível em geral:
- Gateway de API de espaço de trabalho é necessário - Cada espaço de trabalho deve ser associado a um gateway de API de espaço de trabalho que isola o tráfego de tempo de execução do espaço de trabalho. Na visualização, os espaços de trabalho compartilhavam um gateway com o serviço.
- Não há suporte para identidades gerenciadas de nível de serviço - Para melhorar a segurança dos espaços de trabalho, as identidades gerenciadas atribuídas pelo sistema e pelo usuário habilitadas no nível de serviço não podem ser usadas em espaços de trabalho. Atualmente, os recursos relacionados de Gerenciamento de API que dependem de identidades gerenciadas, como armazenar valores nomeados e certificados no Cofre de Chaves do Azure e usar a
authentication-managed-identitypolítica, não são suportados em espaços de trabalho.
Nota
Essas alterações significativas se somam às alterações de junho de 2024 para espaços de trabalho de visualização anunciadas anteriormente.
Qual o prazo para a mudança?
As alterações de quebra serão aplicadas em espaços de trabalho de visualização após 31 de março de 2025. É altamente recomendável que você faça todas as alterações necessárias na configuração de seus espaços de trabalho de visualização antes dessa data.
O que necessito de fazer?
Se seus espaços de trabalho forem afetados por essas alterações, você precisará migrá-los para alinhá-los com os recursos geralmente disponíveis. As seções a seguir fornecem orientação sobre como migrar seus espaços de trabalho.
Usar a camada Premium para sua instância de Gerenciamento de API
Verifique se sua instância de Gerenciamento de API está sendo executada na camada Premium para continuar usando espaços de trabalho. Conforme anunciado anteriormente, se sua instância estiver na camada Standard ou Developer , você precisará atualizar para a camada Premium .
Confirme a região da sua instância
Adicionar um gateway de espaço de trabalho a um espaço de trabalho requer que o gateway esteja na mesma região que sua instância. Atualmente, os gateways de espaço de trabalho são suportados em um subconjunto de regiões nas quais o Gerenciamento de API está disponível. As regiões com suporte para gateways de espaço de trabalho serão atualizadas ao longo do tempo.
Para determinar se um espaço de trabalho de visualização está em uma região suportada:
- No portal do Azure, navegue até sua instância de Gerenciamento de API.
- No menu à esquerda, em APIs, selecione Espaços de trabalho e selecione um espaço de trabalho.
- Se o seu espaço de trabalho estiver em uma região que não oferece suporte a gateways de espaço de trabalho, você verá uma mensagem no portal semelhante a "Os espaços de trabalho estão atualmente indisponíveis na região do seu serviço de Gerenciamento de API".
- Se você vir essa mensagem, poderá mover sua instância de Gerenciamento de API para uma região compatível.
- Se você não vir essa mensagem, seu espaço de trabalho está em uma região suportada e você pode continuar a adicionar um gateway de espaço de trabalho.
Adicionar um gateway de espaço de trabalho ao seu espaço de trabalho
A seguir estão as etapas abreviadas para adicionar um gateway de espaço de trabalho a um espaço de trabalho. Para opções de rede de gateway, pré-requisitos e instruções detalhadas, consulte Criar e gerenciar um espaço de trabalho.
Nota
- O gateway do espaço de trabalho incorre em custos adicionais. Para obter mais informações, consulte Preços do Gerenciamento de API.
- Estamos introduzindo a capacidade de associar vários espaços de trabalho a um gateway de espaço de trabalho, ajudando as organizações a gerenciar APIs com espaços de trabalho a um custo mais baixo. Este recurso está sendo implementado a partir de dezembro de 2024 e pode não estar disponível para todos os serviços qualificados antes de janeiro. Mais informações
- No portal do Azure, navegue até sua instância de Gerenciamento de API.
- No menu à esquerda, em APIs, selecione Espaços de trabalho.
- Selecione uma área de trabalho.
- No menu à esquerda, em Implantação + infraestrutura, selecione Gateways>+ Adicionar.
- Conclua o assistente para criar um gateway. Atualmente, o provisionamento do gateway pode levar de vários minutos a até 3 horas ou mais.
- Depois que o gateway for provisionado, vá para a página Visão geral do gateway. Observe o valor de Runtime hostname. Use esse valor para atualizar seus aplicativos cliente que chamam as APIs do seu espaço de trabalho.
- Repita as etapas anteriores para os espaços de trabalho restantes.
Atualizar aplicativos cliente para usar o novo nome de host do gateway
Depois de adicionar um gateway ao seu espaço de trabalho, você precisa atualizar seus aplicativos cliente que chamam as APIs do espaço de trabalho para usar o novo nome de host do gateway em vez do nome do host do gateway da sua instância de Gerenciamento de API.
Nota
Para ajudá-lo a migrar seus espaços de trabalho, as APIs em espaços de trabalho ainda podem ser acessadas em tempo de execução até outubro de 2024 usando o nome de host do gateway da sua instância de Gerenciamento de API, mesmo que um gateway de espaço de trabalho esteja associado a um espaço de trabalho. É altamente recomendável que você conclua a migração antes dessa data. Se os gateways de espaço de trabalho estiverem configurados com acesso de entrada privado e acesso de saída privado, certifique-se de que a conectividade com o gateway interno da instância de Gerenciamento de API também esteja protegida.
Atualizar dependências em identidades gerenciadas de nível de serviço
Se você estiver usando identidades gerenciadas de nível de serviço na configuração de entidades de espaço de trabalho (por exemplo, valores nomeados ou certificados), precisará atualizar as configurações. As etapas recomendadas variam de acordo com a entidade. Exemplo: atualize os valores nomeados para usar valores secretos em vez de segredos armazenados no Cofre da Chave do Azure.
Ajuda e suporte
Se ainda tem dúvidas, poderá esclarecê-las junto de especialistas da comunidade no Microsoft Q&A. Se tiver um plano de suporte e precisar de ajuda técnica, crie um pedido de suporte.
Mais informações
Conteúdos relacionados
Veja todas as próximas mudanças e desativações de recursos.