Configurar versão prévia do recurso na assinatura do Azure
Artigo
Este artigo mostra como gerenciar as versões prévias do recurso em sua assinatura do Azure. As versões prévias dos recursos permitem que você opte pela nova funcionalidade antes do lançamento. Algumas versões prévias dos recursos estão disponíveis para qualquer pessoa que queira aceitar. Outras versões prévias dos recursos exigem aprovação da equipe do produto.
O Controle de Exposição de Recursos do Azure (AFEC) está disponível pelo namespace Microsoft.Features. As versões prévias dos recursos têm o seguinte formato para a ID do recurso:
Para listar, registrar ou cancelar o registro de versões prévias dos recursos em sua assinatura do Azure, você precisa ter acesso às ações Microsoft.Features/*. Essa permissão é concedida por meio das funções internas Colaborador e Proprietário. Você também pode especificar o acesso necessário por meio de uma função personalizada.
Listar as versões prévias dos recursos
Você pode listar todas as versões prévias dos recursos e seus estados de registro para uma assinatura do Azure.
O portal mostra apenas uma versão prévia do recurso quando o serviço proprietário do recurso opta explicitamente pela experiência de gerenciamento das versões prévias do recurso. Se o recurso que você procura não aparecer na lista disponível, recomendamos o uso da CLI do Azure e do Azure Powershell.
Para filtrar a saída para um provedor de recursos específico, use o parâmetro namespace. Neste exemplo, o parâmetro output especifica um formato de tabela.
az feature list --namespace Microsoft.Compute --output table
Para filtrar a saída para um provedor de recursos específico, use o parâmetro ProviderNamespace. A saída padrão mostra apenas os recursos registrados. Para exibir todas as versões prévias dos recursos, use o parâmetro ListAvailable com o parâmetro ProviderNamespace.
Para expor mais funcionalidades para um provedor de recursos, registre uma versão prévia do recurso em sua assinatura do Azure. Algumas versões prévias dos recursos exigem aprovação.
Depois de registrar uma versão prévia do recurso em sua assinatura, você verá um dos dois estados: Registrado ou Pendente.
Para uma versão prévia do recurso que não requer aprovação, o estado é Registrado.
Se uma versão prévia do recurso exigir aprovação, o estado de registro estará Pendente. Você deve solicitar aprovação do serviço do Azure que oferece a versão prévia do recurso. Normalmente, você solicita acesso usando um tíquete de suporte.
Depois que o registro é aprovado, o estado da versão prévia do recurso é alterado para Registrado.
Alguns serviços exigem outros métodos, como email, para obter aprovação para as solicitações pendentes. Verifique os anúncios sobre a versão prévia do recurso para ver informações sobre como obter acesso.
Para exibir o status do registro, use o comando az feature show.
az feature show --name InGuestPatchVMPreview --namespace Microsoft.Compute --output table
Name RegistrationState
--------------------------------------- -------------------
Microsoft.Compute/InGuestPatchVMPreview Registered
Observação
Quando você executa o comando de registro, ele retorna uma mensagem que sugere a execução de az provider register --namespace <provider-name> depois que o recurso é registrado para propagar as alterações.
Quando você terminar de usar uma versão prévia do recurso, cancele o registro de sua assinatura do Azure. Você pode observar dois status diferentes depois de cancelar o registro do recurso. Se você cancelar o registro por meio do portal, o status será Não registrado. Se você cancelar o registro por meio do CLI do Azure, do PowerShell ou da API REST, o status será Não registrado. O status é diferente porque o portal exclui o registro do recurso, mas os comandos cancelam o registro do recurso. Em ambos os casos, o recurso não está mais disponível em sua assinatura. Você pode aceitar o recurso novamente registrando-o novamente.
Para exibir o status do cancelamento do registro, use o comando az feature show.
az feature show --name InGuestPatchVMPreview --namespace Microsoft.Compute --output table
Name RegistrationState
--------------------------------------- -------------------
Microsoft.Compute/InGuestPatchVMPreview Unregistered
Observação
Quando você executa o comando cancelar o registro, ele retorna uma mensagem que sugere a execução de az provider register --namespace <provider-name> depois que o recurso é registrado para propagar as alterações.
Para encontrar versões prévias dos recursos Não registradas, use o comando a seguir. Substitua <ResourceProvider.Name> com um nome de provedor como Microsoft.Compute.
O exemplo a seguir mostra uma versão prévia do recurso Não registrada para o provedor de recursos Microsoft.Compute.
az feature list --namespace <ResourceProvider.Name> --query "[?properties.state=='Unregistered'].{Name:name, RegistrationState:properties.state}" --output table
Name RegistrationState
--------------------------------------- -------------------
Microsoft.Compute/InGuestPatchVMPreview Unregistered
Para cancelar o registro de uma versão prévia do recurso, use o cmdlet Unregister-AzProviderFeature. O estado RegistrationState muda para Não registrado.
Configurando as versões prévias do recurso usando o Azure Policy
Você pode corrigir assinaturas para se registrar uma versão prévia do recurso se elas ainda não estiverem registradas usando uma definição de política interna. Quando você adiciona novas assinaturas a um locatário existente, elas não são registradas automaticamente.
Próximas etapas
Para usar a API REST e listar, registrar ou cancelar registros de versões prévias dos recursos, confira a documentação de Recursos.