Compartilhar via

Alterações interruptivas em workspaces, parte 2 (março de 2025)

  • Artigo

APLICA-SE A: Premium

Importante

Essas alterações interruptivas se aplicam apenas a workspaces em versão prévia no Gerenciamento de API do Azure. Se você criou workspaces após a versão em disponibilidade geral de agosto de 2024 e usa workspaces com gateways de workspace, seus workspaces não devem ser afetados por essas alterações.

Os workspaces do Gerenciamento de API do Azure agora estão em disponibilidade geral, e introduzimos várias atualizações de recursos com essa versão. Como parte do nosso desenvolvimento contínuo de workspaces, estamos removendo o suporte para workspaces em versão prévia (criados antes de agosto de 2024). Se você criou workspaces em versão prévia no Gerenciamento de API do Azure e deseja continuar usando-os, você precisa migrar seus workspaces para a versão em disponibilidade geral associando um gateway de workspace a cada workspace.

Após 31 de março de 2025, seus workspaces em versão prévia e APIs gerenciadas neles poderão parar de funcionar se você não tiver migrado para as funcionalidades mais recentes do workspace. APIs e recursos gerenciados fora dos workspaces não são afetados por essa alteração.

Meu serviço é afetado por essas alterações?

Seu serviço poderá ser afetado por essas alterações se você tiver criado workspaces em versão prévia em sua instância de Gerenciamento de API, antes da versão em disponibilidade geral de workspaces em agosto de 2024. Workspaces criados após a data de lançamento em disponibilidade geral que usam gateways de workspace para runtime de API não são afetados pelas alterações interruptivas.

Alterações da falha

Veja as seguintes alterações interruptivas que exigem que você tome medidas para migrar seus workspaces em versão prévia para a versão em disponibilidade geral:

  • O gateway de API do workspace é necessário – cada workspace precisa ser associado a um gateway de API do workspace que isola o tráfego de runtime do workspace. Na versão prévia, os workspaces compartilharam um gateway com o serviço.
  • Não há suporte para identidades gerenciadas no nível do serviço – para aprimorar a segurança de workspaces, identidades gerenciadas atribuídas pelo sistema e atribuídas pelo usuário habilitadas no nível do serviço não podem ser usadas em workspaces. Atualmente, os recursos de Gerenciamento de API relacionados que dependem de identidades gerenciadas, como armazenar valores e certificados nomeados no Azure Key Vault e usar a política authentication-managed-identity, não são compatíveis com workspaces.

Observação

Essas alterações interruptivas se somam às alterações interruptivas de junho de 2024 para workspaces de versão prévia que foram anunciadas anteriormente.

Qual é o prezo para a mudança?

As alterações interruptivas serão impostas em workspaces de versão prévia 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 workspaces de versão prévia antes dessa data.

O que preciso fazer?

Se seus workspaces forem afetados por essas alterações, você precisará migrar seus workspaces para se alinhar com as funcionalidades em disponibilidade geral. As seções a seguir fornecem diretrizes sobre como migrar seus workspaces.

Usar a camada Premium para sua instância de Gerenciamento de API

Verifique se a instância de Gerenciamento de API está em execução na camada Premium para continuar usando workspaces. Conforme anunciado anteriormente, se sua instância estiver na camada Standard ou Developer, você precisará atualizar para a camada Premium.

Confirmar a região para sua instância

Adicionar um gateway de workspace a um workspace requer que o gateway esteja na mesma região que sua instância. Atualmente, há suporte para gateways de workspace em um subconjunto de regiões nas quais o Gerenciamento de API está disponível. As regiões compatíveis com gateways de workspace serão atualizadas ao longo do tempo.

Para determinar se um workspace em versão prévia está em uma região com suporte:

  1. No portal do Azure, navegue até a instância do Gerenciamento de API.
  2. No menu à esquerda, em APIs, selecione Workspaces e selecione um workspace.
  3. Se o workspace estiver em uma região que não dá suporte a gateways de workspace, você verá uma mensagem no portal semelhante a "Os workspaces estão atualmente indisponíveis na região do serviço de Gerenciamento de API".
    • Se você vir essa mensagem, poderá mover sua instância de Gerenciamento de API para uma região com suporte.
    • Se você não vir essa mensagem, seu workspace estará em uma região com suporte e poderá continuar a adicionar um gateway de workspace.

Adicionar um gateway de workspace ao seu workspace

Veja a seguir as etapas abreviadas para adicionar um gateway de workspace a um workspace. Para obter opções de rede de gateway, pré-requisitos e instruções detalhadas, confira Criar e gerenciar um workspace.

Observação

  • O gateway de workspace incorre em encargos adicionais. Para obter mais informações, consulte preço de Gerenciamento de API.
  • Estamos introduzindo a capacidade de associar vários workspaces a um gateway de workspace, ajudando as organizações a gerenciar APIs com workspaces a um custo menor. Esse recurso será distribuído a partir de dezembro de 2024 e talvez não esteja disponível para todos os serviços qualificados antes de janeiro. Saiba mais
  1. No portal do Azure, navegue até a instância do Gerenciamento de API.
  2. No menu à esquerda, em APIs, selecione Workspaces.
  3. Selecione um workspace.
  4. No menu à esquerda, em Implantação + infraestrutura, selecione Gateways>+ Adicionar.
  5. Conclua o assistente para criar um gateway. Atualmente, o provisionamento do gateway pode levar de vários minutos a até três horas ou mais.
  6. Depois que o gateway for provisionado, vá para a página Visão geral do gateway. Observe o valor do Nome do host do runtime. Use esse valor para atualizar os aplicativos cliente que chamam as APIs do workspace.
  7. Repita as etapas anteriores para seus workspaces restantes.

Atualizar aplicativos cliente para usar o novo nome do host do gateway

Depois de adicionar um gateway ao seu workspace, você precisa atualizar seus aplicativos cliente que chamam as APIs do workspace para usar o novo nome do host do gateway em vez do nome do host do gateway da instância de Gerenciamento de API.

Observação

Para ajudar você a migrar seus workspaces, as APIs em workspaces ainda podem ser acessadas em runtime até outubro de 2024 usando o nome do host do gateway da instância de Gerenciamento de API, mesmo que um gateway de workspace esteja associado a um workspace. É altamente recomendável que você conclua a migração antes desta data. Se os gateways de workspace estiverem configurados com acesso de entrada privado e acesso de saída privado, verifique se a conectividade com o gateway interno da instância de Gerenciamento de API também está protegida.

Atualizar dependências em identidades gerenciadas no nível do serviço

Se você estiver usando identidades gerenciadas no nível do serviço na configuração de entidades de workspace (por exemplo, valores nomeados ou certificados), será necessário atualizar as configurações. As etapas recomendadas variam, dependendo da entidade. Exemplo: atualize valores nomeados para usar valores secretos em vez de segredos armazenados no Azure Key Vault.

Ajuda e suporte

Em caso de dúvidas, fale com os especialistas da comunidade no Microsoft Q&A. Se tiver um plano de suporte e precisar de ajuda técnica, crie uma solicitação de suporte.

Mais informações

Conteúdo relacionado

Confira todas as próximas alterações interruptivas e as desativações de recursos.