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 |
---|---|---|---|---|
resource
|
path | True |
string |
O nome do grupo de recursos. |
subscription
|
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 |
OKEY |
|
Other Status Codes |
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
Dedicated |
Dedicated |
DedicatedHostGroup_ListByResourceGroup_MaximumSet_Gen
Solicitação de exemplo
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
Resposta de exemplo
{
"value": [
{
"id": "/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup",
"location": "westus"
}
]
}
Definições
Nome | Description |
---|---|
Additional |
Habilita ou desabilita uma funcionalidade no grupo de hosts dedicado. Versão mínima da API: 2022-03-01. |
Api |
Erro de API. |
Api |
Base de erros de API. |
Cloud |
Uma resposta de erro do serviço de computação. |
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 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. |
Dedicated |
|
Dedicated |
O Grupo de Host Dedicado de Lista com resposta do grupo de recursos. |
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 |
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 |
Os detalhes do erro da API |
|
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 |
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 |
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 |
Habilita ou desabilita uma funcionalidade no grupo de hosts dedicado. Versão mínima da API: 2022-03-01. |
|
properties.hosts |
Uma lista de referências a todos os hosts dedicados no grupo de hosts dedicado. |
|
properties.instanceView |
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 |
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 |
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 |
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.
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 |
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 |