ModifyDedicatedHostAttribute - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Toutes les instances Elastic Compute Service (ECS) hébergées sur un hôte dédié doivent être à l’état Arrêté (Stopped) avant que vous ne puissiez modifier le taux de surcommit du processeur de l’hôte dédié.
Les modifications apportées au taux de surcommit du processeur d’un hôte dédié n’affectent pas le fonctionnement de cet hôte. Une fois le taux modifié, le nombre de vCPU alloués sur l’hôte dédié ne peut pas dépasser le nouveau nombre total de vCPU. Dans le cas contraire, les instances ECS utilisant les vCPU excédentaires ne pourront pas démarrer.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	ModifyDedicatedHostAttribute	L’opération que vous souhaitez effectuer. Définissez la valeur sur ModifyDedicatedHostAttribute.
RegionId	String	Yes	cn-hangzhou	L’ID de région de l’hôte dédié. Vous pouvez appeler l’opération DescribeRegions pour interroger la liste des régions la plus récente.
DedicatedHostId	String	Yes	dh-bp165p6xk2tlw61e****	L’ID de l’hôte dédié.
DedicatedHostName	String	No	testDedicatedHostName	Le nom de l’hôte dédié. Le nom doit comporter entre 2 et 128 caractères. Il doit commencer par une lettre et ne peut pas commencer par http:// ou https://. Le nom peut contenir des lettres, des chiffres, des deux-points (:), des traits de soulignement (_) et des traits d’union (-).
Description	String	No	testDescription	La description de l’hôte dédié. La description doit comporter entre 2 et 256 caractères et ne peut pas commencer par `http://` ou `https://`.
ActionOnMaintenance	String	No	Migrate	La politique de migration des instances déployées sur l’hôte dédié lorsque celui-ci tombe en panne ou doit être réparé en ligne. Valeurs valides : Migrate : les instances sont migrées vers une autre machine physique, puis redémarrées. Stop : les instances sont arrêtées. Si l’hôte dédié ne peut pas être réparé, les instances sont migrées vers une autre machine physique, puis redémarrées. Si l’hôte dédié dispose de disques cloud attachés, la valeur par défaut est Migrate. Si l’hôte dédié dispose de disques locaux attachés, la valeur par défaut est Stop.
NetworkAttributes.SlbUdpTimeout	Integer	No	60	Le délai d’expiration d’une session UDP entre une instance Server Load Balancer (SLB) et l’hôte dédié. Unité : secondes. Valeurs valides : 15 à 310.
NetworkAttributes.UdpTimeout	Integer	No	60	Le délai d’expiration d’une session UDP entre un utilisateur et un service Alibaba Cloud sur l’hôte dédié. Unité : secondes. Valeurs valides : 15 à 310.
AutoPlacement	String	No	on	Indique s’il faut ajouter l’hôte dédié au pool de ressources pour le déploiement automatique. Si vous ne spécifiez pas le paramètre DedicatedHostId lors de la création d’une instance sur un hôte dédié, Alibaba Cloud sélectionne automatiquement un hôte dédié dans le pool de ressources pour héberger l’instance. Valeurs valides : on : ajoute l’hôte dédié au pool de ressources pour le déploiement automatique. off : n’ajoute pas l’hôte dédié au pool de ressources pour le déploiement automatique. Pour plus d’informations sur le déploiement automatique, consultez la rubrique Features.
DedicatedHostClusterId	String	No	dc-bp165p6xk2tlw61e****	L’ID du cluster d’hôtes dédiés auquel appartient l’hôte dédié.
CpuOverCommitRatio	Float	No	1	Le taux de surcommit du processeur. Vous pouvez définir des taux de surcommit du processeur uniquement pour les types d’hôtes dédiés suivants : g6s, c6s et r6s. Valeurs valides : 1 à 5. Le taux de surcommit du processeur affecte le nombre de vCPU disponibles sur un hôte dédié. Vous pouvez utiliser la formule suivante pour calculer le nombre de vCPU disponibles sur un hôte dédié : Nombre de vCPU disponibles = Nombre de cœurs de processeur physiques × 2 × Taux de surcommit du processeur. Par exemple, le nombre de cœurs de processeur physiques sur chaque hôte dédié g6s est de 52. Si vous modifiez le taux de surcommit du processeur d’un hôte dédié g6s à 4, le nombre de vCPU disponibles sur l’hôte dédié est de 416. Pour les scénarios ayant des exigences minimales en matière de stabilité du processeur ou où la charge du processeur n’est pas élevée, tels que les environnements de développement et de test, vous pouvez augmenter le nombre de vCPU disponibles sur un hôte dédié en augmentant le taux de surcommit du processeur. Ainsi, vous pouvez déployer davantage d’instances ECS de mêmes spécifications sur l’hôte dédié et réduire le coût unitaire de déploiement.

Paramètres de réponse

Parameter

Type

Example

Description

RequestId

String

2A4EA075-CB5B-41B7-B0EB-70D339F6****

L’ID de la requête.

Exemples

Exemple de requête

http(s)://ecs.aliyuncs.com/?Action=ModifyDedicatedHostAttribute
&DedicatedHostId=dh-bp165p6xk2tlw61e****
&RegionId=cn-hangzhou
&<Common request parameters>

Exemple de réponse réussie

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyDedicatedHostAttributeResponse>
    <RequestId>2A4EA075-CB5B-41B7-B0EB-70D339F6****</RequestId>
</ModifyDedicatedHostAttributeResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "2A4EA075-CB5B-41B7-B0EB-70D339F6****"
}

Codes d’erreur

HTTP status code	Error code	Error message	Description
400	InvalidDedicatedHostName.Malformed	The specified parameter DedicatedHostName is not valid.	Valeur DedicatedHostName non valide.
400	InvalidDescription.Malformed	The specified parameter Description is not valid.	Format de description non valide. La description doit comporter entre 2 et 256 caractères et ne peut pas commencer par http:// ou https://.
400	InvalidParameter.SlbUdpTimeout	The specified value is invalid.	Valeur NetworkAttributes.SlbUdpTimeout non valide.
400	InvalidParameter.UdpTimeout	The specified value is invalid.	Valeur NetworkAttributes.UdpTimeout non valide.
403	InvalidUser.Unauthorized	The user is not authorized	Vous n’êtes pas autorisé à effectuer cette opération.
404	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.	La valeur DedicatedHostId est introuvable.
404	InvalidParameter.ActionOnMaintenance	The specified ActionOnMaintenance does not exist.	La valeur ActionOnMaintenance est introuvable.

Pour obtenir la liste des codes d’erreur, consultez la rubrique Codes d’erreur de service.