Availability Sets - List

서비스:: Compute

API 버전:: 2025-04-01

리소스 그룹의 모든 가용성 집합을 나열합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
subscriptionId	path	True	string minLength: 1	대상 구독의 ID입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	AvailabilitySetListResult	요청이 성공했습니다.
Other Status Codes	CloudError	예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

AvailabilitySet_List_MaximumSet_Gen

AvailabilitySet_List_MinimumSet_Gen

AvailabilitySet_List_MaximumSet_Gen

샘플 요청

HTTP

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

샘플 응답

상태 코드:: 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

샘플 요청

HTTP

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

샘플 응답

상태 코드:: 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"
    }
  ]
}

정의

Name	Description
AllInstancesDown	모든 인스턴스가 다운될 때 예약된 이벤트를 자동으로 승인해야 하는지 여부를 지정합니다.
ApiError	API 오류.
ApiErrorBase	API 오류 기반.
AvailabilitySet	가상 머신을 할당해야 하는 가용성 집합에 대한 정보를 지정합니다. 동일한 가용성 집합에 지정된 가상 머신은 가용성을 최대화하기 위해 다른 노드에 할당됩니다. 가용성 집합에 대한 자세한 내용은 가용성 집합 개요참조하세요. Azure 계획된 유지 관리에 대한 자세한 내용은 AzureVirtual Machines에 대한 유지 관리 및 업데이트를 참조하세요. 현재 VM은 만들 때만 가용성 집합에 추가할 수 있습니다. 기존 VM은 가용성 집합에 추가할 수 없습니다.
AvailabilitySetListResult	가용성 집합 나열 작업 응답입니다.
CloudError	컴퓨팅 서비스의 오류 응답입니다.
createdByType	리소스를 만든 ID의 형식입니다.
DefaultVirtualMachineScaleSetInfo	ConvertToVirtualMachineScaleSet API를 통해 VM의 가동 중지 시간 없이 원활한 마이그레이션을 트리거할 때 대상 Virtual Machine ScaleSet 속성을 나타냅니다.
EventGridAndResourceGraph	eventGridAndResourceGraph 관련 예약된 이벤트 관련 구성을 지정합니다.
InnerError	내부 오류 세부 정보입니다.
InstanceViewStatus	인스턴스 보기 상태입니다.
ScheduledEventsAdditionalPublishingTargets
ScheduledEventsPolicy	재배포, 재부팅 및 ScheduledEventsAdditionalPublishingTargets 예약된 이벤트 관련 구성을 지정합니다.
Sku	가상 머신 확장 집합 SKU에 대해 설명합니다. 참고: 확장 집합이 현재 설정된 하드웨어에서 새 VM SKU가 지원되지 않는 경우 SKU 이름을 수정하기 전에 확장 집합에서 VM의 할당을 취소해야 합니다.
StatusLevelTypes	수준 코드입니다.
SubResource
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
UserInitiatedReboot	재부팅 관련 예약된 이벤트 관련 구성을 지정합니다.
UserInitiatedRedeploy	재배포 관련 예약된 이벤트 관련 구성을 지정합니다.
VirtualMachineScaleSetMigrationInfo	유연한 Virtual Machine Scale Set로의 마이그레이션과 관련된 가용성 집합 속성에 대해 설명합니다.

AllInstancesDown

Object

모든 인스턴스가 다운될 때 예약된 이벤트를 자동으로 승인해야 하는지 여부를 지정합니다.

Name	형식	Description
automaticallyApprove	boolean	모든 인스턴스가 다운될 때 예약된 이벤트를 자동으로 승인해야 하는지 여부를 지정합니다. 기본값은 true입니다.

ApiError

Object

API 오류.

Name	형식	Description
code	string	오류 코드입니다.
details	ApiErrorBase[]	Api 오류 세부 정보
innererror	InnerError	Api 내부 오류
message	string	오류 메시지입니다.
target	string	특정 오류의 대상입니다.

ApiErrorBase

Object

API 오류 기반.

Name	형식	Description
code	string	오류 코드입니다.
message	string	오류 메시지입니다.
target	string	특정 오류의 대상입니다.

AvailabilitySet

Object

가상 머신을 할당해야 하는 가용성 집합에 대한 정보를 지정합니다. 동일한 가용성 집합에 지정된 가상 머신은 가용성을 최대화하기 위해 다른 노드에 할당됩니다. 가용성 집합에 대한 자세한 내용은 가용성 집합 개요참조하세요. Azure 계획된 유지 관리에 대한 자세한 내용은 AzureVirtual Machines에 대한 유지 관리 및 업데이트를 참조하세요. 현재 VM은 만들 때만 가용성 집합에 추가할 수 있습니다. 기존 VM은 가용성 집합에 추가할 수 없습니다.

Name	형식	Description
id	string	리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	리소스가 있는 지리적 위치
name	string	리소스의 이름
properties.platformFaultDomainCount	integer (int32)	장애 도메인 수입니다.
properties.platformUpdateDomainCount	integer (int32)	도메인 수를 업데이트합니다.
properties.proximityPlacementGroup	SubResource	가용성 집합을 할당해야 하는 근접 배치 그룹에 대한 정보를 지정합니다. 최소 api-version: 2018-04-01.
properties.scheduledEventsPolicy	ScheduledEventsPolicy	가용성 집합에 대한 재배포, 다시 부팅 및 ScheduledEventsAdditionalPublishingTargets 예약 이벤트 관련 구성을 지정합니다.
properties.statuses	InstanceViewStatus[]	리소스 상태 정보입니다.
properties.virtualMachineScaleSetMigrationInfo	VirtualMachineScaleSetMigrationInfo	가용성 집합의 마이그레이션 속성에 대해 설명합니다.
properties.virtualMachines	SubResource[]	가용성 집합의 모든 가상 머신에 대한 참조 목록입니다.
sku	Sku	가용성 집합의 SKU이며 이름만 설정해야 합니다. 가능한 값 집합은 AvailabilitySetSkuTypes를 참조하세요. 관리 디스크가 있는 가상 머신의 경우 'Aligned'를 사용하고, 관리되지 않는 디스크가 있는 가상 머신에는 '클래식'을 사용합니다. 기본값은 '클래식'입니다.
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
tags	object	리소스 태그.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

AvailabilitySetListResult

Object

가용성 집합 나열 작업 응답입니다.

Name	형식	Description
nextLink	string (uri)	AvailabilitySets의 다음 페이지를 가져올 URI입니다. 이 URI를 사용하여 ListNext()를 호출하여 AvailabilitySets의 다음 페이지를 가져옵니다.
value	AvailabilitySet[]	가용성 집합 목록입니다.

CloudError

Object

컴퓨팅 서비스의 오류 응답입니다.

Name	형식	Description
error	ApiError	API 오류.

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값	Description
User
Application
ManagedIdentity
Key

DefaultVirtualMachineScaleSetInfo

Object

ConvertToVirtualMachineScaleSet API를 통해 VM의 가동 중지 시간 없이 원활한 마이그레이션을 트리거할 때 대상 Virtual Machine ScaleSet 속성을 나타냅니다.

Name	형식	Description
constrainedMaximumCapacity	boolean	마이그레이션 후 마이그레이션된 기본 Virtual Machine Scale Set의 최대 용량이 제한된 수의 VM으로 제한되는지 여부를 나타냅니다.
defaultVirtualMachineScaleSet	SubResource	ConvertToVirtualMachineScaleSet API를 통해 원활한 마이그레이션을 트리거할 때 가용성 집합이 이동되는 기본 Virtual Machine ScaleSet URI입니다.

EventGridAndResourceGraph

Object

eventGridAndResourceGraph 관련 예약된 이벤트 관련 구성을 지정합니다.

Name	형식	Description
enable	boolean	예약된 이벤트 관련 구성에 대해 이벤트 그리드 및 리소스 그래프를 사용할 수 있는지를 지정합니다.
scheduledEventsApiVersion	string	전달할 예약된 이벤트 구성 스키마 버전을 결정하기 위해 api-version을 지정합니다.

InnerError

Object

내부 오류 세부 정보입니다.

Name	형식	Description
errordetail	string	내부 오류 메시지 또는 예외 덤프입니다.
exceptiontype	string	예외 유형입니다.

InstanceViewStatus

Object

인스턴스 보기 상태입니다.

Name	형식	Description
code	string	상태 코드입니다.
displayStatus	string	상태에 대한 짧은 지역화 가능 레이블입니다.
level	StatusLevelTypes	수준 코드입니다.
message	string	경고 및 오류 메시지를 포함한 자세한 상태 메시지입니다.
time	string (date-time)	상태의 시간입니다.

ScheduledEventsAdditionalPublishingTargets

Object

Name	형식	Description
eventGridAndResourceGraph	EventGridAndResourceGraph	eventGridAndResourceGraph Scheduled Event 설정을 만드는 동안 사용되는 구성 매개 변수입니다.

ScheduledEventsPolicy

Object

재배포, 재부팅 및 ScheduledEventsAdditionalPublishingTargets 예약된 이벤트 관련 구성을 지정합니다.

Name	형식	Description
allInstancesDown	AllInstancesDown	AllInstancesDown 예약된 이벤트 설정 생성을 생성하는 동안 사용되는 구성 매개 변수입니다.
scheduledEventsAdditionalPublishingTargets	ScheduledEventsAdditionalPublishingTargets	scheduledEventsAdditionalPublishingTargets를 게시하는 동안 사용되는 구성 매개 변수입니다.
userInitiatedReboot	UserInitiatedReboot	userInitiatedReboot 예약된 이벤트 설정을 만드는 동안 사용되는 구성 매개 변수입니다.
userInitiatedRedeploy	UserInitiatedRedeploy	userInitiatedRedeploy 예약된 이벤트 설정을 만드는 동안 사용되는 구성 매개 변수입니다.

Sku

Object

가상 머신 확장 집합 SKU에 대해 설명합니다. 참고: 확장 집합이 현재 설정된 하드웨어에서 새 VM SKU가 지원되지 않는 경우 SKU 이름을 수정하기 전에 확장 집합에서 VM의 할당을 취소해야 합니다.

Name	형식	Description
capacity	integer (int64)	확장 집합의 가상 머신 수를 지정합니다.
name	string	SKU 이름입니다.
tier	string	확장 집합에 있는 가상 머신의 계층을 지정합니다. 가능한 값: 표준 Basic

StatusLevelTypes

열거형

수준 코드입니다.

값	Description
Info
Warning
Error

SubResource

Object

Name	형식	Description
id	string	리소스 ID

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

UserInitiatedReboot

Object

재부팅 관련 예약된 이벤트 관련 구성을 지정합니다.

Name	형식	Description
automaticallyApprove	boolean	다시 부팅 예약된 이벤트 관련 구성을 지정합니다.

UserInitiatedRedeploy

Object

재배포 관련 예약된 이벤트 관련 구성을 지정합니다.

Name	형식	Description
automaticallyApprove	boolean	예약된 이벤트 관련 구성 다시 배포를 지정합니다.

VirtualMachineScaleSetMigrationInfo

Object

유연한 Virtual Machine Scale Set로의 마이그레이션과 관련된 가용성 집합 속성에 대해 설명합니다.

Name	형식	Description
defaultVirtualMachineScaleSetInfo	DefaultVirtualMachineScaleSetInfo	ConvertToVirtualMachineScaleSet API를 통해 VM의 가동 중지 시간 없이 원활한 마이그레이션을 트리거할 때 대상 Virtual Machine ScaleSet 속성을 나타냅니다.
migrateToVirtualMachineScaleSet	SubResource	가용성 집합이 마이그레이션되는 Virtual Machine Scale Set를 지정합니다.

다음을 통해 공유

Availability Sets - List

URI 매개 변수

응답

보안

azure_auth

범위

예제

AvailabilitySet_List_MaximumSet_Gen

샘플 요청

샘플 응답

AvailabilitySet_List_MinimumSet_Gen

샘플 요청

샘플 응답

정의

AllInstancesDown

ApiError

ApiErrorBase

AvailabilitySet

AvailabilitySetListResult

CloudError

createdByType

DefaultVirtualMachineScaleSetInfo

EventGridAndResourceGraph

InnerError

InstanceViewStatus

ScheduledEventsAdditionalPublishingTargets

ScheduledEventsPolicy

Sku

StatusLevelTypes

SubResource

systemData

UserInitiatedReboot

UserInitiatedRedeploy

VirtualMachineScaleSetMigrationInfo