Dedicated Hosts - List By Host Group
Listas todos os hosts dedicados no grupo de hosts dedicado especificado. Use a propriedade nextLink na resposta para obter a próxima página de hosts dedicados.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}/hosts?api-version=2024-03-01
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
host
|
path | True |
string |
O nome do grupo de hosts dedicado. |
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 |
OK |
|
Other Status Codes |
Resposta de erro que descreve por que a operação falhou. |
Segurança
azure_auth
Fluxo do OAuth2 do Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nome | Description |
---|---|
user_impersonation | representar sua conta de usuário |
Exemplos
Dedicated |
Dedicated |
DedicatedHost_ListByHostGroup_MaximumSet_Gen
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/hostGroups/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/hosts?api-version=2024-03-01
Sample Response
{
"value": [
{
"location": "westus",
"tags": {},
"properties": {
"platformFaultDomain": 1,
"autoReplaceOnFailure": true,
"hostId": "{GUID}",
"virtualMachines": [
{
"id": "aaaa"
}
],
"licenseType": "Windows_Server_Hybrid",
"provisioningTime": "2021-11-30T12:58:26.526Z",
"provisioningState": "aaaaaaaaaaaaaaaaaaaaaaaaa",
"instanceView": {
"assetId": "aaaaaaaaaaaaaaaa",
"availableCapacity": {
"allocatableVMs": [
{
"vmSize": "aaaaaaaaaaaaaaaaaaaa",
"count": 26
}
]
},
"statuses": [
{
"code": "aaaaaaaaaaaaaaaaaaaaaaa",
"level": "Info",
"displayStatus": "aaaaaa",
"message": "a",
"time": "2021-11-30T12:58:26.522Z"
}
]
}
},
"sku": {
"name": "DSv3-Type1",
"tier": "aaa",
"capacity": 7
},
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup/hosts/myDedicatedHost",
"name": "myDedicatedHost",
"type": "aaaaaaaaaaaaaaaaaaa"
}
],
"nextLink": "aaaaaaa"
}
DedicatedHost_ListByHostGroup_MinimumSet_Gen
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/hostGroups/aaaa/hosts?api-version=2024-03-01
Sample Response
{
"value": [
{
"location": "westus",
"sku": {},
"id": "/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup/hosts/myHost"
}
]
}
Definições
Nome | Description |
---|---|
Api |
Erro de API. |
Api |
Base de erros de API. |
Cloud |
Uma resposta de erro do serviço de computação. |
Dedicated |
Especifica informações sobre o host Dedicado. |
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 |
A exibição de instância de um host dedicado. |
Dedicated |
Especifica o tipo de licença de software que será aplicado às VMs implantadas no host dedicado. Os valores possíveis são: None,Windows_Server_Hybrid,Windows_Server_Perpetual. O valor padrão é: Nenhum. |
Dedicated |
A lista de resposta da operação de host dedicada. |
Inner |
Detalhes do erro interno. |
Instance |
Exibição de instância status. |
Sku |
Descreve um SKU de 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. |
Status |
O código de nível. |
Sub |
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. |
DedicatedHost
Especifica informações sobre o host Dedicado.
Nome | Tipo | Description |
---|---|---|
id |
string |
ID do recurso |
location |
string |
Localização do recurso |
name |
string |
Nome do recurso |
properties.autoReplaceOnFailure |
boolean |
Especifica se o host dedicado deve ser substituído automaticamente em caso de falha. O valor é padronizado como 'true' quando não fornecido. |
properties.hostId |
string |
Uma ID exclusiva gerada e atribuída ao host dedicado pela plataforma. Não muda durante todo o tempo de vida do host. |
properties.instanceView |
A exibição de instância de host dedicada. |
|
properties.licenseType |
Especifica o tipo de licença de software que será aplicado às VMs implantadas no host dedicado. Os valores possíveis são: None,Windows_Server_Hybrid,Windows_Server_Perpetual. O valor padrão é: Nenhum. |
|
properties.platformFaultDomain |
integer |
Domínio de falha do host dedicado em um grupo de hosts dedicado. |
properties.provisioningState |
string |
O estado de provisionamento, que aparece apenas na resposta. |
properties.provisioningTime |
string |
A data em que o host foi provisionado pela primeira vez. |
properties.timeCreated |
string |
Especifica a hora em que o recurso host dedicado foi criado. Versão mínima da api: 2021-11-01. |
properties.virtualMachines |
Uma lista de referências a todas as máquinas virtuais no Host Dedicado. |
|
sku |
SKU do host dedicado para a geração de hardware e a família de VMs. É necessário definir apenas o nome. Liste SKUs Microsoft.Compute para obter uma lista de valores possíveis. |
|
tags |
object |
Marcações de recursos |
type |
string |
Tipo de recurso |
DedicatedHostAllocatableVM
Representa a capacidade não utilizada do host dedicado em termos de um tamanho de VM específico.
Nome | Tipo | Description |
---|---|---|
count |
number |
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. |
DedicatedHostInstanceView
A exibição de instância de um host 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. |
|
statuses |
O recurso status informações. |
DedicatedHostLicenseTypes
Especifica o tipo de licença de software que será aplicado às VMs implantadas no host dedicado. Os valores possíveis são: None,Windows_Server_Hybrid,Windows_Server_Perpetual. O valor padrão é: Nenhum.
Nome | Tipo | Description |
---|---|---|
None |
string |
|
Windows_Server_Hybrid |
string |
|
Windows_Server_Perpetual |
string |
DedicatedHostListResult
A lista de resposta da operação de host dedicada.
Nome | Tipo | Description |
---|---|---|
nextLink |
string |
O URI para buscar a próxima página de hosts dedicados. Chame ListNext() com esse URI para buscar a próxima página de hosts dedicados. |
value |
A lista de hosts dedicados |
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
Exibição de instância status.
Nome | Tipo | Description |
---|---|---|
code |
string |
O código do 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 |
A hora da status. |
Sku
Descreve um SKU de 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 |
Especifica o número de máquinas virtuais no conjunto de dimensionamento. |
name |
string |
O nome da SKU. |
tier |
string |
Especifica a camada de máquinas virtuais em um conjunto de dimensionamento. |
StatusLevelTypes
O código de nível.
Nome | Tipo | Description |
---|---|---|
Error |
string |
|
Info |
string |
|
Warning |
string |
SubResourceReadOnly
Nome | Tipo | Description |
---|---|---|
id |
string |
ID do recurso |