Modifica algunas propiedades de un host dedicado, como el nombre, la descripción y la directiva de migración de instancias que se aplica cuando el host dedicado falla.
Notas de uso
Todas las instancias de Elastic Compute Service (ECS) alojadas en un host dedicado deben estar en estado Stopped (Stopped) antes de modificar la proporción de sobreasignación de CPU del host dedicado.
Las modificaciones en la proporción de sobreasignación de CPU de un host dedicado no afectan su funcionamiento. Después de modificar esta proporción, el número de vCPU asignadas en el host dedicado no puede exceder el nuevo total de vCPU. De lo contrario, las instancias de ECS que utilicen las vCPU excedentes no podrán iniciarse.
Parámetros de solicitud
|
Parámetro |
Tipo |
Obligatorio |
Ejemplo |
Descripción |
| Action | String | Sí | ModifyDedicatedHostAttribute |
La operación que desea ejecutar. Establezca el valor en ModifyDedicatedHostAttribute. |
| RegionId | String | Sí | cn-hangzhou |
El ID de región del host dedicado. Llame a la operación DescribeRegions para consultar la lista de regiones más reciente. |
| DedicatedHostId | String | Sí | dh-bp165p6xk2tlw61e**** |
El ID del host dedicado. |
| DedicatedHostName | String | No | testDedicatedHostName |
El nombre del host dedicado. Debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra y no puede empezar con http:// o https://. Puede contener letras, dígitos, dos puntos (:), guiones bajos (_) y guiones (-). |
| Description | String | No | testDescription |
La descripción del host dedicado. Debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con |
| ActionOnMaintenance | String | No | Migrate |
La directiva para migrar las instancias desplegadas en el host dedicado cuando este falla o requiere reparación en línea. Valores válidos:
Si el host dedicado tiene discos en la nube conectados, el valor predeterminado es Migrate. Si el host dedicado tiene discos locales conectados, el valor predeterminado es Stop. |
| NetworkAttributes.SlbUdpTimeout | Integer | No | 60 |
El tiempo de espera para una sesión UDP entre una instancia de Server Load Balancer (SLB) y el host dedicado. Unidad: segundos. Valores válidos: de 15 a 310. |
| NetworkAttributes.UdpTimeout | Integer | No | 60 |
El tiempo de espera para una sesión UDP entre un usuario y un servicio de Alibaba Cloud en el host dedicado. Unidad: segundos. Valores válidos: de 15 a 310. |
| AutoPlacement | String | No | on |
Especifica si se agrega el host dedicado al pool de recursos para despliegue automático. Si no especifica el parámetro DedicatedHostId al crear una instancia en un host dedicado, Alibaba Cloud selecciona automáticamente un host dedicado del pool de recursos para alojarla. Valores válidos:
Para obtener información sobre el despliegue automático, consulte Features. |
| DedicatedHostClusterId | String | No | dc-bp165p6xk2tlw61e**** |
El ID del clúster de hosts dedicados al que pertenece el host dedicado. |
| CpuOverCommitRatio | Float | No | 1 |
La proporción de sobreasignación de CPU. Solo puede establecer proporciones de sobreasignación de CPU para los siguientes tipos de hosts dedicados: g6s, c6s y r6s. Valores válidos: de 1 a 5. La proporción de sobreasignación de CPU afecta el número de vCPU disponibles en un host dedicado. Use la siguiente fórmula para calcular dicho número: Número de vCPU disponibles = Número de núcleos físicos de CPU × 2 × Proporción de sobreasignación de CPU. Por ejemplo, el número de núcleos físicos de CPU en cada host dedicado g6s es 52. Si cambia la proporción de sobreasignación de CPU de un host dedicado g6s a 4, el número de vCPU disponibles en el host será 416. En escenarios con requisitos mínimos de estabilidad de CPU o donde la carga de CPU no es alta, como entornos de desarrollo y prueba, puede aumentar el número de vCPU disponibles incrementando la proporción de sobreasignación. Así podrá desplegar más instancias de ECS con las mismas especificaciones en el host dedicado y reducir el costo unitario de despliegue. |
Parámetros de respuesta
|
Parámetro |
Tipo |
Ejemplo |
Descripción |
|
RequestId |
String |
2A4EA075-CB5B-41B7-B0EB-70D339F6**** |
El ID de la solicitud. |
Ejemplos
Solicitudes de ejemplo
http(s)://ecs.aliyuncs.com/?Action=ModifyDedicatedHostAttribute
&DedicatedHostId=dh-bp165p6xk2tlw61e****
&RegionId=cn-hangzhou
&<Common request parameters>
Respuestas exitosas de ejemplo
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<ModifyDedicatedHostAttributeResponse>
<RequestId>2A4EA075-CB5B-41B7-B0EB-70D339F6****</RequestId>
</ModifyDedicatedHostAttributeResponse>Formato JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "2A4EA075-CB5B-41B7-B0EB-70D339F6****"
}Códigos de error
|
Código de estado HTTP |
Código de error |
Mensaje de error |
Descripción |
|
400 |
InvalidDedicatedHostName.Malformed |
The specified parameter DedicatedHostName is not valid. |
Valor de DedicatedHostName no válido. |
|
400 |
InvalidDescription.Malformed |
The specified parameter Description is not valid. |
Formato de Description no válido. La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con http:// o https://. |
|
400 |
InvalidParameter.SlbUdpTimeout |
The specified value is invalid. |
Valor de NetworkAttributes.SlbUdpTimeout no válido. |
|
400 |
InvalidParameter.UdpTimeout |
The specified value is invalid. |
Valor de NetworkAttributes.UdpTimeout no válido. |
|
403 |
InvalidUser.Unauthorized |
The user is not authorized |
No tiene autorización para realizar esta operación. |
|
404 |
InvalidDedicatedHostId.NotFound |
The specified DedicatedHostId does not exist. |
No se encontró el valor de DedicatedHostId. |
|
404 |
InvalidParameter.ActionOnMaintenance |
The specified ActionOnMaintenance does not exist. |
No se encontró el valor de ActionOnMaintenance. |
Para obtener una lista de códigos de error, consulte Códigos de error del servicio.