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

Parâmetros do URI

Name Em Necessá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

O ID da assinatura de destino.

api-version
query True

string

minLength: 1

A versão da API a utilizar para esta operação.

Respostas

Name Tipo Description
200 OK

DedicatedHostGroupListResult

O pedido foi bem-sucedido.

Other Status Codes

CloudError

Uma resposta de erro inesperada.

Segurança

azure_auth

Azure Active Directory OAuth2 Flow.

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

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

DedicatedHostGroup_ListByResourceGroup_MaximumSet_Gen
DedicatedHostGroup_ListByResourceGroup_MinimumSet_Gen

DedicatedHostGroup_ListByResourceGroup_MaximumSet_Gen

Pedido de amostra

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

Resposta da amostra

{
  "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": "a://example.com/aaaaaaaaaaaaaaaaaaaaaaaaaaa"
}

DedicatedHostGroup_ListByResourceGroup_MinimumSet_Gen

Pedido de amostra

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

Resposta da amostra

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

Definições

Name Description
ApiError

Erro de api.

ApiErrorBase

Base de erro da api.

CloudError

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

createdByType

O tipo de identidade que criou o recurso.

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 dedicados 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

A Lista Grupo de Hosts Dedicados com resposta do grupo de recursos.

DedicatedHostGroupPropertiesAdditionalCapabilities

Habilita ou desabilita um recurso no grupo de hosts dedicado. Versão mínima api: 2022-03-01.

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
systemData

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

ApiError

Erro de api.

Name Tipo Description
code

string

O código de erro.

details

ApiErrorBase[]

Os detalhes do erro Api

innererror

InnerError

O erro interno da Api

message

string

A mensagem de erro.

target

string

O alvo do erro específico.

ApiErrorBase

Base de erro da api.

Name Tipo Description
code

string

O código de erro.

message

string

A mensagem de erro.

target

string

O alvo do erro específico.

CloudError

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

Name Tipo Description
error

ApiError

Erro de api.

createdByType

O tipo de identidade que criou o recurso.

Valor Description
User
Application
ManagedIdentity
Key

DedicatedHostAllocatableVM

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

Name 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 do qual a capacidade não utilizada é representada.

DedicatedHostAvailableCapacity

Capacidade não utilizada do host dedicado.

Name Tipo Description
allocatableVMs

DedicatedHostAllocatableVM[]

A capacidade não utilizada do host dedicado representada em termos de cada tamanho de VM que pode ser implantado no host dedicado.

DedicatedHostGroup

Especifica informações sobre o grupo de hosts dedicados 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.

Name Tipo Description
id

string

ID de recurso totalmente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

A geolocalização onde o recurso vive

name

string

O nome do recurso

properties.additionalCapabilities

DedicatedHostGroupPropertiesAdditionalCapabilities

Habilita ou desabilita um recurso no grupo de hosts dedicado. Versão mínima api: 2022-03-01.

properties.hosts

SubResourceReadOnly[]

Uma lista de referências a todos os anfitriões dedicados no grupo de anfitriões dedicados.

properties.instanceView

DedicatedHostGroupInstanceView

A exibição de instância de grupo de host dedicado, que tem a exibição de lista de instância dos hosts dedicados sob o 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 dedicados. Colocação automática significa que os recursos são alocados em hosts dedicados, escolhidos pelo Azure, sob o grupo de host dedicado. O valor é padronizado para 'false' quando não fornecido. Versão api mínima: 2020-06-01.

systemData

systemData

Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.

tags

object

Tags de recursos.

type

string

O tipo do recurso. Por exemplo, "Microsoft. Computação/Máquinas Virtuais" ou "Microsoft. ContasArmazenamento/Armazenamento"

zones

string[]

As zonas de disponibilidade.

DedicatedHostGroupInstanceView

Name Tipo Description
hosts

DedicatedHostInstanceViewWithName[]

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

DedicatedHostGroupListResult

A Lista Grupo de Hosts Dedicados com resposta do grupo de recursos.

Name Tipo Description
nextLink

string (uri)

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

value

DedicatedHostGroup[]

A lista de grupos de anfitriões dedicados.

DedicatedHostGroupPropertiesAdditionalCapabilities

Habilita ou desabilita um recurso no grupo de hosts dedicado. Versão mínima api: 2022-03-01.

Name Tipo Description
ultraSSDEnabled

boolean

O flag que permite ou desativa a capacidade de ter UltraSSD Enabled Virtual Machines em Hosts Dedicados do Grupo de Host Dedicado. Para que as Virtual Machines sejam habilitadas para UltraSSD, a flag UltraSSDEnabled para o recurso também tem de ser definida como verdadeira. O valor é padronizado para 'false' quando não fornecido. Consulte para obter mais detalhes sobre o https://docs.microsoft.com/en-us/azure/virtual-machines/disks-enable-ultra-ssd recurso Ultra SSD. Nota: A configuração ultraSSDEnabled só pode ser habilitada para Grupos de Host criados como zonais. Versão mínima api: 2022-03-01.

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.

Name Tipo Description
assetId

string

Especifica a id exclusiva da máquina física dedicada na qual o host dedicado reside.

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.

Name Tipo Description
errordetail

string

A mensagem de erro interna ou despejo de exceção.

exceptiontype

string

O tipo de exceção.

InstanceViewStatus

Status da exibição da instância.

Name Tipo Description
code

string

O código de status.

displayStatus

string

O rótulo curto localizável 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
Info
Warning
Error

SubResourceReadOnly

Name Tipo Description
id

string

ID do recurso

systemData

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

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