Espaços de trabalho - alterações significativas (junho de 2024)
APLICA-SE A: Developer | Padrão | Prémio
Importante
Se você criou espaços de trabalho após a versão geralmente disponível dos espaços de trabalho em julho de 2024, seus espaços de trabalho não devem ser afetados por essas alterações.
Após 14 de junho de 2024, como parte do nosso desenvolvimento de espaços de trabalho no Gerenciamento de API do Azure, estamos introduzindo várias alterações de rutura.
Após 14 de junho de 2024, seus espaços de trabalho e APIs gerenciados neles podem parar de funcionar se ainda dependerem dos recursos definidos para serem alterados. 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ê configurou espaços de trabalho (visualização) em sua instância de Gerenciamento de API. Esse recurso foi introduzido nas camadas Premium, Standard e Developer.
Alterações interruptivas
Analise as seguintes alterações de quebra para determinar se você precisa tomar medidas:
Alterar para camadas de serviço suportadas
As seguintes camadas de serviço não suportarão mais espaços de trabalho: Standard e Developer. Os espaços de trabalho estarão disponíveis no nível Premium .
Para obter a disponibilidade nas camadas v2, consulte Azure API Management v2 tiers.
Alterações no suporte para atribuição de entidades de nível de serviço em espaços de trabalho
As seguintes atribuições de entidades de espaço de trabalho a entidades de nível de serviço não serão mais suportadas:
Atribuir APIs de espaço de trabalho a produtos de nível de serviço
Atribuir APIs de espaço de trabalho a tags de nível de serviço
Atribuir produtos de espaço de trabalho a tags de nível de serviço
Atribuir grupos de nível de serviço a produtos de espaço de trabalho para controles de visibilidade
Nota
Os grupos internos de Convidados e Desenvolvedores continuarão disponíveis nos espaços de trabalho.
Alterações em objetos de contexto suportados
Os seguintes context objetos não serão mais suportados nas políticas de espaço de trabalho ou na política de todas as APIs no nível de serviço:
context.Api.Workspacecontext.Product.Workspace
O context.Workspace objeto pode ser usado em vez disso.
Nota
Você pode continuar a fazer referência a usuários do nível de serviço no context objeto em políticas de nível de espaço de trabalho.
Qual o prazo para a mudança?
As alterações serão introduzidas após 14 de junho de 2024. É altamente recomendável que você faça todas as alterações necessárias na configuração dos espaços de trabalho antes dessa data.
O que necessito de fazer?
Se seus espaços de trabalho forem afetados por essas alterações, você precisará atualizar suas configurações de espaço de trabalho para alinhá-los com os novos recursos.
Clientes de nível padrão
Se você estiver usando espaços de trabalho na camada Padrão , atualize para a camada Premium para continuar usando espaços de trabalho.
Clientes de nível de desenvolvedor
A camada de desenvolvedor foi projetada para casos de uso de usuário único ou equipe única. É incapaz de facilitar a colaboração de várias equipes com espaços de trabalho devido aos recursos de computação limitados, à falta de SLA e à ausência de redundância de infraestrutura. Se você estiver usando a visualização de espaços de trabalho na camada Desenvolvedor , poderá escolher uma das seguintes opções:
Agregar em uma instância de camada Premium
Embora a atualização de cada instância da camada de desenvolvedor para a camada Premium seja uma opção, considere agregar vários ambientes que não sejam de produção em uma única instância de camada Premium. Use espaços de trabalho na camada Premium para isolar os diferentes ambientes.
Use instâncias da camada de desenvolvedor para desenvolvimento, migre para espaços de trabalho na camada Premium para produção
Você pode usar instâncias de camada de desenvolvedor para ambientes de desenvolvimento. Para ambientes superiores, você pode migrar a configuração de cada serviço de camada de desenvolvedor para um espaço de trabalho de um serviço de camada Premium, por exemplo, usando pipelines de CI/CD. Com essa abordagem, você pode encontrar problemas ou conflitos ao gerenciar as configurações entre ambientes.
Se você estiver usando espaços de trabalho em uma instância da camada de desenvolvedor, poderá migrar as configurações de espaço de trabalho para uma instância da camada de desenvolvedor sem espaços de trabalho:
- Exporte um modelo do Resource Manager da sua instância de Gerenciamento de API. Você pode exportar o modelo do portal do Azure ou usando outras ferramentas.
- Remova a seguinte substring dos valores de ID do recurso:
/workspaces/[^/]+ - Implemente o modelo. Para obter mais informações, consulte Guia de início rápido: criar e implantar modelos ARM usando o portal do Azure.
Dependendo do seu caso de uso, talvez seja necessário executar outras alterações de configuração em sua instância de Gerenciamento de API.
Atribuição de entidades no nível do espaço de trabalho
Se você atribuiu entidades de nível de espaço de trabalho a entidades de nível de serviço na visualização de espaços de trabalho, consulte a tabela a seguir para obter diretrizes de migração.
| A atribuição não é mais suportada | Etapa de migração recomendada |
|---|---|
| Atribuir APIs de espaço de trabalho a produtos de nível de serviço | Usar produtos no nível do espaço de trabalho |
| Atribuir APIs ou produtos de espaço de trabalho a tags de nível de serviço | Usar tags no nível do espaço de trabalho |
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.