Availability Sets - List

Serviço:: Compute

Versão da API:: 2025-04-01

Lista todos os conjuntos de disponibilidade em um grupo de recursos.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	A ID da assinatura de destino.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Respostas

Nome	Tipo	Description
200 OK	AvailabilitySetListResult	A solicitação foi bem-sucedida.
Other Status Codes	CloudError	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

AvailabilitySet_List_MaximumSet_Gen

AvailabilitySet_List_MinimumSet_Gen

AvailabilitySet_List_MaximumSet_Gen

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 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

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 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"
    }
  ]
}

Definições

Nome	Description
AllInstancesDown	Especifica se os eventos agendados devem ser aprovados automaticamente quando todas as instâncias estiverem inativas.
ApiError	Erro de API.
ApiErrorBase	Base de erros da API.
AvailabilitySet	Especifica informações sobre o conjunto de disponibilidade ao qual a máquina virtual deve ser atribuída. As máquinas virtuais especificadas no mesmo conjunto de disponibilidade são alocadas a nós diferentes para maximizar a disponibilidade. Para obter mais informações sobre conjuntos de disponibilidade, consulte Visão geral dos conjuntos de disponibilidade. Para obter mais informações sobre a manutenção planejada do Azure, consulte Manutenção e atualizações para máquinas virtuais no Azure. Atualmente, uma VM só pode ser adicionada a um conjunto de disponibilidade no momento da criação. Uma VM existente não pode ser adicionada a um conjunto de disponibilidade.
AvailabilitySetListResult	A resposta da operação Listar Conjunto de Disponibilidade.
CloudError	Uma resposta de erro do serviço Compute.
createdByType	O tipo de identidade que criou o recurso.
DefaultVirtualMachineScaleSetInfo	Indica as propriedades do Conjunto de Dimensionamento da Máquina Virtual de destino ao disparar uma migração contínua sem tempo de inatividade das VMs por meio da API ConvertToVirtualMachineScaleSet.
EventGridAndResourceGraph	Especifica as configurações relacionadas a eventos agendados relacionadas a eventGridAndResourceGraph.
InnerError	Detalhes do erro interno.
InstanceViewStatus	Status da exibição da instância.
ScheduledEventsAdditionalPublishingTargets
ScheduledEventsPolicy	Especifica as configurações relacionadas a Reimplantar, Reinicializar e ScheduledEventsAdditionalPublishingTargets Eventos Agendados.
Sku	Descreve um SKU do conjunto de dimensionamento de máquinas virtuais. OBSERVAÇÃO: Se não houver suporte para a nova SKU de VM no hardware em que o conjunto de dimensionamento está atualmente, você precisará desalocar as VMs no conjunto de dimensionamento antes de modificar o nome da SKU.
StatusLevelTypes	O código de nível.
SubResource
systemData	Metadados relativos à criação e última modificação do recurso.
UserInitiatedReboot	Especifica as configurações relacionadas a eventos agendados relacionados à reinicialização.
UserInitiatedRedeploy	Especifica as configurações relacionadas a eventos agendados relacionados à reimplantação.
VirtualMachineScaleSetMigrationInfo	Descreve as propriedades do Conjunto de Disponibilidade relacionadas à migração para o Conjunto de Dimensionamento de Máquinas Virtuais Flexíveis.

AllInstancesDown

Objeto

Especifica se os eventos agendados devem ser aprovados automaticamente quando todas as instâncias estiverem inativas.

Nome	Tipo	Description
automaticallyApprove	boolean	Especifica se os eventos agendados devem ser aprovados automaticamente quando todas as instâncias estiverem inativas. seu valor padrão é true

ApiError

Objeto

Erro de API.

Nome	Tipo	Description
code	string	O código de erro.
details	ApiErrorBase[]	Os detalhes do erro da API
innererror	InnerError	O erro interno da API
message	string	A mensagem de erro.
target	string	O destino do erro específico.

ApiErrorBase

Objeto

Base de erros da API.

Nome	Tipo	Description
code	string	O código de erro.
message	string	A mensagem de erro.
target	string	O destino do erro específico.

AvailabilitySet

Objeto

Especifica informações sobre o conjunto de disponibilidade ao qual a máquina virtual deve ser atribuída. As máquinas virtuais especificadas no mesmo conjunto de disponibilidade são alocadas a nós diferentes para maximizar a disponibilidade. Para obter mais informações sobre conjuntos de disponibilidade, consulte Visão geral dos conjuntos de disponibilidade. Para obter mais informações sobre a manutenção planejada do Azure, consulte Manutenção e atualizações para máquinas virtuais no Azure. Atualmente, uma VM só pode ser adicionada a um conjunto de disponibilidade no momento da criação. Uma VM existente não pode ser adicionada a um conjunto de disponibilidade.

Nome	Tipo	Description
id	string	ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	A localização geográfica onde o recurso reside
name	string	O nome do recurso
properties.platformFaultDomainCount	integer (int32)	Contagem de domínios de falha.
properties.platformUpdateDomainCount	integer (int32)	Atualizar contagem de domínios.
properties.proximityPlacementGroup	SubResource	Especifica informações sobre o grupo de posicionamento por proximidade ao qual o conjunto de disponibilidade deve ser atribuído. Versão mínima da API: 2018-04-01.
properties.scheduledEventsPolicy	ScheduledEventsPolicy	Especifica as configurações relacionadas a Eventos Agendados de Reimplantação, Reinicialização e ScheduledEventsAdditionalPublishingTargets para o conjunto de disponibilidade.
properties.statuses	InstanceViewStatus[]	As informações de status do recurso.
properties.virtualMachineScaleSetMigrationInfo	VirtualMachineScaleSetMigrationInfo	Descreve as propriedades de migração no Conjunto de Disponibilidade.
properties.virtualMachines	SubResource[]	Uma lista de referências a todas as máquinas virtuais no conjunto de disponibilidade.
sku	Sku	Sku do conjunto de disponibilidade, somente o nome é necessário para ser definido. Consulte AvailabilitySetSkuTypes para obter um possível conjunto de valores. Use 'Aligned' para máquinas virtuais com discos gerenciados e 'Clássico' para máquinas virtuais com discos não gerenciados. O valor padrão é 'Clássico'.
systemData	systemData	Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy.
tags	object	Tags de recursos.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

AvailabilitySetListResult

Objeto

A resposta da operação Listar Conjunto de Disponibilidade.

Nome	Tipo	Description
nextLink	string (uri)	O URI para buscar a próxima página de AvailabilitySets. Chame ListNext() com esse URI para buscar a próxima página de AvailabilitySets.
value	AvailabilitySet[]	A lista de conjuntos de disponibilidade.

CloudError

Objeto

Uma resposta de erro do serviço Compute.

Nome	Tipo	Description
error	ApiError	Erro de API.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

DefaultVirtualMachineScaleSetInfo

Objeto

Indica as propriedades do Conjunto de Dimensionamento da Máquina Virtual de destino ao disparar uma migração contínua sem tempo de inatividade das VMs por meio da API ConvertToVirtualMachineScaleSet.

Nome	Tipo	Description
constrainedMaximumCapacity	boolean	Indica se a capacidade máxima do Conjunto de Dimensionamento de Máquinas Virtuais migrado padrão após sua migração será restrita a um número limitado de VMs.
defaultVirtualMachineScaleSet	SubResource	O URI padrão do Conjunto de Dimensionamento de Máquina Virtual para o qual o Conjunto de Disponibilidade será movido ao disparar uma migração contínua por meio da API ConvertToVirtualMachineScaleSet.

EventGridAndResourceGraph

Objeto

Especifica as configurações relacionadas a eventos agendados relacionadas a eventGridAndResourceGraph.

Nome	Tipo	Description
enable	boolean	Especifica se a grade de eventos e o grafo de recursos estão habilitados para configurações relacionadas a eventos agendados.
scheduledEventsApiVersion	string	Especifica a versão da API para determinar qual versão do esquema de configuração de Eventos Agendados será entregue.

InnerError

Objeto

Detalhes do erro interno.

Nome	Tipo	Description
errordetail	string	A mensagem de erro interna ou o despejo de exceção.
exceptiontype	string	O tipo de exceção.

InstanceViewStatus

Objeto

Status da exibição da instância.

Nome	Tipo	Description
code	string	O código de status.
displayStatus	string	O rótulo localizável curto para o status.
level	StatusLevelTypes	O código de nível.
message	string	A mensagem de status detalhada, inclusive para alertas e mensagens de erro.
time	string (date-time)	A hora do status.

ScheduledEventsAdditionalPublishingTargets

Objeto

Nome	Tipo	Description
eventGridAndResourceGraph	EventGridAndResourceGraph	Os parâmetros de configuração usados durante a criação da configuração de evento agendado eventGridAndResourceGraph.

ScheduledEventsPolicy

Objeto

Especifica as configurações relacionadas a Reimplantar, Reinicializar e ScheduledEventsAdditionalPublishingTargets Eventos Agendados.

Nome	Tipo	Description
allInstancesDown	AllInstancesDown	Os parâmetros de configuração usados durante a criação da configuração de evento agendado AllInstancesDown.
scheduledEventsAdditionalPublishingTargets	ScheduledEventsAdditionalPublishingTargets	Os parâmetros de configuração usados durante a publicação de scheduledEventsAdditionalPublishingTargets.
userInitiatedReboot	UserInitiatedReboot	Os parâmetros de configuração usados durante a criação da criação da configuração de evento agendada userInitiatedReboot.
userInitiatedRedeploy	UserInitiatedRedeploy	Os parâmetros de configuração usados durante a criação da criação da configuração de evento agendada userInitiatedRedeploy.

Sku

Objeto

Descreve um SKU do conjunto de dimensionamento de máquinas virtuais. OBSERVAÇÃO: Se não houver suporte para a nova SKU de VM no hardware em que o conjunto de dimensionamento está atualmente, você precisará desalocar as VMs no conjunto de dimensionamento antes de modificar o nome da SKU.

Nome	Tipo	Description
capacity	integer (int64)	Especifica o número de máquinas virtuais no conjunto de dimensionamento.
name	string	O nome do sku.
tier	string	Especifica a camada de máquinas virtuais em um conjunto de dimensionamento. Valores possíveis: Standard Basic

StatusLevelTypes

Enumeração

O código de nível.

Valor	Description
Info
Warning
Error

SubResource

Objeto

Nome	Tipo	Description
id	string	ID do recurso

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

UserInitiatedReboot

Objeto

Especifica as configurações relacionadas a eventos agendados relacionados à reinicialização.

Nome	Tipo	Description
automaticallyApprove	boolean	Especifica as configurações relacionadas ao evento agendado de reinicialização.

UserInitiatedRedeploy

Objeto

Especifica as configurações relacionadas a eventos agendados relacionados à reimplantação.

Nome	Tipo	Description
automaticallyApprove	boolean	Especifica as configurações relacionadas ao Evento Agendado de Reimplantação.

VirtualMachineScaleSetMigrationInfo

Objeto

Descreve as propriedades do Conjunto de Disponibilidade relacionadas à migração para o Conjunto de Dimensionamento de Máquinas Virtuais Flexíveis.

Nome	Tipo	Description
defaultVirtualMachineScaleSetInfo	DefaultVirtualMachineScaleSetInfo	Indica as propriedades do Conjunto de Dimensionamento da Máquina Virtual de destino ao disparar uma migração contínua sem tempo de inatividade das VMs por meio da API ConvertToVirtualMachineScaleSet.
migrateToVirtualMachineScaleSet	SubResource	Especifica o Conjunto de Dimensionamento de Máquinas Virtuais para o qual o Conjunto de Disponibilidade é migrado.

Compartilhar via

Availability Sets - List

Parâmetros de URI

Respostas

Segurança

azure_auth

Escopos

Exemplos

AvailabilitySet_List_MaximumSet_Gen

Solicitação de exemplo

Resposta de exemplo

AvailabilitySet_List_MinimumSet_Gen

Solicitação de exemplo

Resposta de exemplo

Definições

AllInstancesDown

ApiError

ApiErrorBase

AvailabilitySet

AvailabilitySetListResult

CloudError

createdByType

DefaultVirtualMachineScaleSetInfo

EventGridAndResourceGraph

InnerError

InstanceViewStatus

ScheduledEventsAdditionalPublishingTargets

ScheduledEventsPolicy

Sku

StatusLevelTypes

SubResource

systemData

UserInitiatedReboot

UserInitiatedRedeploy

VirtualMachineScaleSetMigrationInfo