Availability Sets - List

  • 참조
Service:
Compute
API Version:
2024-03-01

리소스 그룹의 모든 가용성 집합을 Lists.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
resourceGroupName
 path True

string

리소스 그룹의 이름.
subscriptionId
 path True

string

Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명 구독 ID는 모든 서비스 호출에 대한 URI의 파트를 형성합니다.
api-version
 query True

string

클라이언트 API 버전.

응답

Name 형식 Description
200 OK

AvailabilitySetListResult

정상
Other Status Codes

CloudError

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

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=2024-03-01

Sample Response

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

AvailabilitySet_List_MinimumSet_Gen

Sample Request

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

Sample Response

Status code:
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
ApiError

API 오류입니다.
ApiErrorBase

API 오류 기준입니다.
AvailabilitySet

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

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

Compute 서비스의 오류 응답입니다.
InnerError

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

인스턴스 보기 상태.
Sku

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

수준 코드입니다.
SubResource

ApiError

API 오류입니다.

Name 형식 Description
code

string

오류 코드입니다.
details

ApiErrorBase[]

API 오류 세부 정보
innererror

InnerError

API 내부 오류
message

string

오류 메시지입니다.
target

string

특정 오류의 대상입니다.

ApiErrorBase

API 오류 기준입니다.

Name 형식 Description
code

string

오류 코드입니다.
message

string

오류 메시지입니다.
target

string

특정 오류의 대상입니다.

AvailabilitySet

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

Name 형식 Description
id

string

리소스 ID
location

string

리소스 위치
name

string

리소스 이름
properties.platformFaultDomainCount

integer

장애 도메인 수입니다.
properties.platformUpdateDomainCount

integer

도메인 수를 업데이트합니다.
properties.proximityPlacementGroup

SubResource

가용성 집합을 할당해야 하는 근접 배치 그룹에 대한 정보를 지정합니다. 최소 api-version: 2018-04-01.
properties.statuses

InstanceViewStatus[]

리소스 상태 정보입니다.
properties.virtualMachines

SubResource[]

가용성 집합의 모든 가상 머신에 대한 참조 목록입니다.
sku

Sku

가용성 집합의 Sku이며 이름만 설정해야 합니다. 가능한 값 집합은 AvailabilitySetSkuTypes를 참조하세요. 관리 디스크가 있는 가상 머신의 경우 'Aligned'를 사용하고, 관리되지 않는 디스크가 있는 가상 머신에는 '클래식'을 사용합니다. 기본값은 '클래식'입니다.
tags

object

리소스 태그
type

string

리소스 유형

AvailabilitySetListResult

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

Name 형식 Description
nextLink

string

AvailabilitySets의 다음 페이지를 가져올 URI입니다. 이 URI를 사용하여 ListNext()를 호출하여 AvailabilitySets의 다음 페이지를 가져옵니다.
value

AvailabilitySet[]

가용성 집합 목록

CloudError

Compute 서비스의 오류 응답입니다.

Name 형식 Description
error

ApiError

API 오류입니다.

InnerError

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

Name 형식 Description
errordetail

string

내부 오류 메시지 또는 예외 덤프입니다.
exceptiontype

string

예외 형식입니다.

InstanceViewStatus

인스턴스 보기 상태.

Name 형식 Description
code

string

상태 코드입니다.
displayStatus

string

상태 대한 짧은 지역화 가능 레이블입니다.
level

StatusLevelTypes

수준 코드입니다.
message

string

경고 및 오류 메시지를 포함하여 자세한 상태 메시지입니다.
time

string

상태 시간입니다.

Sku

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

Name 형식 Description
capacity

integer

확장 집합의 가상 머신 수를 지정합니다.
name

string

sku 이름입니다.
tier

string

확장 집합에 있는 가상 머신의 계층을 지정합니다.

가능한 값은 다음과 같습니다.

Standard

기본

StatusLevelTypes

수준 코드입니다.

Name 형식 Description
Error

string

Info

string

Warning

string

SubResource

Name 형식 Description
id

string

리소스 ID