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=2023-07-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
resourceGroupName
path True

string

Der Name der Ressourcengruppe.

subscriptionId
path True

string

Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

api-version
query True

string

Client-API-Version.

Antworten

Name Typ Beschreibung
200 OK

AvailabilitySetListResult

OK

Other Status Codes

CloudError

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Beschreibung
user_impersonation Annehmen der Identität Ihres Benutzerkontos

Beispiele

AvailabilitySet_List_MaximumSet_Gen
AvailabilitySet_List_MinimumSet_Gen

AvailabilitySet_List_MaximumSet_Gen

Sample Request

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

Sample Response

{
  "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": "aaaaa"
}

AvailabilitySet_List_MinimumSet_Gen

Sample Request

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

Sample Response

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

API-Fehler.

ApiErrorBase

API-Fehlerbasis.

AvailabilitySet

Gibt Informationen zu der Verfügbarkeitsgruppe an, der der virtuelle Computer zugewiesen werden soll. Die virtuellen Computern, die in derselben Verfügbarkeitsgruppe angegeben werden, sind verschiedenen Knoten zugeordnet, um die Verfügbarkeit zu maximieren. Weitere Informationen zu Verfügbarkeitsgruppen finden Sie unter Übersicht über Verfügbarkeitsgruppen. Weitere Informationen zur geplanten Wartung in Azure finden Sie unter Wartung und Updates für Virtual Machines in Azure. Derzeit kann eine VM nur zum Zeitpunkt der Erstellung einer Verfügbarkeitsgruppe hinzugefügt werden. Eine vorhandene VM kann einer Verfügbarkeitsgruppe nicht hinzugefügt werden.

AvailabilitySetListResult

Die Antwort auf den Vorgang "Verfügbarkeitsgruppe auflisten".

CloudError

Eine Fehlerantwort des Computediensts.

InnerError

Details zu inneren Fehlern.

InstanceViewStatus

Instanzansicht status.

Sku

Beschreibt eine VM-Skalierungsgruppen-SKU. HINWEIS: Wenn die neue VM-SKU auf der Hardware, auf der sich die Skalierungsgruppe derzeit befindet, nicht unterstützt wird, müssen Sie die Zuordnung der VMs in der Skalierungsgruppe aufheben, bevor Sie den SKU-Namen ändern.

StatusLevelTypes

Der Ebenencode.

SubResource

ApiError

API-Fehler.

Name Typ Beschreibung
code

string

Der Fehlercode.

details

ApiErrorBase[]

Details zu API-Fehlern

innererror

InnerError

Innerer API-Fehler

message

string

Die Fehlermeldung.

target

string

Das Ziel des jeweiligen Fehlers.

ApiErrorBase

API-Fehlerbasis.

Name Typ Beschreibung
code

string

Der Fehlercode.

message

string

Die Fehlermeldung.

target

string

Das Ziel des jeweiligen Fehlers.

AvailabilitySet

Gibt Informationen zu der Verfügbarkeitsgruppe an, der der virtuelle Computer zugewiesen werden soll. Die virtuellen Computern, die in derselben Verfügbarkeitsgruppe angegeben werden, sind verschiedenen Knoten zugeordnet, um die Verfügbarkeit zu maximieren. Weitere Informationen zu Verfügbarkeitsgruppen finden Sie unter Übersicht über Verfügbarkeitsgruppen. Weitere Informationen zur geplanten Wartung in Azure finden Sie unter Wartung und Updates für Virtual Machines in Azure. Derzeit kann eine VM nur zum Zeitpunkt der Erstellung einer Verfügbarkeitsgruppe hinzugefügt werden. Eine vorhandene VM kann einer Verfügbarkeitsgruppe nicht hinzugefügt werden.

Name Typ Beschreibung
id

string

Ressourcen-ID

location

string

Ressourcenspeicherort

name

string

Ressourcenname

properties.platformFaultDomainCount

integer

Anzahl der Fehlerdomänen.

properties.platformUpdateDomainCount

integer

Aktualisieren der Domänenanzahl.

properties.proximityPlacementGroup

SubResource

Gibt Informationen zur Näherungsplatzierungsgruppe an, der die Verfügbarkeitsgruppe zugewiesen werden soll. Api-Mindestversion: 2018-04-01.

properties.statuses

InstanceViewStatus[]

Die Ressource status Informationen.

properties.virtualMachines

SubResource[]

Eine Liste der Verweise auf alle virtuellen Computer in der Verfügbarkeitsgruppe.

sku

Sku

SKU der Verfügbarkeitsgruppe, es muss nur der Name 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".

tags

object

Ressourcentags

type

string

Ressourcentyp

AvailabilitySetListResult

Die Antwort auf den Vorgang "Verfügbarkeitsgruppe auflisten".

Name Typ Beschreibung
nextLink

string

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 des Computediensts.

Name Typ Beschreibung
error

ApiError

API-Fehler.

InnerError

Details zu inneren Fehlern.

Name Typ Beschreibung
errordetail

string

Die interne Fehlermeldung oder das Ausnahmeabbild.

exceptiontype

string

Der Ausnahmetyp.

InstanceViewStatus

Instanzansicht status.

Name Typ Beschreibung
code

string

Der Statuscode.

displayStatus

string

Die kurze lokalisierbare Bezeichnung für die status.

level

StatusLevelTypes

Der Ebenencode.

message

string

Die detaillierte status Meldung, einschließlich Warnungen und Fehlermeldungen.

time

string

Die Zeit der status.

Sku

Beschreibt eine VM-Skalierungsgruppen-SKU. HINWEIS: Wenn die neue VM-SKU auf der Hardware, auf der sich die Skalierungsgruppe derzeit befindet, nicht unterstützt wird, müssen Sie die Zuordnung der VMs in der Skalierungsgruppe aufheben, bevor Sie den SKU-Namen ändern.

Name Typ Beschreibung
capacity

integer

Gibt die Anzahl der virtuellen Computer in der Skalierungsgruppe an.

name

string

Der SKU-Name.

tier

string

Gibt die Ebene der virtuellen Computer in einer Skalierungsgruppe an.

Mögliche Werte:

Standard

Grundlegend

StatusLevelTypes

Der Ebenencode.

Name Typ Beschreibung
Error

string

Info

string

Warning

string

SubResource

Name Typ Beschreibung
id

string

Ressourcen-ID