Freigeben über


Availability Sets - List

Listet alle Verfügbarkeitsgruppen in einer Ressourcengruppe auf.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

subscriptionId
path True

string

minLength: 1

Hierbei handelt es sich um die ID des Zielabonnements.

api-version
query True

string

minLength: 1

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Antworten

Name Typ Beschreibung
200 OK

AvailabilitySetListResult

Die Anforderung war erfolgreich.

Other Status Codes

CloudError

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

AvailabilitySet_List_MaximumSet_Gen
AvailabilitySet_List_MinimumSet_Gen

AvailabilitySet_List_MaximumSet_Gen

Beispielanforderung

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

Beispiel für eine Antwort

{
  "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

Beispielanforderung

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

Beispiel für eine Antwort

{
  "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"
    }
  ]
}

Definitionen

Name Beschreibung
AllInstancesDown

Gibt an, ob geplante Ereignisse automatisch genehmigt werden sollen, wenn alle Instanzen ausgefallen sind.

ApiError

API-Fehler.

ApiErrorBase

API-Fehlerbasis.

AvailabilitySet

Gibt Informationen zum Verfügbarkeitssatz an, dem der virtuelle Computer zugewiesen werden soll. Virtuelle Computer, die in der gleichen Verfügbarkeitsgruppe angegeben sind, werden verschiedenen Knoten zugewiesen, um die Verfügbarkeit zu maximieren. Weitere Informationen zu Verfügbarkeitssätzen finden Sie unter Übersicht über Verfügbarkeitssätze. Weitere Informationen zur geplanten Wartung von Azure finden Sie unter Wartung und Updates für virtuelle Computer in Azure. Derzeit kann ein virtueller Computer nur zur Erstellungszeit zu einer Verfügbarkeitsgruppe hinzugefügt werden. Eine vorhandene VM kann keinem Verfügbarkeitssatz hinzugefügt werden.

AvailabilitySetListResult

Die Antwort des Vorgangs "Verfügbarkeitsgruppe auflisten".

CloudError

Eine Fehlerantwort vom Compute-Dienst.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

DefaultVirtualMachineScaleSetInfo

Gibt die Zieleigenschaften des Virtual Machine ScaleSet an, wenn eine nahtlose Migration ohne Ausfallzeiten der VMs über die ConvertToVirtualMachineScaleSet-API ausgelöst wird.

EventGridAndResourceGraph

Gibt eventGridAndResourceGraph-bezogene Konfigurationen im Zusammenhang mit geplanten Ereignissen an.

InnerError

Innere Fehlerdetails.

InstanceViewStatus

Instanzansichtsstatus.

ScheduledEventsAdditionalPublishingTargets
ScheduledEventsPolicy

Gibt die Konfigurationen "Redeploy", "Reboot" und "ScheduledEventsAdditionalPublishingTargets" an, die sich auf geplante Ereignisse beziehen.

Sku

Beschreibt eine SKU für VM-Skalierungsgruppen. HINWEIS: Wenn die neue VM-SKU auf der Hardware, auf der der Skalierungssatz derzeit installiert ist, nicht unterstützt wird, müssen Sie die virtuellen Computer im Skalierungssatz umstellen, bevor Sie den SKU-Namen ändern.

StatusLevelTypes

Der Ebenencode.

SubResource
systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

UserInitiatedReboot

Gibt Konfigurationen im Zusammenhang mit dem Neustart von geplanten Ereignissen an.

UserInitiatedRedeploy

Gibt an, dass Konfigurationen im Zusammenhang mit geplanten Ereignissen erneut bereitgestellt werden.

VirtualMachineScaleSetMigrationInfo

Beschreibt die Eigenschaften der Verfügbarkeitsgruppe im Zusammenhang mit der Migration zu einer flexiblen VM-Skalierungsgruppe.

AllInstancesDown

Gibt an, ob geplante Ereignisse automatisch genehmigt werden sollen, wenn alle Instanzen ausgefallen sind.

Name Typ Beschreibung
automaticallyApprove

boolean

Gibt an, ob geplante Ereignisse automatisch genehmigt werden sollen, wenn alle Instanzen ausgefallen sind. Der Standardwert ist true

ApiError

API-Fehler.

Name Typ Beschreibung
code

string

Der Fehlercode.

details

ApiErrorBase[]

Die Details zum API-Fehler

innererror

InnerError

Der innere API-Fehler

message

string

Die Fehlermeldung.

target

string

Das Ziel des bestimmten Fehlers.

ApiErrorBase

API-Fehlerbasis.

Name Typ Beschreibung
code

string

Der Fehlercode.

message

string

Die Fehlermeldung.

target

string

Das Ziel des bestimmten Fehlers.

AvailabilitySet

Gibt Informationen zum Verfügbarkeitssatz an, dem der virtuelle Computer zugewiesen werden soll. Virtuelle Computer, die in der gleichen Verfügbarkeitsgruppe angegeben sind, werden verschiedenen Knoten zugewiesen, um die Verfügbarkeit zu maximieren. Weitere Informationen zu Verfügbarkeitssätzen finden Sie unter Übersicht über Verfügbarkeitssätze. Weitere Informationen zur geplanten Wartung von Azure finden Sie unter Wartung und Updates für virtuelle Computer in Azure. Derzeit kann ein virtueller Computer nur zur Erstellungszeit zu einer Verfügbarkeitsgruppe hinzugefügt werden. Eine vorhandene VM kann keinem Verfügbarkeitssatz hinzugefügt werden.

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Der geografische Standort, an dem sich die Ressource befindet

name

string

Der Name der Ressource

properties.platformFaultDomainCount

integer (int32)

Fehlerdomänenanzahl.

properties.platformUpdateDomainCount

integer (int32)

Die Anzahl der Domänen aktualisieren.

properties.proximityPlacementGroup

SubResource

Gibt Informationen zur Näherungsplatzierungsgruppe an, der der Verfügbarkeitssatz zugewiesen werden soll. Mindest-API-Version: 2018-04-01.

properties.scheduledEventsPolicy

ScheduledEventsPolicy

Gibt redeploy, Reboot und ScheduledEventsAdditionalPublishingTargets Scheduled Event related configurations for the availability set an.

properties.statuses

InstanceViewStatus[]

Die Ressourcenstatusinformationen.

properties.virtualMachineScaleSetMigrationInfo

VirtualMachineScaleSetMigrationInfo

Beschreibt die Migrationseigenschaften für die Verfügbarkeitsgruppe.

properties.virtualMachines

SubResource[]

Eine Liste der Verweise auf alle virtuellen Computer im Verfügbarkeitssatz.

sku

Sku

Die Sku des Verfügbarkeitssatzes muss nur festgelegt werden. Mögliche Werte finden Sie unter AvailabilitySetSkuTypes. Verwenden Sie "Ausgerichtet" für virtuelle Computer mit verwalteten Datenträgern und "Klassisch" für virtuelle Computer mit nicht verwalteten Datenträgern. Der Standardwert ist "Klassisch".

systemData

systemData

Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen.

tags

object

Ressourcentags.

type

string

Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

AvailabilitySetListResult

Die Antwort des Vorgangs "Verfügbarkeitsgruppe auflisten".

Name Typ Beschreibung
nextLink

string (uri)

Der URI zum Abrufen der nächsten Seite von AvailabilitySets. Rufen Sie ListNext() mit diesem URI auf, um die nächste Seite von AvailabilitySets abzurufen.

value

AvailabilitySet[]

Die Liste der Verfügbarkeitsgruppen.

CloudError

Eine Fehlerantwort vom Compute-Dienst.

Name Typ Beschreibung
error

ApiError

API-Fehler.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Wert Beschreibung
User
Application
ManagedIdentity
Key

DefaultVirtualMachineScaleSetInfo

Gibt die Zieleigenschaften des Virtual Machine ScaleSet an, wenn eine nahtlose Migration ohne Ausfallzeiten der VMs über die ConvertToVirtualMachineScaleSet-API ausgelöst wird.

Name Typ Beschreibung
constrainedMaximumCapacity

boolean

Gibt an, ob die maximale Kapazität der standardmäßigen migrierten VM-Skalierungsgruppe nach der Migration auf eine begrenzte Anzahl von VMs beschränkt wird.

defaultVirtualMachineScaleSet

SubResource

Der standardmäßige VM-ScaleSet-URI, in den die Verfügbarkeitsgruppe verschoben wird, wenn eine nahtlose Migration über die ConvertToVirtualMachineScaleSet-API ausgelöst wird.

EventGridAndResourceGraph

Gibt eventGridAndResourceGraph-bezogene Konfigurationen im Zusammenhang mit geplanten Ereignissen an.

Name Typ Beschreibung
enable

boolean

Gibt an, ob Ereignisraster und Ressourcendiagramm für geplante Ereigniskonfigurationen aktiviert sind.

scheduledEventsApiVersion

string

Gibt die API-Version an, um zu bestimmen, welche Version des Konfigurationsschemas für geplante Ereignisse bereitgestellt wird.

InnerError

Innere Fehlerdetails.

Name Typ Beschreibung
errordetail

string

Die interne Fehlermeldung oder der Ausnahmedump.

exceptiontype

string

Der Ausnahmetyp.

InstanceViewStatus

Instanzansichtsstatus.

Name Typ Beschreibung
code

string

Der Statuscode.

displayStatus

string

Die kurze lokalisierbare Bezeichnung für den Status.

level

StatusLevelTypes

Der Ebenencode.

message

string

Die detaillierte Statusmeldung, einschließlich warnungen und Fehlermeldungen.

time

string (date-time)

Die Uhrzeit des Status.

ScheduledEventsAdditionalPublishingTargets

Name Typ Beschreibung
eventGridAndResourceGraph

EventGridAndResourceGraph

Die Konfigurationsparameter, die beim Erstellen der Ereigniseinstellung eventGridAndResourceGraph Scheduled Event verwendet werden.

ScheduledEventsPolicy

Gibt die Konfigurationen "Redeploy", "Reboot" und "ScheduledEventsAdditionalPublishingTargets" an, die sich auf geplante Ereignisse beziehen.

Name Typ Beschreibung
allInstancesDown

AllInstancesDown

Die Konfigurationsparameter, die beim Erstellen der geplanten AllInstancesDown-Ereigniseinstellung verwendet werden.

scheduledEventsAdditionalPublishingTargets

ScheduledEventsAdditionalPublishingTargets

Die Konfigurationsparameter, die beim Veröffentlichen von scheduledEventsAdditionalPublishingTargets verwendet werden.

userInitiatedReboot

UserInitiatedReboot

Die Konfigurationsparameter, die beim Erstellen der erstellung von "userInitiatedReboot"-Ereigniseinstellung verwendet werden.

userInitiatedRedeploy

UserInitiatedRedeploy

Die konfigurationsparameter, die beim Erstellen der erstellung von "userInitiatedRedeploy scheduled event setting creation" verwendet werden.

Sku

Beschreibt eine SKU für VM-Skalierungsgruppen. HINWEIS: Wenn die neue VM-SKU auf der Hardware, auf der der Skalierungssatz derzeit installiert ist, nicht unterstützt wird, müssen Sie die virtuellen Computer im Skalierungssatz umstellen, bevor Sie den SKU-Namen ändern.

Name Typ Beschreibung
capacity

integer (int64)

Gibt die Anzahl der virtuellen Computer im Skalierungssatz an.

name

string

Der Sku-Name.

tier

string

Gibt die Ebene der virtuellen Computer in einem Skalierungssatz an.

Mögliche Werte:

Standard

Grundlegend

StatusLevelTypes

Der Ebenencode.

Wert Beschreibung
Info
Warning
Error

SubResource

Name Typ Beschreibung
id

string

Ressourcen-ID

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name Typ Beschreibung
createdAt

string (date-time)

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy

string

Die Identität, die die Ressource erstellt hat.

createdByType

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt

string (date-time)

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

createdByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.

UserInitiatedReboot

Gibt Konfigurationen im Zusammenhang mit dem Neustart von geplanten Ereignissen an.

Name Typ Beschreibung
automaticallyApprove

boolean

Gibt konfigurationen im Zusammenhang mit dem Geplanten Neustartereignis an.

UserInitiatedRedeploy

Gibt an, dass Konfigurationen im Zusammenhang mit geplanten Ereignissen erneut bereitgestellt werden.

Name Typ Beschreibung
automaticallyApprove

boolean

Gibt die konfigurationen für geplante Ereignisse neu bereitstellen an.

VirtualMachineScaleSetMigrationInfo

Beschreibt die Eigenschaften der Verfügbarkeitsgruppe im Zusammenhang mit der Migration zu einer flexiblen VM-Skalierungsgruppe.

Name Typ Beschreibung
defaultVirtualMachineScaleSetInfo

DefaultVirtualMachineScaleSetInfo

Gibt die Zieleigenschaften des Virtual Machine ScaleSet an, wenn eine nahtlose Migration ohne Ausfallzeiten der VMs über die ConvertToVirtualMachineScaleSet-API ausgelöst wird.

migrateToVirtualMachineScaleSet

SubResource

Gibt die VM-Skalierungsgruppe an, zu der die Verfügbarkeitsgruppe migriert wird.