Availability Sets - List

Service:: Compute

Version d'API:: 2025-04-01

Répertorie tous les groupes à haute disponibilité d’un groupe de ressources.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string minLength: 1	ID de l’abonnement cible.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Réponses

Nom	Type	Description
200 OK	AvailabilitySetListResult	La demande a réussi.
Other Status Codes	CloudError	Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

AvailabilitySet_List_MaximumSet_Gen

AvailabilitySet_List_MinimumSet_Gen

AvailabilitySet_List_MaximumSet_Gen

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:: 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

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:: 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"
    }
  ]
}

Définitions

Nom	Description
AllInstancesDown	Spécifie si les événements planifiés doivent être approuvés automatiquement lorsque toutes les instances sont en panne.
ApiError	Erreur d’API.
ApiErrorBase	Base d’erreur de l’API.
AvailabilitySet	Spécifie des informations sur le groupe à haute disponibilité auquel la machine virtuelle doit être affectée. Les machines virtuelles spécifiées dans le même groupe à haute disponibilité sont allouées à différents nœuds pour optimiser la disponibilité. Pour plus d’informations sur les groupes à haute disponibilité, consultez vue d’ensemble des groupes à haute disponibilité. Pour plus d’informations sur la maintenance planifiée Azure, consultez Maintenance et mises à jour des machines virtuelles dans Azure. Actuellement, une machine virtuelle ne peut être ajoutée à un groupe à haute disponibilité qu’au moment de sa création. Impossible d’ajouter une machine virtuelle existante à un groupe à haute disponibilité.
AvailabilitySetListResult	Réponse de l’opération Liste de groupe à haute disponibilité.
CloudError	Réponse d’erreur du service de calcul.
createdByType	Type d’identité qui a créé la ressource.
DefaultVirtualMachineScaleSetInfo	Indique les propriétés du groupe de machines virtuelles identiques cible lors du déclenchement d’une migration transparente sans temps d’arrêt des machines virtuelles via l’API ConvertToVirtualMachineScaleSet.
EventGridAndResourceGraph	Spécifie les configurations liées aux événements planifiés associés à eventGridAndResourceGraph.
InnerError	Détails de l’erreur interne.
InstanceViewStatus	État de l’affichage de l’instance.
ScheduledEventsAdditionalPublishingTargets
ScheduledEventsPolicy	Spécifie les configurations liées aux événements planifiés Redeploy, Reboot et ScheduledEventsAdditionalPublishingTargets.
Sku	Décrit la référence SKU d’un groupe de machines virtuelles identiques. REMARQUE : Si la nouvelle référence SKU de machine virtuelle n’est pas prise en charge sur le matériel sur lequel le groupe identique est actuellement activé, vous devez libérer les machines virtuelles du groupe identique avant de modifier le nom de la référence SKU.
StatusLevelTypes	Code de niveau.
SubResource
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
UserInitiatedReboot	Spécifie les configurations liées aux événements planifiés liés au redémarrage.
UserInitiatedRedeploy	Spécifie les configurations liées aux événements planifiés associés au redéploiement.
VirtualMachineScaleSetMigrationInfo	Décrit les propriétés du groupe à haute disponibilité liées à la migration vers le groupe de machines virtuelles identiques flexibles.

AllInstancesDown

Objet

Spécifie si les événements planifiés doivent être approuvés automatiquement lorsque toutes les instances sont en panne.

Nom	Type	Description
automaticallyApprove	boolean	Spécifie si les événements planifiés doivent être approuvés automatiquement lorsque toutes les instances sont en panne. Sa valeur par défaut est true

ApiError

Objet

Erreur d’API.

Nom	Type	Description
code	string	Code d’erreur.
details	ApiErrorBase[]	Les détails de l’erreur Api
innererror	InnerError	L’erreur interne de l’API
message	string	Message d’erreur.
target	string	Cible de l’erreur particulière.

ApiErrorBase

Objet

Base d’erreur de l’API.

Nom	Type	Description
code	string	Code d’erreur.
message	string	Message d’erreur.
target	string	Cible de l’erreur particulière.

AvailabilitySet

Objet

Spécifie des informations sur le groupe à haute disponibilité auquel la machine virtuelle doit être affectée. Les machines virtuelles spécifiées dans le même groupe à haute disponibilité sont allouées à différents nœuds pour optimiser la disponibilité. Pour plus d’informations sur les groupes à haute disponibilité, consultez vue d’ensemble des groupes à haute disponibilité. Pour plus d’informations sur la maintenance planifiée Azure, consultez Maintenance et mises à jour des machines virtuelles dans Azure. Actuellement, une machine virtuelle ne peut être ajoutée à un groupe à haute disponibilité qu’au moment de sa création. Impossible d’ajouter une machine virtuelle existante à un groupe à haute disponibilité.

Nom	Type	Description
id	string	ID de ressource complet pour la ressource. ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Emplacement géographique où réside la ressource
name	string	Nom de la ressource
properties.platformFaultDomainCount	integer (int32)	Nombre de domaines d’erreur.
properties.platformUpdateDomainCount	integer (int32)	Mettre à jour le nombre de domaines.
properties.proximityPlacementGroup	SubResource	Spécifie des informations sur le groupe de placement de proximité auquel le groupe à haute disponibilité doit être affecté. Version minimale de l’API : 2018-04-01.
properties.scheduledEventsPolicy	ScheduledEventsPolicy	Spécifie les configurations liées au redéploiement, au redémarrage et à ScheduledEventsAdditionalPublishingTargets Scheduled Event pour le groupe à haute disponibilité.
properties.statuses	InstanceViewStatus[]	Informations d’état de la ressource.
properties.virtualMachineScaleSetMigrationInfo	VirtualMachineScaleSetMigrationInfo	Décrit les propriétés de migration sur le groupe à haute disponibilité.
properties.virtualMachines	SubResource[]	Liste des références à toutes les machines virtuelles du groupe à haute disponibilité.
sku	Sku	Référence SKU du groupe à haute disponibilité, seul le nom doit être défini. Consultez AvailabilitySetSkuTypes pour obtenir un ensemble de valeurs possible. Utilisez « Aligné » pour les machines virtuelles avec des disques managés et « Classic » pour les machines virtuelles avec des disques non managés. La valeur par défaut est « Classic ».
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
tags	object	Balises de ressource.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

AvailabilitySetListResult

Objet

Réponse de l’opération Liste de groupe à haute disponibilité.

Nom	Type	Description
nextLink	string (uri)	URI permettant d’extraire la page suivante des AvailabilitySets. Appelez ListNext() avec cet URI pour récupérer la page suivante des AvailabilitySets.
value	AvailabilitySet[]	La liste des groupes à haute disponibilité.

CloudError

Objet

Réponse d’erreur du service de calcul.

Nom	Type	Description
error	ApiError	Erreur d’API.

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

DefaultVirtualMachineScaleSetInfo

Objet

Indique les propriétés du groupe de machines virtuelles identiques cible lors du déclenchement d’une migration transparente sans temps d’arrêt des machines virtuelles via l’API ConvertToVirtualMachineScaleSet.

Nom	Type	Description
constrainedMaximumCapacity	boolean	Indique si la capacité maximale du groupe de machines virtuelles identiques migré par défaut après sa migration sera limitée à un nombre limité de machines virtuelles.
defaultVirtualMachineScaleSet	SubResource	URI de groupe de machines virtuelles identiques par défaut vers lequel le groupe à haute disponibilité sera déplacé lors du déclenchement d’une migration transparente via l’API ConvertToVirtualMachineScaleSet.

EventGridAndResourceGraph

Objet

Spécifie les configurations liées aux événements planifiés associés à eventGridAndResourceGraph.

Nom	Type	Description
enable	boolean	Spécifie si Event Grid et le graphique de ressources sont activés pour les configurations liées aux événements planifiés.
scheduledEventsApiVersion	string	Spécifie la version de l’API pour déterminer la version du schéma de configuration des événements planifiés qui sera livrée.

InnerError

Objet

Détails de l’erreur interne.

Nom	Type	Description
errordetail	string	Message d’erreur interne ou vidage d’exception.
exceptiontype	string	Type d’exception.

InstanceViewStatus

Objet

État de l’affichage de l’instance.

Nom	Type	Description
code	string	Code d’état.
displayStatus	string	Étiquette localisable courte pour l’état.
level	StatusLevelTypes	Code de niveau.
message	string	Message d’état détaillé, y compris pour les alertes et les messages d’erreur.
time	string (date-time)	Heure de l’état.

ScheduledEventsAdditionalPublishingTargets

Objet

Nom	Type	Description
eventGridAndResourceGraph	EventGridAndResourceGraph	Paramètres de configuration utilisés lors de la création du paramètre EventGridAndResourceGraph Scheduled Event.

ScheduledEventsPolicy

Objet

Spécifie les configurations liées aux événements planifiés Redeploy, Reboot et ScheduledEventsAdditionalPublishingTargets.

Nom	Type	Description
allInstancesDown	AllInstancesDown	Les paramètres de configuration utilisés lors de la création du paramètre d’événement planifié AllInstancesDown.
scheduledEventsAdditionalPublishingTargets	ScheduledEventsAdditionalPublishingTargets	Paramètres de configuration utilisés lors de la publication scheduledEventsAdditionalPublishingTargets.
userInitiatedReboot	UserInitiatedReboot	Paramètres de configuration utilisés lors de la création du paramètre d’événement planifié userInitiatedReboot.
userInitiatedRedeploy	UserInitiatedRedeploy	Paramètres de configuration utilisés lors de la création du paramètre d’événement planifié userInitiatedRedeploy.

Sku

Objet

Décrit la référence SKU d’un groupe de machines virtuelles identiques. REMARQUE : Si la nouvelle référence SKU de machine virtuelle n’est pas prise en charge sur le matériel sur lequel le groupe identique est actuellement activé, vous devez libérer les machines virtuelles du groupe identique avant de modifier le nom de la référence SKU.

Nom	Type	Description
capacity	integer (int64)	Spécifie le nombre de machines virtuelles dans le groupe identique.
name	string	Nom de la référence SKU.
tier	string	Spécifie le niveau des machines virtuelles dans un groupe identique. Valeurs possibles : Standard Basic

StatusLevelTypes

Énumération

Code de niveau.

Valeur	Description
Info
Warning
Error

SubResource

Objet

Nom	Type	Description
id	string	ID de ressource

systemData

Objet

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

UserInitiatedReboot

Objet

Spécifie les configurations liées aux événements planifiés liés au redémarrage.

Nom	Type	Description
automaticallyApprove	boolean	Spécifie les configurations liées aux événements planifiés de redémarrage.

UserInitiatedRedeploy

Objet

Spécifie les configurations liées aux événements planifiés associés au redéploiement.

Nom	Type	Description
automaticallyApprove	boolean	Spécifie les configurations liées au redéploiement des événements planifiés.

VirtualMachineScaleSetMigrationInfo

Objet

Décrit les propriétés du groupe à haute disponibilité liées à la migration vers le groupe de machines virtuelles identiques flexibles.

Nom	Type	Description
defaultVirtualMachineScaleSetInfo	DefaultVirtualMachineScaleSetInfo	Indique les propriétés du groupe de machines virtuelles identiques cible lors du déclenchement d’une migration transparente sans temps d’arrêt des machines virtuelles via l’API ConvertToVirtualMachineScaleSet.
migrateToVirtualMachineScaleSet	SubResource	Spécifie le groupe de machines virtuelles identiques vers lequel le groupe à haute disponibilité est migré.

Partager via

Availability Sets - List

Paramètres URI

Réponses

Sécurité

azure_auth

Étendues

Exemples

AvailabilitySet_List_MaximumSet_Gen

Exemple de requête

Exemple de réponse

AvailabilitySet_List_MinimumSet_Gen

Exemple de requête

Exemple de réponse

Définitions

AllInstancesDown

ApiError

ApiErrorBase

AvailabilitySet

AvailabilitySetListResult

CloudError

createdByType

DefaultVirtualMachineScaleSetInfo

EventGridAndResourceGraph

InnerError

InstanceViewStatus

ScheduledEventsAdditionalPublishingTargets

ScheduledEventsPolicy

Sku

StatusLevelTypes

SubResource

systemData

UserInitiatedReboot

UserInitiatedRedeploy

VirtualMachineScaleSetMigrationInfo