Dedicated Hosts - Update
Actualice un host dedicado.
PATCH 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 |
---|---|---|---|---|
host
|
path | True |
string |
Nombre del grupo host dedicado. |
host
|
path | True |
string |
Nombre del host dedicado. |
resource
|
path | True |
string |
Nombre del grupo de recursos. |
subscription
|
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 | Tipo | Description |
---|---|---|
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 |
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. |
sku |
[Enumerar todos los tamaños de host dedicados disponibles para cambiar el tamaño] (https://docs.microsoft.com/rest/api/compute/dedicated-hosts/listavailablesizes). El cambio de tamaño solo se puede usar para escalar verticalmente DedicatedHost. Solo es necesario establecer el nombre. |
|
tags |
object |
Etiquetas del recurso |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Aceptar |
|
Other Status Codes |
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
Dedicated |
Dedicated |
Dedicated |
DedicatedHost_Update_MaximumSet_Gen
Sample Request
PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/hostGroups/aaaaaaaaa/hosts/aaaaaaaaaaaaaaaaaaaaa?api-version=2024-03-01
{
"properties": {
"platformFaultDomain": 1,
"autoReplaceOnFailure": true,
"licenseType": "Windows_Server_Hybrid",
"instanceView": {
"availableCapacity": {
"allocatableVMs": [
{
"vmSize": "aaaaaaaaaaaaaaaaaaaa",
"count": 26
}
]
},
"statuses": [
{
"code": "aaaaaaaaaaaaaaaaaaaaaaa",
"level": "Info",
"displayStatus": "aaaaaa",
"message": "a",
"time": "2021-11-30T12:58:26.522Z"
}
]
}
},
"tags": {
"key8813": "aaaaaaaaaaaaaaaaaaaaaaaaaaa"
}
}
Sample Response
{
"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"
}
DedicatedHost_Update_MinimumSet_Gen
Sample Request
PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/hostGroups/aa/hosts/aaaaaaaaaaaaaaaaaaaaaaaaaa?api-version=2024-03-01
{}
Sample Response
{
"location": "westus",
"sku": {}
}
DedicatedHost_Update_Resize
Sample Request
PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/hostGroups/aaaaaaaaa/hosts/aaaaaaaaaaaaaaaaaaaaa?api-version=2024-03-01
{
"sku": {
"name": "DSv3-Type1"
}
}
Sample Response
{
"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"
},
"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"
}
Definiciones
Nombre | Description |
---|---|
Api |
Error de api. |
Api |
Base de errores de api. |
Cloud |
Respuesta de error del servicio Compute. |
Dedicated |
Especifica información sobre el host dedicado. |
Dedicated |
Representa la capacidad no utilizada del host dedicado en términos de un tamaño de máquina virtual específico. |
Dedicated |
Capacidad no utilizada del host dedicado. |
Dedicated |
Vista de instancia de un host dedicado. |
Dedicated |
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. |
Dedicated |
Especifica información sobre el host dedicado. Solo se pueden actualizar las etiquetas autoReplaceOnFailure y licenseType. |
Inner |
Detalles del error interno. |
Instance |
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 está activado el conjunto de escalado, debe desasignar las máquinas virtuales del conjunto de escalado antes de modificar el nombre de la SKU. |
Status |
El código de nivel. |
Sub |
ApiError
Error de api.
Nombre | Tipo | Description |
---|---|---|
code |
string |
Código de error. |
details |
Detalles del error de api |
|
innererror |
Error interno de api |
|
message |
string |
El mensaje de error. |
target |
string |
Destino del error determinado. |
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 determinado. |
CloudError
Respuesta de error del servicio Compute.
Nombre | Tipo | Description |
---|---|---|
error |
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 vigencia del host. |
properties.instanceView |
Vista de instancia de host dedicada. |
|
properties.licenseType |
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 |
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 |
Lista de referencias a todas las máquinas virtuales del host dedicado. |
|
sku |
SKU del host dedicado para la familia de máquinas virtuales y generación de hardware. Solo es necesario establecer el nombre. Enumere las SKU de Microsoft.Compute para obtener una lista de 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 |
Capacidad no utilizada del host dedicado representado en términos de cada tamaño de máquina virtual que se permite 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 |
Capacidad no utilizada del host dedicado. |
|
statuses |
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 |
DedicatedHostUpdate
Especifica información sobre el host dedicado. Solo se pueden actualizar las etiquetas autoReplaceOnFailure y licenseType.
Nombre | Tipo | Description |
---|---|---|
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 vigencia del host. |
properties.instanceView |
Vista de instancia de host dedicada. |
|
properties.licenseType |
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 |
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 |
Lista de referencias a todas las máquinas virtuales del host dedicado. |
|
sku |
[Enumerar todos los tamaños de host dedicados disponibles para cambiar el tamaño] (https://docs.microsoft.com/rest/api/compute/dedicated-hosts/listavailablesizes). El cambio de tamaño solo se puede usar para escalar verticalmente DedicatedHost. Solo es necesario establecer el nombre. |
|
tags |
object |
Etiquetas del recurso |
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 |
El código de nivel. |
|
message |
string |
Mensaje de estado detallado, incluidas las alertas y los 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 está activado 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. |
StatusLevelTypes
El código de nivel.
Nombre | Tipo | Description |
---|---|---|
Error |
string |
|
Info |
string |
|
Warning |
string |
SubResourceReadOnly
Nombre | Tipo | Description |
---|---|---|
id |
string |
Id. de recurso |