Configurare le funzionalità di anteprima nella sottoscrizione di Azure

Questo articolo illustra come gestire le funzionalità di anteprima nella sottoscrizione di Azure. Le funzionalità di anteprima consentono di usare nuove funzionalità prima del rilascio. Alcune funzionalità di anteprima sono disponibili per chiunque voglia provarle. Altre funzionalità di anteprima richiedono l'approvazione del team del prodotto.

Il controllo AFEC (Azure Feature Exposure Control) di Azure è disponibile tramite lo spazio dei nomi Microsoft.Features. Le funzionalità di anteprima hanno il formato seguente per l'ID risorsa:

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

Accesso obbligatorio

Per elencare, registrare o annullare la registrazione delle funzionalità di anteprima nella sottoscrizione di Azure, è necessario accedere alle azioni Microsoft.Features/*. Questa autorizzazione viene concessa tramite i ruoli predefiniti Collaboratore e Proprietario. È anche possibile specificare l'accesso necessario tramite un ruolo personalizzato.

Elencare le funzionalità di anteprima

È possibile elencare tutte le funzionalità di anteprima e i relativi stati di registrazione per una sottoscrizione di Azure.

Portale

Il portale mostra una funzionalità di anteprima solo quando il servizio proprietario della funzionalità ha esplicitamente acconsentito all'esperienza di gestione delle funzionalità di anteprima.

1. Accedere al portale di Azure.

2. Nella casella di ricerca immettere sottoscrizioni e selezionare Sottoscrizioni.

   

3. Selezionare il collegamento per il nome della sottoscrizione.

   

4. Nel menu a sinistra, in Impostazioni selezionare Funzionalità di anteprima.

   

5. Viene visualizzato un elenco delle funzionalità di anteprima disponibili e lo stato di registrazione corrente.

   

6. Da Funzionalità di anteprima è possibile filtrare l'elenco in base al nome, allo stato o al tipo:

   • Nome: deve contenere testo del nome della funzionalità di anteprima, non del nome visualizzato.
   • Stato: selezionare il menu a discesa e scegliere uno stato. Il portale non filtra in base a Registrazione annullata.
   • Tipo: selezionare il menu a discesa e scegliere un tipo.

   

Interfaccia della riga di comando di Azure

Per elencare tutte le funzionalità di anteprima della sottoscrizione, usare il comando az feature list.

L'output predefinito per l'interfaccia della riga di comando di Azure è JSON. Per altre informazioni su ulteriori formati di output, vedere Formati di output per i comandi dell'interfaccia della riga di comando di Azure.

az feature list

{
  "id": "/subscriptions/11111111-1111-1111-1111-111111111111/providers/Microsoft.Features/providers/
    Microsoft.Compute/features/InGuestPatchVMPreview",
  "name": "Microsoft.Compute/InGuestPatchVMPreview",
  "properties": {
    "state": "NotRegistered"
  },
  "type": "Microsoft.Features/providers/features"
}

Per filtrare l'output per un provider di risorse specifico, usare il parametro namespace. In questo esempio, il parametro output specifica un formato di tabella.

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

Per filtrare l'output per una funzionalità di anteprima specifica, usare il comando az feature show.

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

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

PowerShell

Per elencare tutte le funzionalità di anteprima della sottoscrizione, usare il 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

Per filtrare l'output per un provider di risorse specifico, usare il parametro ProviderNamespace. L'output predefinito mostra solo le funzionalità registrate. Per visualizzare tutte le funzionalità di anteprima per un provider di risorse, usare il parametro ListAvailable con il parametro 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

È possibile filtrare l'output per una funzionalità di anteprima specifica usando il parametro FeatureName.

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

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

Registrare la funzionalità di anteprima

Registrare una funzionalità di anteprima nella sottoscrizione di Azure per esporre altre funzionalità per un provider di risorse. Alcune funzionalità di anteprima richiedono l'approvazione.

Dopo la registrazione di una funzionalità di anteprima nella sottoscrizione, verrà visualizzato uno di due stati: Registrato o In sospeso.

• Per una funzionalità di anteprima che non richiede l'approvazione, lo stato è Registrato.
• Se una funzionalità di anteprima richiede l'approvazione, lo stato di registrazione è In sospeso. È necessario richiedere l'approvazione al servizio di Azure che offre la funzionalità di anteprima. In genere si richiede l'accesso tramite un ticket di supporto.
  • Per richiedere l'approvazione, inviare una richiesta di supporto di Azure.
  • Dopo l'approvazione della registrazione, lo stato della funzionalità di anteprima diventa Registrato.

Alcuni servizi richiedono altri metodi, ad esempio e-mail, per ottenere l'approvazione per la richiesta in sospeso. Controllare gli annunci relativi alla funzionalità di anteprima per informazioni su come ottenere l'accesso.

Portale

1. Accedere al portale di Azure.

2. Nella casella di ricerca immettere sottoscrizioni e selezionare Sottoscrizioni.

3. Selezionare il collegamento per il nome della sottoscrizione.

4. Nel menu a sinistra, in Impostazioni selezionare Funzionalità di anteprima.

5. Selezionare il collegamento per la funzionalità di anteprima che si vuole registrare.

6. Selezionare Registra.

   

7. Seleziona OK.

La schermata Funzionalità di anteprima verrà aggiornata e verrà visualizzato lo stato della funzionalità.

Interfaccia della riga di comando di Azure

Per registrare una funzionalità di anteprima, usare il comando az feature register.

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

{
  "id": "/subscriptions/11111111-1111-1111-1111-111111111111/providers/Microsoft.Features/providers/
    Microsoft.Compute/features/InGuestPatchVMPreview",
  "name": "Microsoft.Compute/InGuestPatchVMPreview",
  "properties": {
    "state": "Registering"
  },
  "type": "Microsoft.Features/providers/features"
}

Per visualizzare lo stato della registrazione, usare il comando az feature show.

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

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

Nota

Quando viene eseguito il comando register, viene visualizzato un messaggio che chiede di eseguire az provider register --namespace <provider-name> dopo la registrazione della funzionalità per propagare le modifiche.

PowerShell

Per registrare una funzionalità di anteprima, usare il cmdlet Register-AzProviderFeature.

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

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

Per visualizzare lo stato della registrazione, usare il cmdlet Get-AzProviderFeature.

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

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

Annullare la registrazione della funzionalità di anteprima

Al termine dell'uso di una funzionalità di anteprima, annullare la registrazione dalla sottoscrizione di Azure. È possibile notare due stati diversi dopo l'annullamento della registrazione della funzionalità. Se si annulla la registrazione tramite il portale, lo stato è impostato su Non registrato. Se si annulla la registrazione tramite l'interfaccia della riga di comando di Azure, PowerShell o l'API REST, lo stato è impostato su Registrazione annullata. Lo stato è diverso perché il portale elimina la registrazione della funzionalità, mentre i comandi annullano la registrazione. In entrambi i casi, la funzionalità non è più disponibile nella sottoscrizione. In entrambi i casi, è ancora possibile acconsentire esplicitamente alla funzionalità registrandola nuovamente.

Portale

È possibile annullare la registrazione delle funzionalità di anteprima da Funzionalità di anteprima. Lo stato cambia in Non registrato.

1. Accedere al portale di Azure.

2. Nella casella di ricerca immettere sottoscrizioni e selezionare Sottoscrizioni.

3. Selezionare il collegamento per il nome della sottoscrizione.

4. Nel menu a sinistra, in Impostazioni selezionare Funzionalità di anteprima.

5. Selezionare il collegamento per la funzionalità di anteprima per la quale si vuole annullare la registrazione.

6. Selezionare Annulla registrazione

   

7. Seleziona OK.

Interfaccia della riga di comando di Azure

Per annullare la registrazione di una funzionalità di anteprima, usare il comando az feature unregister. Lo stato RegistrationState cambia in Registrazione annullata.

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

{
  "id": "/subscriptions/11111111-1111-1111-1111-111111111111/providers/Microsoft.Features/providers/
    Microsoft.Compute/features/InGuestPatchVMPreview",
  "name": "Microsoft.Compute/InGuestPatchVMPreview",
  "properties": {
    "state": "Unregistering"
  },
  "type": "Microsoft.Features/providers/features"
}

Per visualizzare lo stato di annullamento della registrazione, usare il comando az feature show.

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

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

Nota

Quando viene eseguito il comando unregister, viene visualizzato un messaggio che chiede di eseguire az provider register --namespace <provider-name> dopo l'annullamento della registrazione della funzionalità per propagare le modifiche.

Per trovare le funzionalità di anteprima con registrazione annullata, usare il comando seguente. Sostituire <ResourceProvider.Name> con un nome di provider, ad esempio Microsoft.Compute.

Nell'esempio seguente viene visualizzata una funzionalità di anteprima con registrazione annullata per il provider di risorse 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

Per annullare la registrazione di una funzionalità di anteprima, usare il cmdlet Unregister-AzProviderFeature. Lo stato RegistrationState cambia in Registrazione annullata.

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

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

Per visualizzare lo stato di annullamento della registrazione, usare il cmdlet Get-AzProviderFeature.

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

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

Nell'esempio seguente viene visualizzata una funzionalità di anteprima con registrazione annullata per il provider di risorse Microsoft.Compute.

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

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

Configurazione delle funzionalità di anteprima tramite Criteri di Azure

Le sottoscrizioni possono essere corrette per la registrazione a una funzionalità di anteprima se non sono già state registrate usando una definizione di criteri predefinita. Si noti che le nuove sottoscrizioni aggiunte a un tenant esistente non verranno registrate automaticamente.

Passaggi successivi

• Per usare le chiamate API REST ed elencare, registrare o annullare la registrazione delle funzionalità di anteprima, vedere la documentazione Funzionalità.
• Per altre informazioni su come registrare un provider di risorse, vedere Provider e tipi di risorse di Azure.
• Per un elenco con il mapping dei provider di risorse ai servizi di Azure, vedere provider di risorse per i servizi di Azure.