Availability Sets - List

Servizio:: Compute

Versione API:: 2025-04-01

Elenca tutti i set di disponibilità in un gruppo di risorse.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets?api-version=2025-04-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	AvailabilitySetListResult	La richiesta è andata a buon fine.
Other Status Codes	CloudError	Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

AvailabilitySet_List_MaximumSet_Gen

AvailabilitySet_List_MinimumSet_Gen

AvailabilitySet_List_MaximumSet_Gen

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/availabilitySets?api-version=2025-04-01

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "name": "{availabilitySetName}",
      "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}",
      "type": "Microsoft.Compute/availabilitySets",
      "location": "australiasoutheast",
      "properties": {
        "platformUpdateDomainCount": 5,
        "platformFaultDomainCount": 3,
        "virtualMachines": [
          {
            "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}"
          }
        ],
        "proximityPlacementGroup": {
          "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}"
        },
        "statuses": [
          {
            "code": "aaaaaaaaaaaaaaa",
            "level": "Info",
            "displayStatus": "aaaaaaaaaaa",
            "message": "aaaaaa",
            "time": "2021-11-30T13:39:56.427Z"
          }
        ]
      },
      "sku": {
        "name": "Classic",
        "tier": "aaaaaaaaaaaaaaaaaaaaaaa",
        "capacity": 22
      },
      "tags": {
        "key2039": "aaaaaaaaaaaaa"
      }
    },
    {
      "name": "{availabilitySetName}",
      "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}",
      "type": "Microsoft.Compute/availabilitySets",
      "location": "australiasoutheast",
      "properties": {
        "platformUpdateDomainCount": 5,
        "platformFaultDomainCount": 3,
        "virtualMachines": [
          {
            "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}"
          }
        ],
        "proximityPlacementGroup": {
          "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}"
        },
        "statuses": [
          {
            "code": "aaaaaaaaaaaaaaa",
            "level": "Info",
            "displayStatus": "aaaaaaaaaaa",
            "message": "aaaaaa",
            "time": "2021-11-30T13:39:56.427Z"
          }
        ]
      },
      "sku": {
        "name": "Classic",
        "tier": "aaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "capacity": 23
      },
      "tags": {
        "key5849": "aaaaaaaaaaaaaaa"
      }
    },
    {
      "name": "{availabilitySetName}",
      "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}",
      "type": "Microsoft.Compute/availabilitySets",
      "location": "westcentralus",
      "tags": {},
      "properties": {
        "platformUpdateDomainCount": 5,
        "platformFaultDomainCount": 3,
        "virtualMachines": [],
        "proximityPlacementGroup": {
          "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}"
        },
        "statuses": [
          {
            "code": "aaaaaaaaaaaaaaa",
            "level": "Info",
            "displayStatus": "aaaaaaaaaaa",
            "message": "aaaaaa",
            "time": "2021-11-30T13:39:56.427Z"
          }
        ]
      },
      "sku": {
        "name": "Classic",
        "tier": "aaaaaaaaaaaaaaaaaaaaa",
        "capacity": 26
      }
    },
    {
      "name": "{availabilitySetName}",
      "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}",
      "type": "Microsoft.Compute/availabilitySets",
      "location": "westcentralus",
      "tags": {},
      "properties": {
        "platformUpdateDomainCount": 5,
        "platformFaultDomainCount": 3,
        "virtualMachines": [],
        "proximityPlacementGroup": {
          "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}"
        },
        "statuses": [
          {
            "code": "aaaaaaaaaaaaaaa",
            "level": "Info",
            "displayStatus": "aaaaaaaaaaa",
            "message": "aaaaaa",
            "time": "2021-11-30T13:39:56.427Z"
          }
        ]
      },
      "sku": {
        "name": "Classic",
        "tier": "aaaaaaaaaaaaaaaaaa",
        "capacity": 6
      }
    }
  ],
  "nextLink": "a://example.com/aaaaa"
}

AvailabilitySet_List_MinimumSet_Gen

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/availabilitySets?api-version=2025-04-01

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "location": "australiasoutheast",
      "id": "/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/availabilitySets/myAvailabilitySet1"
    },
    {
      "location": "australiasoutheast",
      "id": "/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/availabilitySets/myAvailabilitySet2"
    },
    {
      "location": "westcentralus",
      "id": "/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/availabilitySets/myAvailabilitySet3"
    },
    {
      "location": "westcentralus",
      "id": "/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/availabilitySets/myAvailabilitySet4"
    }
  ]
}

Definizioni

Nome	Descrizione
AllInstancesDown	Specifica se gli eventi pianificati devono essere approvati automaticamente quando tutte le istanze sono inattive.
ApiError	Errore API.
ApiErrorBase	Base di errore API.
AvailabilitySet	Specifica le informazioni sul set di disponibilità a cui deve essere assegnata la macchina virtuale. Le macchine virtuali specificate nello stesso set di disponibilità vengono allocate a nodi diversi per ottimizzare la disponibilità. Per altre informazioni sui set di disponibilità, vedere panoramica dei set di disponibilità . Per altre informazioni sulla manutenzione pianificata di Azure, vedere manutenzione e aggiornamenti di per le macchine virtuali in Azure. Attualmente, una macchina virtuale può essere aggiunta a un set di disponibilità solo in fase di creazione. Non è possibile aggiungere una macchina virtuale esistente a un set di disponibilità.
AvailabilitySetListResult	Risposta all'operazione List Availability Set.
CloudError	Risposta di errore dal servizio di calcolo.
createdByType	Tipo di identità che ha creato la risorsa.
DefaultVirtualMachineScaleSetInfo	Indica le proprietà del set di scalabilità di macchine virtuali di destinazione all'attivazione di una migrazione senza problemi senza tempi di inattività delle macchine virtuali tramite l'API ConvertToVirtualMachineScaleSet.
EventGridAndResourceGraph	Specifica le configurazioni correlate all'evento pianificato correlate a eventGridAndResourceGraph.
InnerError	Dettagli dell'errore interno.
InstanceViewStatus	Stato di visualizzazione dell'istanza.
ScheduledEventsAdditionalPublishingTargets
ScheduledEventsPolicy	Specifica le configurazioni relative agli eventi pianificati Redeploy, Reboot e ScheduledEventsAdditionalPublishingTargets.
Sku	Descrive uno SKU del set di scalabilità di macchine virtuali. NOTA: se il nuovo SKU della macchina virtuale non è supportato nell'hardware in cui è attualmente attivo il set di scalabilità, è necessario deallocare le macchine virtuali nel set di scalabilità prima di modificare il nome dello SKU.
StatusLevelTypes	Codice a livello.
SubResource
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
UserInitiatedReboot	Specifica le configurazioni relative all'evento pianificato relativo al riavvio.
UserInitiatedRedeploy	Specifica le configurazioni correlate all'evento pianificato relativo alla ridistribuzione.
VirtualMachineScaleSetMigrationInfo	Descrive le proprietà del set di disponibilità correlate alla migrazione al set di scalabilità di macchine virtuali flessibile.

AllInstancesDown

Oggetto

Specifica se gli eventi pianificati devono essere approvati automaticamente quando tutte le istanze sono inattive.

Nome	Tipo	Descrizione
automaticallyApprove	boolean	Specifica se gli eventi pianificati devono essere approvati automaticamente quando tutte le istanze sono inattive. Il valore predefinito è true

ApiError

Oggetto

Errore API.

Nome	Tipo	Descrizione
code	string	Codice di errore.
details	ApiErrorBase[]	Dettagli dell'errore Api
innererror	InnerError	L'errore interno dell'API
message	string	Messaggio di errore.
target	string	Destinazione dell'errore specifico.

ApiErrorBase

Oggetto

Base di errore API.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore specifico.

AvailabilitySet

Oggetto

Specifica le informazioni sul set di disponibilità a cui deve essere assegnata la macchina virtuale. Le macchine virtuali specificate nello stesso set di disponibilità vengono allocate a nodi diversi per ottimizzare la disponibilità. Per altre informazioni sui set di disponibilità, vedere panoramica dei set di disponibilità . Per altre informazioni sulla manutenzione pianificata di Azure, vedere manutenzione e aggiornamenti di per le macchine virtuali in Azure. Attualmente, una macchina virtuale può essere aggiunta a un set di disponibilità solo in fase di creazione. Non è possibile aggiungere una macchina virtuale esistente a un set di disponibilità.

Nome	Tipo	Descrizione
id	string	ID risorsa completo per la risorsa. Ad esempio: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Posizione geografica in cui risiede la risorsa
name	string	Nome della risorsa
properties.platformFaultDomainCount	integer (int32)	Numero di domini di errore.
properties.platformUpdateDomainCount	integer (int32)	Aggiornare il numero di domini.
properties.proximityPlacementGroup	SubResource	Specifica informazioni sul gruppo di posizionamento di prossimità a cui deve essere assegnato il set di disponibilità. Versione minima api: 2018-04-01.
properties.scheduledEventsPolicy	ScheduledEventsPolicy	Specifica le configurazioni correlate all'evento pianificato Ridistribuire, riavviare e ScheduledEventsAdditionalPublishingTargets per il set di disponibilità.
properties.statuses	InstanceViewStatus[]	Informazioni sullo stato della risorsa.
properties.virtualMachineScaleSetMigrationInfo	VirtualMachineScaleSetMigrationInfo	Vengono descritte le proprietà di migrazione nel set di disponibilità.
properties.virtualMachines	SubResource[]	Elenco di riferimenti a tutte le macchine virtuali nel set di disponibilità.
sku	Sku	Lo SKU del set di disponibilità è necessario impostare solo il nome. Per un set di valori possibile, vedere AvailabilitySetSkuTypes. Usare 'Aligned' per le macchine virtuali con dischi gestiti e 'Classic' per le macchine virtuali con dischi non gestiti. Il valore predefinito è 'Classic'.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
tags	object	Tag di risorsa.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

AvailabilitySetListResult

Oggetto

Risposta all'operazione List Availability Set.

Nome	Tipo	Descrizione
nextLink	string (uri)	URI per recuperare la pagina successiva di AvailabilitySets. Chiamare ListNext() con questo URI per recuperare la pagina successiva di AvailabilitySets.
value	AvailabilitySet[]	Elenco dei set di disponibilità.

CloudError

Oggetto

Risposta di errore dal servizio di calcolo.

Nome	Tipo	Descrizione
error	ApiError	Errore API.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

DefaultVirtualMachineScaleSetInfo

Oggetto

Indica le proprietà del set di scalabilità di macchine virtuali di destinazione all'attivazione di una migrazione senza problemi senza tempi di inattività delle macchine virtuali tramite l'API ConvertToVirtualMachineScaleSet.

Nome	Tipo	Descrizione
constrainedMaximumCapacity	boolean	Indica se la capacità massima del set di scalabilità di macchine virtuali di cui è stata eseguita la migrazione predefinita dopo la migrazione sarà limitata a un numero limitato di macchine virtuali.
defaultVirtualMachineScaleSet	SubResource	L'URI predefinito del set di scalabilità della macchina virtuale in cui verrà spostato il set di disponibilità dopo l'attivazione di una migrazione senza problemi tramite l'API ConvertToVirtualMachineScaleSet.

EventGridAndResourceGraph

Oggetto

Specifica le configurazioni correlate all'evento pianificato correlate a eventGridAndResourceGraph.

Nome	Tipo	Descrizione
enable	boolean	Specifica se griglia di eventi e grafico delle risorse è abilitato per le configurazioni correlate agli eventi pianificati.
scheduledEventsApiVersion	string	Specifica la versione dell'API per determinare quale versione dello schema di configurazione degli eventi pianificati verrà recapitata.

InnerError

Oggetto

Dettagli dell'errore interno.

Nome	Tipo	Descrizione
errordetail	string	Messaggio di errore interno o dump di eccezione.
exceptiontype	string	Tipo di eccezione.

InstanceViewStatus

Oggetto

Stato di visualizzazione dell'istanza.

Nome	Tipo	Descrizione
code	string	Codice di stato.
displayStatus	string	Etichetta localizzabile breve per lo stato.
level	StatusLevelTypes	Codice a livello.
message	string	Messaggio di stato dettagliato, inclusi gli avvisi e i messaggi di errore.
time	string (date-time)	Ora dello stato.

ScheduledEventsAdditionalPublishingTargets

Oggetto

Nome	Tipo	Descrizione
eventGridAndResourceGraph	EventGridAndResourceGraph	I parametri di configurazione usati durante la creazione dell'impostazione eventGridAndResourceGraph Scheduled Event.

ScheduledEventsPolicy

Oggetto

Specifica le configurazioni relative agli eventi pianificati Redeploy, Reboot e ScheduledEventsAdditionalPublishingTargets.

Nome	Tipo	Descrizione
allInstancesDown	AllInstancesDown	I parametri di configurazione utilizzati durante la creazione dell'impostazione dell'evento pianificato AllInstancesDown.
scheduledEventsAdditionalPublishingTargets	ScheduledEventsAdditionalPublishingTargets	Parametri di configurazione usati durante la pubblicazione scheduledEventsAdditionalPublishingTargets.
userInitiatedReboot	UserInitiatedReboot	I parametri di configurazione usati durante la creazione di un'impostazione evento pianificata userInitiatedReboot.
userInitiatedRedeploy	UserInitiatedRedeploy	I parametri di configurazione usati durante la creazione dell'impostazione dell'evento pianificata userInitiatedRedeploy.

Sku

Oggetto

Descrive uno SKU del set di scalabilità di macchine virtuali. NOTA: se il nuovo SKU della macchina virtuale non è supportato nell'hardware in cui è attualmente attivo il set di scalabilità, è necessario deallocare le macchine virtuali nel set di scalabilità prima di modificare il nome dello SKU.

Nome	Tipo	Descrizione
capacity	integer (int64)	Specifica il numero di macchine virtuali nel set di scalabilità.
name	string	Il nome SKU.
tier	string	Specifica il livello di macchine virtuali in un set di scalabilità. Valori possibili: Standard Basic

StatusLevelTypes

Enumerazione

Codice a livello.

Valore	Descrizione
Info
Warning
Error

SubResource

Oggetto

Nome	Tipo	Descrizione
id	string	ID risorsa

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

UserInitiatedReboot

Oggetto

Specifica le configurazioni relative all'evento pianificato relativo al riavvio.

Nome	Tipo	Descrizione
automaticallyApprove	boolean	Specifica le configurazioni correlate all'evento pianificato per il riavvio.

UserInitiatedRedeploy

Oggetto

Specifica le configurazioni correlate all'evento pianificato relativo alla ridistribuzione.

Nome	Tipo	Descrizione
automaticallyApprove	boolean	Specifica le configurazioni correlate all'evento pianificato ridistribuire.

VirtualMachineScaleSetMigrationInfo

Oggetto

Descrive le proprietà del set di disponibilità correlate alla migrazione al set di scalabilità di macchine virtuali flessibile.

Nome	Tipo	Descrizione
defaultVirtualMachineScaleSetInfo	DefaultVirtualMachineScaleSetInfo	Indica le proprietà del set di scalabilità di macchine virtuali di destinazione all'attivazione di una migrazione senza problemi senza tempi di inattività delle macchine virtuali tramite l'API ConvertToVirtualMachineScaleSet.
migrateToVirtualMachineScaleSet	SubResource	Specifica il set di scalabilità di macchine virtuali a cui viene eseguita la migrazione del set di disponibilità.

Condividi tramite

Availability Sets - List

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

AvailabilitySet_List_MaximumSet_Gen

Esempio di richiesta

Risposta di esempio

AvailabilitySet_List_MinimumSet_Gen

Esempio di richiesta

Risposta di esempio

Definizioni

AllInstancesDown

ApiError

ApiErrorBase

AvailabilitySet

AvailabilitySetListResult

CloudError

createdByType

DefaultVirtualMachineScaleSetInfo

EventGridAndResourceGraph

InnerError

InstanceViewStatus

ScheduledEventsAdditionalPublishingTargets

ScheduledEventsPolicy

Sku

StatusLevelTypes

SubResource

systemData

UserInitiatedReboot

UserInitiatedRedeploy

VirtualMachineScaleSetMigrationInfo