Compartilhar via


Dedicated Host Groups - List By Resource Group

Lista todos os grupos de hosts dedicados no grupo de recursos especificado. Use a propriedade nextLink na resposta para obter a próxima página de grupos de hosts dedicados.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups?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

DedicatedHostGroupListResult

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

DedicatedHostGroup_ListByResourceGroup_MaximumSet_Gen
DedicatedHostGroup_ListByResourceGroup_MinimumSet_Gen

DedicatedHostGroup_ListByResourceGroup_MaximumSet_Gen

Solicitação de exemplo

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

Resposta de exemplo

{
  "value": [
    {
      "location": "westus",
      "tags": {},
      "zones": [
        "1"
      ],
      "properties": {
        "platformFaultDomainCount": 3,
        "supportAutomaticPlacement": true,
        "hosts": [
          {
            "id": "aaaa"
          }
        ],
        "instanceView": {
          "hosts": [
            {
              "name": "aaaaaaaaaaaaaaaaaa",
              "assetId": "aaaa",
              "availableCapacity": {
                "allocatableVMs": [
                  {
                    "vmSize": "aaaaaaaaaaaaaaaaaaaa",
                    "count": 26
                  }
                ]
              },
              "statuses": [
                {
                  "code": "aaaaaaaaaaaaaaaaaaaaaaa",
                  "level": "Info",
                  "displayStatus": "aaaaaa",
                  "message": "a",
                  "time": "2021-11-30T12:58:26.522Z"
                }
              ]
            }
          ]
        }
      },
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup",
      "name": "myDedicatedHostGroup",
      "type": "aaaa"
    }
  ],
  "nextLink": "aaaaaaaaaaaaaaaaaaaaaaaaaaa"
}

DedicatedHostGroup_ListByResourceGroup_MinimumSet_Gen

Solicitação de exemplo

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

Resposta de exemplo

{
  "value": [
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup",
      "location": "westus"
    }
  ]
}

Definições

Nome Description
AdditionalCapabilities

Habilita ou desabilita uma funcionalidade no grupo de hosts dedicado. Versão mínima da API: 2022-03-01.

ApiError

Erro de API.

ApiErrorBase

Base de erros de API.

CloudError

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

DedicatedHostAllocatableVM

Representa a capacidade não utilizada do host dedicado em termos de um tamanho de VM específico.

DedicatedHostAvailableCapacity

Capacidade não utilizada do host dedicado.

DedicatedHostGroup

Especifica informações sobre o grupo de hosts dedicado ao qual os hosts dedicados devem ser atribuídos. Atualmente, um host dedicado só pode ser adicionado a um grupo de hosts dedicado no momento da criação. Um host dedicado existente não pode ser adicionado a outro grupo de hosts dedicado.

DedicatedHostGroupInstanceView
DedicatedHostGroupListResult

O Grupo de Host Dedicado de Lista com resposta do grupo de recursos.

DedicatedHostInstanceViewWithName

A exibição de instância de um host dedicado que inclui o nome do host dedicado. Ele é usado para a resposta à exibição de instância de um grupo de hosts dedicado.

InnerError

Detalhes do erro interno.

InstanceViewStatus

Status da exibição da instância.

StatusLevelTypes

O código de nível.

SubResourceReadOnly

AdditionalCapabilities

Habilita ou desabilita uma funcionalidade no grupo de hosts dedicado. Versão mínima da API: 2022-03-01.

Nome Tipo Description
ultraSSDEnabled

boolean

O sinalizador que habilita ou desabilita um recurso para ter máquinas virtuais habilitadas para UltraSSD em hosts dedicados do grupo de hosts dedicados. Para que as máquinas virtuais sejam habilitadas para UltraSSD, o sinalizador UltraSSDEnabled para o recurso também precisa ser definido como verdadeiro. O valor é padronizado como 'false' quando não fornecido. Consulte https://docs.microsoft.com/en-us/azure/virtual-machines/disks-enable-ultra-ssd para obter mais detalhes sobre o recurso SSD Ultra. Observação: a configuração ultraSSDEnabled só pode ser habilitada para Grupos de Host criados como zonais. Versão mínima da API: 2022-03-01.

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.

CloudError

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

Nome Tipo Description
error

ApiError

Erro de API.

DedicatedHostAllocatableVM

Representa a capacidade não utilizada do host dedicado em termos de um tamanho de VM específico.

Nome Tipo Description
count

number (double)

Número máximo de VMs de tamanho vmSize que podem caber na capacidade restante do host dedicado.

vmSize

string

Tamanho da VM em termos dos quais a capacidade não utilizada é representada.

DedicatedHostAvailableCapacity

Capacidade não utilizada do host dedicado.

Nome Tipo Description
allocatableVMs

DedicatedHostAllocatableVM[]

A capacidade não utilizada do host dedicado representado em termos de cada tamanho de VM que tem permissão para ser implantado no host dedicado.

DedicatedHostGroup

Especifica informações sobre o grupo de hosts dedicado ao qual os hosts dedicados devem ser atribuídos. Atualmente, um host dedicado só pode ser adicionado a um grupo de hosts dedicado no momento da criação. Um host dedicado existente não pode ser adicionado a outro grupo de hosts dedicado.

Nome Tipo Description
id

string

ID do recurso

location

string

Local do recurso

name

string

Nome do recurso

properties.additionalCapabilities

AdditionalCapabilities

Habilita ou desabilita uma funcionalidade no grupo de hosts dedicado. Versão mínima da API: 2022-03-01.

properties.hosts

SubResourceReadOnly[]

Uma lista de referências a todos os hosts dedicados no grupo de hosts dedicado.

properties.instanceView

DedicatedHostGroupInstanceView

O modo de exibição de instância do grupo de host dedicado, que tem a lista de exibição de instância dos hosts dedicados no grupo de hosts dedicado.

properties.platformFaultDomainCount

integer (int32)

minimum: 1

Número de domínios de falha que o grupo de hosts pode abranger.

properties.supportAutomaticPlacement

boolean

Especifica se máquinas virtuais ou conjuntos de dimensionamento de máquinas virtuais podem ser colocados automaticamente no grupo de hosts dedicado. O posicionamento automático significa que os recursos são alocados em hosts dedicados, escolhidos pelo Azure, no grupo de hosts dedicado. O valor é padronizado como 'false' quando não fornecido. Versão mínima da API: 2020-06-01.

tags

object

Etiquetas de recursos

type

string

Tipo de recurso

zones

string[]

Zona de Disponibilidade a ser usada para esse grupo de hosts. Há suporte apenas para zona única. A zona só pode ser atribuída durante a criação. Se não for fornecido, o grupo oferecerá suporte a todas as zonas da região. Se fornecido, impõe que cada host no grupo esteja na mesma zona.

DedicatedHostGroupInstanceView

Nome Tipo Description
hosts

DedicatedHostInstanceViewWithName[]

Lista de exibição de instância dos hosts dedicados no grupo de hosts dedicado.

DedicatedHostGroupListResult

O Grupo de Host Dedicado de Lista com resposta do grupo de recursos.

Nome Tipo Description
nextLink

string

O URI para buscar a próxima página de Grupos de Hosts Dedicados. Chame ListNext() com esse URI para buscar a próxima página de Grupos de Hosts Dedicados.

value

DedicatedHostGroup[]

A lista de grupos de hosts dedicados

DedicatedHostInstanceViewWithName

A exibição de instância de um host dedicado que inclui o nome do host dedicado. Ele é usado para a resposta à exibição de instância de um grupo de hosts dedicado.

Nome Tipo Description
assetId

string

Especifica a ID exclusiva do computador físico dedicado no qual reside o host dedicado.

availableCapacity

DedicatedHostAvailableCapacity

Capacidade não utilizada do host dedicado.

name

string

O nome do host dedicado.

statuses

InstanceViewStatus[]

As informações de status do recurso.

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.

StatusLevelTypes

O código de nível.

Valor Description
Error
Info
Warning

SubResourceReadOnly

Nome Tipo Description
id

string

ID do recurso