Dedicated Hosts - Create Or Update

Referência

Service:: Compute

API Version:: 2024-03-01

Criar ou atualizar um anfitrião dedicado.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}/hosts/{hostName}?api-version=2024-03-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
hostGroupName	path	True	string	O nome do grupo de anfitriões dedicado.
hostName	path	True	string	O nome do anfitrião dedicado .
resourceGroupName	path	True	string	O nome do grupo de recursos.
subscriptionId	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 do Cliente.

Corpo do Pedido

Name	Necessário	Tipo	Description
location	True	string	Localização do recurso
sku	True	Sku	SKU do anfitrião dedicado para Geração de Hardware e família de VMs. Só é necessário definir o nome. Liste os SKUs Microsoft.Compute para obter uma lista de valores possíveis.
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 for fornecido.
properties.licenseType		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.
properties.platformFaultDomain		integer	Domínio de falha do anfitrião dedicado num grupo de anfitriões dedicado.
tags		object	Etiquetas de recursos

Respostas

Name	Tipo	Description
200 OK	DedicatedHost	OK
201 Created	DedicatedHost	Criado
Other Status Codes	CloudError	Resposta de erro que descreve o motivo 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

Create or update a dedicated host .

Sample Request

HTTP

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

Status code:: 201

{
  "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}"
  }
}

Status code:: 200

{
  "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

Name	Description
ApiError	Erro de API.
ApiErrorBase	Base de erros da API.
CloudError	Uma resposta de erro do serviço de Computação.
DedicatedHost	Especifica informações sobre o Anfitrião dedicado.
DedicatedHostAllocatableVM	Representa a capacidade não otimizada do anfitrião dedicado em termos de um tamanho de VM específico.
DedicatedHostAvailableCapacity	Capacidade não otimizada do anfitrião dedicado.
DedicatedHostInstanceView	A vista de instância de um anfitrião dedicado.
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.
InnerError	Detalhes do erro interno.
InstanceViewStatus	Estado da vista de instância.
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 ligado, terá de desalocar as VMs no conjunto de dimensionamento antes de modificar o nome do SKU.
StatusLevelTypes	O código de nível.
SubResourceReadOnly

ApiError

Erro de API.

Name	Tipo	Description
code	string	O código de erro.
details	ApiErrorBase[]	Os detalhes do erro da API
innererror	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	ApiError	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 for 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	DedicatedHostInstanceView	A vista de instância de anfitrião dedicada.
properties.licenseType	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.
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	SubResourceReadOnly[]	Uma lista de referências a todas as máquinas virtuais no Anfitrião Dedicado.
sku	Sku	SKU do anfitrião dedicado para Geração de Hardware e família de VMs. Só é necessário definir o nome. Liste os 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 é representada.

DedicatedHostAvailableCapacity

Capacidade não otimizada do anfitrião dedicado.

Name	Tipo	Description
allocatableVMs	DedicatedHostAllocatableVM[]	A capacidade não utilizada do anfitrião dedicado representado em termos de cada tamanho de VM que tem permissão para ser implementado no anfitrião dedicado.

DedicatedHostInstanceView

A vista de instância de um anfitrião dedicado.

Name	Tipo	Description
assetId	string	Especifica o ID exclusivo do computador físico dedicado no qual reside o anfitrião dedicado.
availableCapacity	DedicatedHostAvailableCapacity	Capacidade não otimizada do anfitrião dedicado.
statuses	InstanceViewStatus[]	As informações de 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 sistema 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	StatusLevelTypes	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.

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 ligado, 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. Valores Possíveis: Standard Básica

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