Dedicated Hosts - Create Or Update
Criar ou atualizar um host dedicado.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}/hosts/{hostName}?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. |
host
|
path | True |
string |
O nome do host 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. |
Corpo da solicitação
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
location | True |
string |
Localização do recurso |
sku | True |
SKU do host dedicado para a geração de hardware e a família de VMs. Somente o nome é necessário para ser definido. Liste SKUs Microsoft.Compute para obter uma lista de valores possíveis. |
|
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.licenseType |
Especifica o tipo de licença de software que será aplicado às VMs implantadas no host dedicado. Os valores possíveis são: Nenhum,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. |
|
tags |
object |
Marcações de recursos |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
OK |
|
201 Created |
Criado |
|
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
Create or update a dedicated host .
Sample Request
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myDedicatedHostGroup/hosts/myDedicatedHost?api-version=2024-03-01
{
"location": "westus",
"tags": {
"department": "HR"
},
"properties": {
"platformFaultDomain": 1
},
"sku": {
"name": "DSv3-Type1"
}
}
Sample Response
{
"name": "myDedicatedHost",
"location": "westus",
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup/hosts/myDedicatedHost",
"tags": {
"department": "HR"
},
"sku": {
"name": "DSv3-Type1"
},
"properties": {
"platformFaultDomain": 1,
"autoReplaceOnFailure": true,
"hostId": "{GUID}"
}
}
{
"properties": {
"platformFaultDomain": 1,
"autoReplaceOnFailure": false,
"licenseType": "Windows_Server_Hybrid",
"hostId": "{GUID}"
},
"location": "westus",
"tags": {
"department": "HR"
},
"name": "myDedicatedHost",
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup/hosts/myDedicatedHost",
"sku": {
"name": "DSv3-Type1"
}
}
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: Nenhum,Windows_Server_Hybrid,Windows_Server_Perpetual. O valor padrão é: Nenhum. |
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 o novo SKU de VM não tiver suporte 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 ao longo do 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: Nenhum,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. Somente o nome é necessário para ser definido. 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 o host dedicado reside. |
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: Nenhum,Windows_Server_Hybrid,Windows_Server_Perpetual. O valor padrão é: Nenhum.
Nome | Tipo | Description |
---|---|---|
None |
string |
|
Windows_Server_Hybrid |
string |
|
Windows_Server_Perpetual |
string |
InnerError
Detalhes do erro interno.
Nome | Tipo | Description |
---|---|---|
errordetail |
string |
A mensagem de erro interna ou 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 do status. |
Sku
Descreve um sku de conjunto de dimensionamento de máquinas virtuais. OBSERVAÇÃO: se o novo SKU de VM não tiver suporte 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 do 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 |