Share via


Availability Sets - Get

Retrieves information about an availability set.

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

URI Parameters

Name In Required Type Description
availabilitySetName
path True

string

The name of the availability set.

resourceGroupName
path True

string

The name of the resource group.

subscriptionId
path True

string

Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call.

api-version
query True

string

Client Api Version.

Responses

Name Type Description
200 OK

AvailabilitySet

OK

Other Status Codes

CloudError

Error response describing why the operation failed.

Security

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 impersonate your user account

Examples

AvailabilitySet_Get_MaximumSet_Gen
AvailabilitySet_Get_MinimumSet_Gen

AvailabilitySet_Get_MaximumSet_Gen

Sample request

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

Sample response

{
  "location": "westus",
  "properties": {
    "platformFaultDomainCount": 2,
    "platformUpdateDomainCount": 20,
    "virtualMachineScaleSetMigrationInfo": {
      "defaultVirtualMachineScaleSetInfo": {
        "defaultVirtualMachineScaleSet": {
          "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmss-name}"
        },
        "constrainedMaximumCapacity": false
      },
      "migrateToVirtualMachineScaleSet": {
        "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/{vmss-name}"
      }
    },
    "virtualMachines": [
      {
        "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}"
      }
    ],
    "proximityPlacementGroup": {
      "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}"
    },
    "scheduledEventsPolicy": {
      "scheduledEventsAdditionalPublishingTargets": {
        "eventGridAndResourceGraph": {
          "enable": true
        }
      },
      "userInitiatedRedeploy": {
        "automaticallyApprove": true
      },
      "userInitiatedReboot": {
        "automaticallyApprove": true
      }
    },
    "statuses": [
      {
        "code": "aaaaaaaaaaaaaaaaaaaaaaa",
        "level": "Info",
        "displayStatus": "aaaaaa",
        "message": "a",
        "time": "2021-11-30T12:58:26.522Z"
      }
    ]
  },
  "sku": {
    "name": "Classic",
    "tier": "aaaaaaaaaaaaaa",
    "capacity": 29
  },
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/availabilitySets/myAvailabilitySet",
  "name": "myAvailabilitySet",
  "type": "Microsoft.Compute/availabilitySets",
  "tags": {
    "key9626": "aaaaaaaaaaaaaaaaaaaa",
    "key2505": "aa"
  }
}

AvailabilitySet_Get_MinimumSet_Gen

Sample request

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

Sample response

{
  "location": "westus",
  "id": "/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/availabilitySets/myAvailabilitySet"
}

Definitions

Name Description
ApiError

Api error.

ApiErrorBase

Api error base.

AvailabilitySet

Specifies information about the availability set that the virtual machine should be assigned to. Virtual machines specified in the same availability set are allocated to different nodes to maximize availability. For more information about availability sets, see Availability sets overview. For more information on Azure planned maintenance, see Maintenance and updates for Virtual Machines in Azure. Currently, a VM can only be added to an availability set at creation time. An existing VM cannot be added to an availability set.

CloudError

An error response from the Compute service.

DefaultVirtualMachineScaleSetInfo

Indicates the target Virtual Machine ScaleSet properties upon triggering a seamless migration without downtime of the VMs via the ConvertToVirtualMachineScaleSet API.

EventGridAndResourceGraph

Specifies eventGridAndResourceGraph related Scheduled Event related configurations.

InnerError

Inner error details.

InstanceViewStatus

Instance view status.

ScheduledEventsAdditionalPublishingTargets
ScheduledEventsPolicy

Specifies Redeploy, Reboot and ScheduledEventsAdditionalPublishingTargets Scheduled Event related configurations.

Sku

Describes a virtual machine scale set sku. NOTE: If the new VM SKU is not supported on the hardware the scale set is currently on, you need to deallocate the VMs in the scale set before you modify the SKU name.

StatusLevelTypes

The level code.

SubResource
UserInitiatedReboot

Specifies Reboot related Scheduled Event related configurations.

UserInitiatedRedeploy

Specifies Redeploy related Scheduled Event related configurations.

VirtualMachineScaleSetMigrationInfo

Describes the Availability Set properties related to migration to Flexible Virtual Machine Scale Set.

ApiError

Api error.

Name Type Description
code

string

The error code.

details

ApiErrorBase[]

The Api error details

innererror

InnerError

The Api inner error

message

string

The error message.

target

string

The target of the particular error.

ApiErrorBase

Api error base.

Name Type Description
code

string

The error code.

message

string

The error message.

target

string

The target of the particular error.

AvailabilitySet

Specifies information about the availability set that the virtual machine should be assigned to. Virtual machines specified in the same availability set are allocated to different nodes to maximize availability. For more information about availability sets, see Availability sets overview. For more information on Azure planned maintenance, see Maintenance and updates for Virtual Machines in Azure. Currently, a VM can only be added to an availability set at creation time. An existing VM cannot be added to an availability set.

Name Type Description
id

string

Resource Id

location

string

Resource location

name

string

Resource name

properties.platformFaultDomainCount

integer (int32)

Fault Domain count.

properties.platformUpdateDomainCount

integer (int32)

Update Domain count.

properties.proximityPlacementGroup

SubResource

Specifies information about the proximity placement group that the availability set should be assigned to. Minimum api-version: 2018-04-01.

properties.scheduledEventsPolicy

ScheduledEventsPolicy

Specifies Redeploy, Reboot and ScheduledEventsAdditionalPublishingTargets Scheduled Event related configurations for the availability set.

properties.statuses

InstanceViewStatus[]

The resource status information.

properties.virtualMachineScaleSetMigrationInfo

VirtualMachineScaleSetMigrationInfo

Describes the migration properties on the Availability Set.

properties.virtualMachines

SubResource[]

A list of references to all virtual machines in the availability set.

sku

Sku

Sku of the availability set, only name is required to be set. See AvailabilitySetSkuTypes for possible set of values. Use 'Aligned' for virtual machines with managed disks and 'Classic' for virtual machines with unmanaged disks. Default value is 'Classic'.

tags

object

Resource tags

type

string

Resource type

CloudError

An error response from the Compute service.

Name Type Description
error

ApiError

Api error.

DefaultVirtualMachineScaleSetInfo

Indicates the target Virtual Machine ScaleSet properties upon triggering a seamless migration without downtime of the VMs via the ConvertToVirtualMachineScaleSet API.

Name Type Description
constrainedMaximumCapacity

boolean

Indicates if the the maximum capacity of the default migrated Virtual Machine Scale Set after its migration will be constrained to a limited number of VMs.

defaultVirtualMachineScaleSet

SubResource

The default Virtual Machine ScaleSet Uri that the Availability Set will be moved to upon triggering a seamless migration via the ConvertToVirtualMachineScaleSet API.

EventGridAndResourceGraph

Specifies eventGridAndResourceGraph related Scheduled Event related configurations.

Name Type Description
enable

boolean

Specifies if event grid and resource graph is enabled for Scheduled event related configurations.

InnerError

Inner error details.

Name Type Description
errordetail

string

The internal error message or exception dump.

exceptiontype

string

The exception type.

InstanceViewStatus

Instance view status.

Name Type Description
code

string

The status code.

displayStatus

string

The short localizable label for the status.

level

StatusLevelTypes

The level code.

message

string

The detailed status message, including for alerts and error messages.

time

string (date-time)

The time of the status.

ScheduledEventsAdditionalPublishingTargets

Name Type Description
eventGridAndResourceGraph

EventGridAndResourceGraph

The configuration parameters used while creating eventGridAndResourceGraph Scheduled Event setting.

ScheduledEventsPolicy

Specifies Redeploy, Reboot and ScheduledEventsAdditionalPublishingTargets Scheduled Event related configurations.

Name Type Description
scheduledEventsAdditionalPublishingTargets

ScheduledEventsAdditionalPublishingTargets

The configuration parameters used while publishing scheduledEventsAdditionalPublishingTargets.

userInitiatedReboot

UserInitiatedReboot

The configuration parameters used while creating userInitiatedReboot scheduled event setting creation.

userInitiatedRedeploy

UserInitiatedRedeploy

The configuration parameters used while creating userInitiatedRedeploy scheduled event setting creation.

Sku

Describes a virtual machine scale set sku. NOTE: If the new VM SKU is not supported on the hardware the scale set is currently on, you need to deallocate the VMs in the scale set before you modify the SKU name.

Name Type Description
capacity

integer (int64)

Specifies the number of virtual machines in the scale set.

name

string

The sku name.

tier

string

Specifies the tier of virtual machines in a scale set.

Possible Values:

Standard

Basic

StatusLevelTypes

The level code.

Value Description
Error
Info
Warning

SubResource

Name Type Description
id

string

Resource Id

UserInitiatedReboot

Specifies Reboot related Scheduled Event related configurations.

Name Type Description
automaticallyApprove

boolean

Specifies Reboot Scheduled Event related configurations.

UserInitiatedRedeploy

Specifies Redeploy related Scheduled Event related configurations.

Name Type Description
automaticallyApprove

boolean

Specifies Redeploy Scheduled Event related configurations.

VirtualMachineScaleSetMigrationInfo

Describes the Availability Set properties related to migration to Flexible Virtual Machine Scale Set.

Name Type Description
defaultVirtualMachineScaleSetInfo

DefaultVirtualMachineScaleSetInfo

Indicates the target Virtual Machine ScaleSet properties upon triggering a seamless migration without downtime of the VMs via the ConvertToVirtualMachineScaleSet API.

migrateToVirtualMachineScaleSet

SubResource

Specifies the Virtual Machine Scale Set that the Availability Set is migrated to.