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 |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
|
subscription
|
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 |
O pedido foi bem-sucedido. |
|
| Other Status Codes |
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
|
Dedicated |
|
Dedicated |
DedicatedHostGroup_ListByResourceGroup_MaximumSet_Gen
Pedido de amostra
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
Resposta da amostra
{
"value": [
{
"id": "/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup",
"location": "westus"
}
]
}
Definições
| Name | Description |
|---|---|
|
Api |
Erro de api. |
|
Api |
Base de erro da api. |
|
Cloud |
Uma resposta de erro do serviço de computação. |
|
created |
O tipo de identidade que criou o recurso. |
|
Dedicated |
Representa a capacidade não utilizada do host dedicado em termos de um tamanho de VM específico. |
|
Dedicated |
Capacidade não utilizada do host dedicado. |
|
Dedicated |
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. |
|
Dedicated |
|
|
Dedicated |
A Lista Grupo de Hosts Dedicados com resposta do grupo de recursos. |
|
Dedicated |
Habilita ou desabilita um recurso no grupo de hosts dedicado. Versão mínima api: 2022-03-01. |
|
Dedicated |
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. |
|
Inner |
Detalhes do erro interno. |
|
Instance |
Status da exibição da instância. |
|
Status |
O código de nível. |
|
Sub |
|
|
system |
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 |
Os detalhes do erro Api |
|
| 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 |
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 |
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 |
Habilita ou desabilita um recurso no grupo de hosts dedicado. Versão mínima api: 2022-03-01. |
|
| properties.hosts |
Uma lista de referências a todos os anfitriões dedicados no grupo de anfitriões dedicados. |
|
| properties.instanceView |
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 |
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 |
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 |
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 |
Capacidade não utilizada do host dedicado. |
|
| name |
string |
O nome do host dedicado. |
| statuses |
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 |
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 |
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 |
O tipo de identidade que modificou o recurso pela última vez. |