Compartilhar via


Availability Sets - List

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
resourceGroupName
path True

string

O nome do grupo de recursos.

subscriptionId
path True

string

Credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.

api-version
query True

string

Versão da API do cliente.

Respostas

Nome Tipo Description
200 OK

AvailabilitySetListResult

OKEY

Other Status Codes

CloudError

Resposta de erro que descreve por que a operação falhou.

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

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

Resposta de exemplo

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

Solicitação de exemplo

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

Resposta de exemplo

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

Erro de API.

ApiErrorBase

Base de erros de 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 Conjunto de Disponibilidade de Lista.

CloudError

Uma resposta de erro do serviço de computação.

DefaultVirtualMachineScaleSetInfo

Indica as propriedades de ScaleSet da Máquina Virtual de destino ao disparar uma migração perfeita sem tempo de inatividade das VMs por meio da API ConvertToVirtualMachineScaleSet.

EventGridAndResourceGraph

Especifica configurações relacionadas ao evento agendado eventGridAndResourceGraph relacionadas.

InnerError

Detalhes do erro interno.

InstanceViewStatus

Status da exibição da instância.

ScheduledEventsAdditionalPublishingTargets
ScheduledEventsPolicy

Especifica a reimplantação, reinicialização e configurações relacionadas ao evento agendado ScheduledEventsAdditionalPublishingTargets.

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
UserInitiatedReboot

Especifica as configurações relacionadas ao Evento Agendado relacionadas à reinicialização.

UserInitiatedRedeploy

Especifica as configurações relacionadas ao Evento Agendado relacionadas à reimplantação.

VirtualMachineScaleSetMigrationInfo

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

ApiError

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

Base de erros de 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

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 do recurso

location

string

Local do recurso

name

string

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'.

tags

object

Etiquetas de recursos

type

string

Tipo de recurso

AvailabilitySetListResult

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

Nome Tipo Description
nextLink

string

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

Uma resposta de erro do serviço de computação.

Nome Tipo Description
error

ApiError

Erro de API.

DefaultVirtualMachineScaleSetInfo

Indica as propriedades de ScaleSet da Máquina Virtual de destino ao disparar uma migração perfeita 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 migradas padrão após sua migração será restrita a um número limitado de VMs.

defaultVirtualMachineScaleSet

SubResource

O Uri do ScaleSet de Máquina Virtual padrão para o qual o Conjunto de Disponibilidade será movido ao disparar uma migração perfeita por meio da API ConvertToVirtualMachineScaleSet.

EventGridAndResourceGraph

Especifica configurações relacionadas ao evento agendado eventGridAndResourceGraph relacionadas.

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.

InnerError

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

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

Nome Tipo Description
eventGridAndResourceGraph

EventGridAndResourceGraph

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

ScheduledEventsPolicy

Especifica a reimplantação, reinicialização e configurações relacionadas ao evento agendado ScheduledEventsAdditionalPublishingTargets.

Nome Tipo Description
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

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:

Padrão

Básico

StatusLevelTypes

O código de nível.

Valor Description
Error
Info
Warning

SubResource

Nome Tipo Description
id

string

ID do recurso

UserInitiatedReboot

Especifica as configurações relacionadas ao Evento Agendado relacionadas à reinicialização.

Nome Tipo Description
automaticallyApprove

boolean

Especifica as configurações relacionadas ao evento agendado de reinicialização.

UserInitiatedRedeploy

Especifica as configurações relacionadas ao Evento Agendado relacionadas à reimplantação.

Nome Tipo Description
automaticallyApprove

boolean

Especifica as configurações relacionadas ao Evento Agendado de Reimplantação.

VirtualMachineScaleSetMigrationInfo

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 de ScaleSet da Máquina Virtual de destino ao disparar uma migração perfeita 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.