Dedicated Hosts - Create Or Update

Referencia

Service:: Compute

API Version:: 2024-03-01

Cree o actualice un 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 identificador URI

Nombre	En	Requerido	Tipo	Description
hostGroupName	path	True	string	Nombre del grupo host dedicado.
hostName	path	True	string	Nombre del host dedicado.
resourceGroupName	path	True	string	Nombre del grupo de recursos.
subscriptionId	path	True	string	Credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI para cada llamada al servicio.
api-version	query	True	string	Versión de api de cliente.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
location	True	string	Ubicación de los recursos
sku	True	Sku	SKU del host dedicado para la generación de hardware y la familia de máquinas virtuales. Solo es necesario establecer el nombre. Enumere las SKU de Microsoft.Compute para obtener una lista de los valores posibles.
properties.autoReplaceOnFailure		boolean	Especifica si el host dedicado se debe reemplazar automáticamente en caso de error. El valor predeterminado es "true" cuando no se proporciona.
properties.licenseType		DedicatedHostLicenseTypes	Especifica el tipo de licencia de software que se aplicará a las máquinas virtuales implementadas en el host dedicado. Los valores posibles son: None,Windows_Server_Hybrid,Windows_Server_Perpetual. El valor predeterminado es: None.
properties.platformFaultDomain		integer	Dominio de error del host dedicado dentro de un grupo host dedicado.
tags		object	Etiquetas del recurso

Respuestas

Nombre	Tipo	Description
200 OK	DedicatedHost	Aceptar
201 Created	DedicatedHost	Creado
Other Status Codes	CloudError	Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

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

Definiciones

Nombre	Description
ApiError	Error de API.
ApiErrorBase	Base de errores de API.
CloudError	Respuesta de error del servicio Compute.
DedicatedHost	Especifica información sobre el host dedicado.
DedicatedHostAllocatableVM	Representa la capacidad no utilizada del host dedicado en términos de un tamaño de máquina virtual específico.
DedicatedHostAvailableCapacity	Capacidad no utilizada del host dedicado.
DedicatedHostInstanceView	Vista de instancia de un host dedicado.
DedicatedHostLicenseTypes	Especifica el tipo de licencia de software que se aplicará a las máquinas virtuales implementadas en el host dedicado. Los valores posibles son: None,Windows_Server_Hybrid,Windows_Server_Perpetual. El valor predeterminado es: None.
InnerError	Detalles del error interno.
InstanceViewStatus	Estado de la vista de instancia.
Sku	Describe una SKU de conjunto de escalado de máquinas virtuales. NOTA: Si la nueva SKU de máquina virtual no se admite en el hardware en el que se encuentra actualmente el conjunto de escalado, debe desasignar las máquinas virtuales del conjunto de escalado antes de modificar el nombre de la SKU.
StatusLevelTypes	Código de nivel.
SubResourceReadOnly

ApiError

Error de API.

Nombre	Tipo	Description
code	string	Código de error.
details	ApiErrorBase[]	Detalles del error de api
innererror	InnerError	Error interno de api
message	string	El mensaje de error.
target	string	Destino del error concreto.

ApiErrorBase

Base de errores de API.

Nombre	Tipo	Description
code	string	Código de error.
message	string	El mensaje de error.
target	string	Destino del error concreto.

CloudError

Respuesta de error del servicio Compute.

Nombre	Tipo	Description
error	ApiError	Error de API.

DedicatedHost

Especifica información sobre el host dedicado.

Nombre	Tipo	Description
id	string	Id. de recurso
location	string	Ubicación de los recursos
name	string	Nombre del recurso
properties.autoReplaceOnFailure	boolean	Especifica si el host dedicado se debe reemplazar automáticamente en caso de error. El valor predeterminado es "true" cuando no se proporciona.
properties.hostId	string	Identificador único generado y asignado al host dedicado por la plataforma. No cambia durante toda la duración del host.
properties.instanceView	DedicatedHostInstanceView	Vista de instancia de host dedicada.
properties.licenseType	DedicatedHostLicenseTypes	Especifica el tipo de licencia de software que se aplicará a las máquinas virtuales implementadas en el host dedicado. Los valores posibles son: None,Windows_Server_Hybrid,Windows_Server_Perpetual. El valor predeterminado es: None.
properties.platformFaultDomain	integer	Dominio de error del host dedicado dentro de un grupo host dedicado.
properties.provisioningState	string	El estado de aprovisionamiento, que solo aparece en la respuesta.
properties.provisioningTime	string	Fecha en la que se aprovisionó por primera vez el host.
properties.timeCreated	string	Especifica la hora en la que se creó el recurso host dedicado. Versión mínima de api: 2021-11-01.
properties.virtualMachines	SubResourceReadOnly[]	Lista de referencias a todas las máquinas virtuales del host dedicado.
sku	Sku	SKU del host dedicado para la generación de hardware y la familia de máquinas virtuales. Solo es necesario establecer el nombre. Enumere las SKU de Microsoft.Compute para obtener una lista de los valores posibles.
tags	object	Etiquetas del recurso
type	string	Tipo de recurso

DedicatedHostAllocatableVM

Representa la capacidad no utilizada del host dedicado en términos de un tamaño de máquina virtual específico.

Nombre	Tipo	Description
count	number	Número máximo de máquinas virtuales de tamaño vmSize que pueden caber en la capacidad restante del host dedicado.
vmSize	string	Tamaño de máquina virtual en términos de la cual se representa la capacidad no utilizada.

DedicatedHostAvailableCapacity

Capacidad no utilizada del host dedicado.

Nombre	Tipo	Description
allocatableVMs	DedicatedHostAllocatableVM[]	La capacidad no utilizada del host dedicado representada en términos de cada tamaño de máquina virtual que se puede implementar en el host dedicado.

DedicatedHostInstanceView

Vista de instancia de un host dedicado.

Nombre	Tipo	Description
assetId	string	Especifica el identificador único de la máquina física dedicada en la que reside el host dedicado.
availableCapacity	DedicatedHostAvailableCapacity	Capacidad no utilizada del host dedicado.
statuses	InstanceViewStatus[]	Información de estado del recurso.

DedicatedHostLicenseTypes

Especifica el tipo de licencia de software que se aplicará a las máquinas virtuales implementadas en el host dedicado. Los valores posibles son: None,Windows_Server_Hybrid,Windows_Server_Perpetual. El valor predeterminado es: None.

Nombre	Tipo	Description
None	string
Windows_Server_Hybrid	string
Windows_Server_Perpetual	string

InnerError

Detalles del error interno.

Nombre	Tipo	Description
errordetail	string	Mensaje de error interno o volcado de memoria de excepciones.
exceptiontype	string	Tipo de la excepción.

InstanceViewStatus

Estado de la vista de instancia.

Nombre	Tipo	Description
code	string	Código de estado.
displayStatus	string	Etiqueta localizable corta para el estado.
level	StatusLevelTypes	Código de nivel.
message	string	Mensaje de estado detallado, incluido para alertas y mensajes de error.
time	string	Hora del estado.

Sku

Describe una SKU de conjunto de escalado de máquinas virtuales. NOTA: Si la nueva SKU de máquina virtual no se admite en el hardware en el que se encuentra actualmente el conjunto de escalado, debe desasignar las máquinas virtuales del conjunto de escalado antes de modificar el nombre de la SKU.

Nombre	Tipo	Description
capacity	integer	Especifica el número de máquinas virtuales del conjunto de escalado.
name	string	Nombre de la SKU.
tier	string	Especifica el nivel de máquinas virtuales de un conjunto de escalado. Valores posibles: Estándar Basic

StatusLevelTypes

Código de nivel.

Nombre	Tipo	Description
Error	string
Info	string
Warning	string

SubResourceReadOnly

Nombre	Tipo	Description
id	string	Id. de recurso