Dedicated Hosts - Get
Obtém informações sobre um anfitrião dedicado.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}/hosts/{hostName}?api-version=2024-03-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}/hosts/{hostName}?$expand={$expand}&api-version=2024-03-01
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
host
|
path | True |
string |
O nome do grupo de anfitriões dedicado. |
host
|
path | True |
string |
O nome do anfitrião dedicado. |
resource
|
path | True |
string |
O nome do grupo de recursos. |
subscription
|
path | True |
string |
Credenciais de subscrição que identificam exclusivamente a subscrição do Microsoft Azure. O ID da subscrição faz parte do URI para cada chamada de serviço. |
api-version
|
query | True |
string |
Versão da API de Cliente. |
$expand
|
query |
A expressão expandir a aplicar na operação. "InstanceView" irá obter a lista de vistas de instâncias do anfitrião dedicado. "UserData" não é suportado para o anfitrião dedicado. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Resposta de erro que descreve a razão pela qual a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | representar a sua conta de utilizador |
Exemplos
Get a dedicated host.
Sample Request
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myDedicatedHostGroup/hosts/myHost?$expand=instanceView&api-version=2024-03-01
Sample Response
{
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup/hosts/myHost",
"properties": {
"platformFaultDomain": 1,
"autoReplaceOnFailure": true,
"hostId": "{GUID}",
"provisioningTime": "2019-06-27T01:02:38.3138469+00:00",
"virtualMachines": [
{
"id": "/subscriptions/subId/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/vm1"
}
],
"provisioningState": "Succeeded",
"instanceView": {
"assetId": "eb3f58b8-b4e8-4882-b69f-301a01812407",
"availableCapacity": {
"allocatableVMs": [
{
"vmSize": "Standard_A1",
"count": 10
}
]
},
"statuses": [
{
"code": "ProvisioningState/succeeded",
"level": "Info",
"displayStatus": "Provisioning succeeded"
},
{
"code": "HealthState/available",
"level": "Info",
"displayStatus": "Host available"
}
]
},
"timeCreated": "2019-06-27T01:02:38.3138469+00:00"
},
"location": "westus",
"tags": {
"department": "HR"
},
"sku": {
"name": "DSv3-Type1"
},
"name": "myHost"
}
Definições
Name | Description |
---|---|
Api |
Erro de API. |
Api |
Base de erros da API. |
Cloud |
Uma resposta de erro do serviço de Computação. |
Dedicated |
Especifica informações sobre o anfitrião dedicado. |
Dedicated |
Representa a capacidade não otimizada do anfitrião dedicado em termos de um tamanho de VM específico. |
Dedicated |
Capacidade não otimizada do anfitrião dedicado. |
Dedicated |
A vista de instância de um anfitrião dedicado. |
Dedicated |
Especifica o tipo de licença de software que será aplicado às VMs implementadas no anfitrião dedicado. Os valores possíveis são: Nenhum, Windows_Server_Hybrid,Windows_Server_Perpetual. O valor predefinido é: Nenhum. |
Inner |
Detalhes do erro interno. |
Instance |
Estado da vista de instância. |
Instance |
A expressão expandir a aplicar na operação. "InstanceView" irá obter a lista de vistas de instâncias do anfitrião dedicado. "UserData" não é suportado para o anfitrião dedicado. |
Sku |
Descreve um sku de conjunto de dimensionamento de máquinas virtuais. NOTA: se o novo SKU da VM não for suportado no hardware em que o conjunto de dimensionamento está atualmente ativado, terá de desalocar as VMs no conjunto de dimensionamento antes de modificar o nome do SKU. |
Status |
O código de nível. |
Sub |
ApiError
Erro de API.
Name | 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 da API.
Name | 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.
Name | Tipo | Description |
---|---|---|
error |
Erro de API. |
DedicatedHost
Especifica informações sobre o anfitrião dedicado.
Name | Tipo | Description |
---|---|---|
id |
string |
ID do Recurso |
location |
string |
Localização do recurso |
name |
string |
Nome do recurso |
properties.autoReplaceOnFailure |
boolean |
Especifica se o anfitrião dedicado deve ser substituído automaticamente em caso de falha. O valor é predefinido como "verdadeiro" quando não é fornecido. |
properties.hostId |
string |
Um ID exclusivo gerado e atribuído ao anfitrião dedicado pela plataforma. Não muda ao longo da duração do anfitrião. |
properties.instanceView |
A vista de instância de anfitrião dedicada. |
|
properties.licenseType |
Especifica o tipo de licença de software que será aplicado às VMs implementadas no anfitrião dedicado. Os valores possíveis são: Nenhum, Windows_Server_Hybrid,Windows_Server_Perpetual. O valor predefinido é: Nenhum. |
|
properties.platformFaultDomain |
integer |
Domínio de falha do anfitrião dedicado num grupo de anfitriões dedicado. |
properties.provisioningState |
string |
O estado de aprovisionamento, que só aparece na resposta. |
properties.provisioningTime |
string |
A data em que o anfitrião foi aprovisionado pela primeira vez. |
properties.timeCreated |
string |
Especifica o momento em que o recurso Anfitrião 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 Anfitrião Dedicado. |
|
sku |
SKU do anfitrião dedicado para a Geração de Hardware e a família de VMs. Só é necessário definir o nome. Liste SKUs Microsoft.Compute para obter uma lista de valores possíveis. |
|
tags |
object |
Etiquetas de recursos |
type |
string |
Tipo de recurso |
DedicatedHostAllocatableVM
Representa a capacidade não otimizada do anfitrião dedicado em termos de um tamanho de VM específico.
Name | Tipo | Description |
---|---|---|
count |
number |
Número máximo de VMs de tamanho vmSize que podem caber na capacidade restante do anfitrião dedicado. |
vmSize |
string |
Tamanho da VM em termos dos quais a capacidade não otimizada está representada. |
DedicatedHostAvailableCapacity
Capacidade não otimizada do anfitrião dedicado.
Name | Tipo | Description |
---|---|---|
allocatableVMs |
A capacidade não otimizada do anfitrião dedicado representado em termos de cada tamanho de VM que é permitido implementar no anfitrião dedicado. |
DedicatedHostInstanceView
A vista de instância de um anfitrião dedicado.
Name | Tipo | Description |
---|---|---|
assetId |
string |
Especifica o ID exclusivo da máquina física dedicada na qual o anfitrião dedicado reside. |
availableCapacity |
Capacidade não otimizada do anfitrião dedicado. |
|
statuses |
As informações do estado do recurso. |
DedicatedHostLicenseTypes
Especifica o tipo de licença de software que será aplicado às VMs implementadas no anfitrião dedicado. Os valores possíveis são: Nenhum, Windows_Server_Hybrid,Windows_Server_Perpetual. O valor predefinido é: Nenhum.
Name | Tipo | Description |
---|---|---|
None |
string |
|
Windows_Server_Hybrid |
string |
|
Windows_Server_Perpetual |
string |
InnerError
Detalhes do erro interno.
Name | Tipo | Description |
---|---|---|
errordetail |
string |
A mensagem de erro interna ou a informação de falha de segurança da exceção. |
exceptiontype |
string |
O tipo de exceção. |
InstanceViewStatus
Estado da vista de instância.
Name | Tipo | Description |
---|---|---|
code |
string |
O código de estado. |
displayStatus |
string |
A etiqueta localizável curta para o estado. |
level |
O código de nível. |
|
message |
string |
A mensagem de estado detalhada, incluindo para alertas e mensagens de erro. |
time |
string |
A hora do estado. |
InstanceViewTypes
A expressão expandir a aplicar na operação. "InstanceView" irá obter a lista de vistas de instâncias do anfitrião dedicado. "UserData" não é suportado para o anfitrião dedicado.
Name | Tipo | Description |
---|---|---|
instanceView |
string |
|
userData |
string |
Sku
Descreve um sku de conjunto de dimensionamento de máquinas virtuais. NOTA: se o novo SKU da VM não for suportado no hardware em que o conjunto de dimensionamento está atualmente ativado, terá de desalocar as VMs no conjunto de dimensionamento antes de modificar o nome do SKU.
Name | Tipo | Description |
---|---|---|
capacity |
integer |
Especifica o número de máquinas virtuais no conjunto de dimensionamento. |
name |
string |
O nome do sku. |
tier |
string |
Especifica a camada de máquinas virtuais num conjunto de dimensionamento. |
StatusLevelTypes
O código de nível.
Name | Tipo | Description |
---|---|---|
Error |
string |
|
Info |
string |
|
Warning |
string |
SubResourceReadOnly
Name | Tipo | Description |
---|---|---|
id |
string |
ID do Recurso |