ModifyDedicatedHostAttribute - Elastic Compute Service - Centre de documentation Alibaba Cloud

Modifie les informations relatives à un hôte dédié, telles que le nom, la description et la stratégie de migration des instances appliquée en cas de défaillance de l'hôte dédié.

Description de l'opération

Remarques sur l'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 de pouvoir modifier le taux de surallocation de processeur de l'hôte dédié.
Les modifications du taux de surallocation de processeur d'un hôte dédié n'affectent pas l'état de fonctionnement de l'hôte dédié. Une fois le taux de surallocation de processeur 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 qui utilisent les vCPU excédentaires ne pourront pas démarrer.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

ecs:ModifyDedicatedHostAttribute

update

*DedicatedHost

acs:ecs:{#regionId}:{#accountId}:ddh/{#ddhId}

DedicatedHostCluster

acs:ecs:{#regionId}:{#accountId}:ddhcluster/{#ddhclusterId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région où se trouve l'hôte dédié. Vous pouvez appeler l'opération DescribeRegions pour interroger la liste des régions la plus récente.	cn-hangzhou
DedicatedHostId	string	Oui	L'identifiant de l'hôte dédié.	dh-bp165p6xk2tlw61e****
DedicatedHostName	string	Non	Le nom de l'hôte dédié. Le nom doit comporter de 2 à 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 (-).	testDedicatedHostName
Description	string	Non	La description de l'hôte dédié. La description doit comporter de 2 à 256 caractères et ne peut pas commencer par `http://` ou `https://`.	testDescription
ActionOnMaintenance	string	Non	La stratégie de migration des instances déployées sur l'hôte dédié lorsque l'hôte dédié 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 des disques cloud sont attachés à l'hôte dédié, la valeur par défaut est Migrate. Si des disques locaux sont attachés à l'hôte dédié, la valeur par défaut est Stop.	Migrate
NetworkAttributes.SlbUdpTimeout	integer	Non	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.	60
NetworkAttributes.UdpTimeout	integer	Non	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.	60
AutoPlacement	string	Non	Indique si l'hôte dédié doit être ajouté au pool de ressources pour le déploiement automatique. Si vous ne spécifiez pas 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 Fonctions et fonctionnalités.	on
DedicatedHostClusterId	string	Non	L'identifiant du cluster d'hôtes dédiés auquel affecter l'hôte dédié.	dc-bp165p6xk2tlw61e****
CpuOverCommitRatio	number	Non	Le taux de surallocation de processeur. Vous ne pouvez configurer des taux de surallocation de processeur que pour les types d'hôtes dédiés suivants : g6s, c6s et r6s. Valeurs valides : 1 à 5. Le taux de surallocation de 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 physique × 2 × Taux de surallocation de processeur. Par exemple, le nombre de cœurs de processeur physique sur chaque hôte dédié g6s est de 52. Si vous modifiez le taux de surallocation de 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 lorsque 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 surallocation de processeur. Cela vous permet de déployer davantage d'instances ECS de mêmes spécifications sur l'hôte dédié et de réduire le coût unitaire de déploiement.	1

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	2A4EA075-CB5B-41B7-B0EB-70D339F6****

Exemples

JSON format

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

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidDedicatedHostName.Malformed	The specified parameter DedicatedHostName is not valid.	The specified DedicatedHostName parameter is invalid.
400	InvalidDescription.Malformed	The specified parameter Description is not valid.	The resource description is invalid. The description must be 2 to 256 characters in length and cannot start with http:// or https://.
400	InvalidParameter.SlbUdpTimeout	The specified value is invalid.	The specified SlbUdpTimeout parameter is invalid.
400	InvalidParameter.UdpTimeout	The specified value is invalid.	The specified UdpTimeout parameter is invalid.
400	InvalidDedicatedHostType.CpuOverCommitRatioNotSupported	%s
400	InvalidCpuOverCommitRatio.ValueNotSupported	%s
403	InvalidUser.Unauthorized	The user is not authorized	You are not authorized to perform this operation.
404	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.
404	InvalidDedicatedHostClusterId.NotFound	The specified DedicatedHostClusterId does not exist.
404	InvalidDedicatedHostClusterId.ExceedMaxSize	The specified Dedicated Host Cluster exceeded max capacity.
404	InvalidDedicatedHostClusterId.NotMatch	The specified DedicatedHostCluster does not match request.
404	InvalidParameter.ActionOnMaintenance	The specified ActionOnMaintenance does not exist.	The specified migration plan does not exist.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.