Share via


Espaços de trabalho - mudanças recentes (junho de 2024)

APLICA-SE A: Desenvolvedor | Standard | Premium

Após 14 de junho de 2024, como parte do nosso desenvolvimento de espaços de trabalho (visualização) no Gerenciamento de API do Azure, estamos introduzindo várias alterações significativas.

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 dos espaços de trabalho não são afetados por essa alteração.

Meu serviço é afetado por essas 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 da falha

Analise as seguintes alterações de quebra para determinar se você precisa tomar uma ação:

Alterar para camadas de serviço suportadas

As seguintes camadas de serviço não oferecerão mais suporte a espaços de trabalho: Standard e Developer. Os espaços de trabalho estarão disponíveis na camada Premium .

Para obter disponibilidade nas camadas v2, consulte Camadas v2 do Gerenciamento de API do Azure.

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 terão mais suporte:

  • 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

    Observação

    Os grupos internos de Convidados e Desenvolvedores continuarão disponíveis nos espaços de trabalho.

Alterações em objetos de contexto com suporte

Os seguintes context objetos não terão mais suporte nas políticas de espaço de trabalho ou na política de todas as APIs no nível de serviço:

  • context.Api.Workspace
  • context.Product.Workspace

O context.Workspace objeto pode ser usado em vez disso.

Observação

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 prezo para a mudança?

As mudanças 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 preciso 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 se alinhar aos 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 da camada do desenvolvedor

A camada Desenvolvedor foi projetada para casos de uso de usuário único ou equipe única. Ele não é capaz 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 da camada Premium

    Embora a atualização de cada instância da camada Developer para a camada Premium seja uma opção, considere agregar vários ambientes que não são de produção em uma única instância da camada Premium. Use espaços de trabalho na camada Premium para isolar os diferentes ambientes.

  • Usar instâncias da camada de desenvolvedor para desenvolvimento, migrar 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 ter 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 do espaço de trabalho para uma instância da camada de desenvolvedor sem espaços de trabalho:

    1. Exporte um modelo do Gerenciador de Recursos de sua instância de Gerenciamento de API. Você pode exportar o modelo do portal do Azure ou usando outras ferramentas.
    2. Remova a seguinte subcadeia de caracteres dos valores de ID do recurso: /workspaces/[^/]+
    3. Implante 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 na 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 orientações sobre 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

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

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