Configurar versão prévia do recurso na assinatura do Azure

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 que ela seja liberada. 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:

Microsoft.Features/providers/{resourceProviderNamespace}/features/{featureName}

Acesso necessário

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.

Portal

O portal mostra apenas uma versão prévia do recurso quando o serviço proprietário do recurso tiver optado explicitamente pela experiência de gerenciamento das versões prévias do recurso.

1. Entre no portal do Azure.

2. Na caixa de pesquisa, insira assinaturas e selecione Assinaturas.

   

3. Selecione o link para o nome da sua assinatura.

   

4. No menu esquerdo, em Configurações, selecione Versões prévias do recurso.

   

5. Você verá uma lista de versões prévias dos recursos disponíveis e seu status de registro atual.

   

6. Nas Versões prévias dos recursos você pode filtrar a lista por Nome, Estado ou Tipo:

   • Filtrar por nome: deve conter o texto do nome da versão prévia do recurso, e não o Nome de exibição.
   • Estado: selecione o menu suspenso e escolha o estado. O portal não filtra por Não registrado.
   • Tipo: selecione o menu suspenso e escolha um tipo.

   

CLI do Azure

Para listar todas as versões prévias dos recursos da assinatura, use o comando az feature list.

A saída padrão para a CLI do Azure é JSON. Para obter mais informações sobre formatos de saída, confira Formatos de saída para comandos da CLI do Azure.

az feature list

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Features/providers/
    Microsoft.Compute/features/InGuestPatchVMPreview",
  "name": "Microsoft.Compute/InGuestPatchVMPreview",
  "properties": {
    "state": "NotRegistered"
  },
  "type": "Microsoft.Features/providers/features"
}

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

Name                                                RegistrationState
-------------------------------------------------   -------------------
Microsoft.Compute/AHUB                              Unregistered
Microsoft.Compute/AllowManagedDisksReplaceOSDisk    Registered
Microsoft.Compute/AllowPreReleaseRegions            Pending
Microsoft.Compute/InGuestPatchVMPreview             NotRegistered

Para filtrar a saída para uma versão prévia do recurso específica, use o comando az feature show.

az feature show --name InGuestPatchVMPreview --namespace Microsoft.Compute --output table

Name                                     RegistrationState
---------------------------------------  -------------------
Microsoft.Compute/InGuestPatchVMPreview  NotRegistered

PowerShell

Para listar todas as versões prévias dos recursos da assinatura, use o cmdlet Get-AzProviderFeature.

Get-AzProviderFeature -ListAvailable

FeatureName      ProviderName     RegistrationState
-----------      ------------     -----------------
betaAccess       Microsoft.AAD    NotRegistered
previewAccess    Microsoft.AAD    Registered
tipAccess        Microsoft.AAD    Pending
testAccess       Microsoft.AAD    Unregistered

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.

Get-AzProviderFeature -ProviderNamespace "Microsoft.Compute" -ListAvailable

FeatureName                          ProviderName        RegistrationState
-----------                          ------------        -----------------
AHUB                                 Microsoft.Compute   Unregistered
AllowManagedDisksReplaceOSDisk       Microsoft.Compute   Registered
AllowPreReleaseRegions               Microsoft.Compute   Pending
InGuestPatchVMPreview                Microsoft.Compute   NotRegistered

Você pode filtrar a saída para uma versão prévia do recurso específica usando o parâmetro FeatureName.

Get-AzProviderFeature -FeatureName "InGuestPatchVMPreview" -ProviderNamespace "Microsoft.Compute"

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   NotRegistered

Registrar a versão prévia do recurso

Registre uma versão prévia do recurso em sua assinatura do Azure para expor mais funcionalidades para um provedor de recursos. Algumas versões prévias dos recursos exigem aprovação.

Depois que uma versão prévia do recurso for registrada 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.
  • Para solicitar aprovação, envie uma Solicitação de Suporte do Azure.
  • 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 a solicitação pendente. Verifique os anúncios sobre a versão prévia do recurso para ver informações sobre como obter acesso.

Portal

1. Entre no portal do Azure.

2. Na caixa de pesquisa, insira assinaturas e selecione Assinaturas.

3. Selecione o link para o nome da sua assinatura.

4. No menu esquerdo, em Configurações, selecione Versões prévias do recurso.

5. Selecione o link para a versão prévia do recurso que você deseja registrar.

6. Selecione Registrar.

   

7. Selecione OK.

A tela Versões prévias do recurso atualiza e o Estado da versão prévia do recurso é exibida.

CLI do Azure

Para registrar uma versão prévia do recurso, use o comandoaz feature register.

az feature register --name InGuestPatchVMPreview --namespace Microsoft.Compute

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Features/providers/
    Microsoft.Compute/features/InGuestPatchVMPreview",
  "name": "Microsoft.Compute/InGuestPatchVMPreview",
  "properties": {
    "state": "Registering"
  },
  "type": "Microsoft.Features/providers/features"
}

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 o comando register é executado, uma mensagem é exibida e, depois que o recurso é registrado, executa az provider register --namespace <provider-name> para propagar as alterações.

PowerShell

Para registrar uma versão prévia do recurso, use o cmdlet Register-AzProviderFeature.

Register-AzProviderFeature -FeatureName "InGuestPatchVMPreview" -ProviderNamespace "Microsoft.Compute"

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   Registering

Para exibir o status do registro, use o cmdlet Get-AzProviderFeature.

Get-AzProviderFeature -FeatureName "InGuestPatchVMPreview" -ProviderNamespace "Microsoft.Compute"

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   Registered

Cancelar o registro da versão prévia do recurso

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á definido como Não registrado. Se você cancelar o registro por meio do CLI do Azure, do PowerShell ou da API REST, o status será definido como 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. Em ambos os casos, você pode aceitar o recurso novamente registrando-o novamente.

Portal

Você pode cancelar o registro das versões prévias do recurso em Versões prévias dos recursos. O Estado muda para Não registrado.

1. Entre no portal do Azure.

2. Na caixa de pesquisa, insira assinaturas e selecione Assinaturas.

3. Selecione o link para o nome da sua assinatura.

4. No menu esquerdo, em Configurações, selecione Versões prévias do recurso.

5. Selecione o link para a versão prévia do recurso cujo registro você deseja cancelar.

6. Selecione Cancelar registro.

   

7. Selecione OK.

CLI do Azure

Para cancelar o registro de uma versão prévia do recurso, use o comando az feature unregister. O estado RegistrationState muda para Não registrado.

az feature unregister --name InGuestPatchVMPreview --namespace Microsoft.Compute

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Features/providers/
    Microsoft.Compute/features/InGuestPatchVMPreview",
  "name": "Microsoft.Compute/InGuestPatchVMPreview",
  "properties": {
    "state": "Unregistering"
  },
  "type": "Microsoft.Features/providers/features"
}

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 o comando de cancelamento de registro é executado, uma mensagem é exibida e, depois que o registro do recurso é cancelado, executa az provider register --namespace <provider-name> 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

PowerShell

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.

Unregister-AzProviderFeature -FeatureName "InGuestPatchVMPreview" -ProviderNamespace "Microsoft.Compute"

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   Unregistering

Para exibir o status do cancelamento do registro, use o cmdlet Get-AzProviderFeature.

Get-AzProviderFeature -FeatureName "InGuestPatchVMPreview" -ProviderNamespace "Microsoft.Compute"

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   Unregistered

O exemplo a seguir mostra uma versão prévia do recurso Não registrada para o provedor de recursos Microsoft.Compute.

Get-AzProviderFeature  -ProviderNamespace "Microsoft.Compute" -ListAvailable | Where-Object { $_.RegistrationState -eq "Unregistered" }

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   Unregistered

Configurando as versões prévias do recurso usando o Azure Policy

As assinaturas podem ser corrigidas para se registrarem em uma versão prévia do recurso se ainda não estiverem registradas usando uma definição de política interna. Observe que novas assinaturas adicionadas a um locatário existente não serã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.
• Para saber mais sobre como registrar um provedor de recursos, confira Tipos e provedores de recursos do Azure.
• Para obter uma lista que mapeia os provedores de recursos para os serviços do Azure, confira Provedores de recursos para os serviços do Azure.