AllocateDedicatedHosts - - Centre de documentation Alibaba Cloud

Description

Avant de créer un hôte dédié, appelez l'opération DescribeAvailableResource pour interroger les ressources disponibles dans une région ou une zone spécifique.

Nous vous recommandons de comprendre les méthodes de facturation des ressources avant de créer un hôte dédié. Les ressources utilisées par l'hôte dédié créé vous sont facturées. Pour plus d'informations, consultez la rubrique Présentation de la facturation .

Vous pouvez créer jusqu'à 100 hôtes dédiés en paiement à l'utilisation ou par abonnement en une seule fois.
Une fois l'hôte dédié créé, utilisez l'ID de l'hôte dédié renvoyé comme valeur d'un paramètre de requête pour appeler l'opération DescribeDedicatedHosts et interroger l'état de l'hôte dédié.
Si un paramètre n'est pas valide ou si les ressources demandées sont insuffisantes lors de la soumission d'une demande de création d'hôte dédié, une erreur est renvoyée. Pour plus d'informations sur les causes d'erreur, consultez la section « Codes d'erreur » de cette rubrique.
Une fois l'hôte dédié créé, appelez l'opération ModifyInstanceDeployment pour migrer des instances ECS d'un hôte partagé vers l'hôte dédié. Vous pouvez également migrer des instances ECS d'un autre hôte dédié vers l'hôte dédié que vous venez de créer.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour votre commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	AllocateDedicatedHosts	L'opération à effectuer. Définissez la valeur sur AllocateDedicatedHosts.
RegionId	String	Yes	cn-hangzhou	L'ID de la région dans laquelle créer l'hôte dédié. Appelez l'opération DescribeRegions pour interroger la liste des régions la plus récente.
Tag.N.Key	String	No	Environment	La clé du tag N à ajouter à l'hôte dédié. Valeurs valides de N : 1 à 20. La clé du tag ne peut pas être une chaîne vide. Sa longueur maximale est de 128 caractères et elle ne peut pas commencer par acs: ou aliyun. Elle ne peut pas contenir `http://` ni `https://`.
Tag.N.Value	String	No	Production	La valeur du tag N à ajouter à l'hôte dédié. Valeurs valides de N : 1 à 20. La valeur du tag peut être une chaîne vide. Sa longueur maximale est de 128 caractères et elle ne peut pas commencer par acs: ni contenir `http://` ou `https://`.
ResourceGroupId	String	No	rg-bp67acfmxazb4ph***	L'ID du groupe de ressources auquel attribuer l'hôte dédié.
ZoneId	String	No	cn-hangzhou-f	L'ID de la zone dans laquelle créer l'hôte dédié. Ce paramètre est vide par défaut. Si vous ne spécifiez pas de zone, le système en sélectionne une.
DedicatedHostName	String	No	myDDH	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://` ni `https://`. Il peut contenir des lettres, des chiffres, des deux-points (:), des traits de soulignement (_) et des traits d'union (-).
DedicatedHostClusterId	String	No	dc-bp12wlf6am0vz9v2****	L'ID du cluster d'hôtes dédiés dans lequel créer l'hôte dédié.
DedicatedHostType	String	Yes	ddh.c5	Le type d'hôte dédié. Appelez l'opération DescribeDedicatedHostTypes pour interroger la liste la plus récente des types d'hôtes dédiés.
ActionOnMaintenance	String	No	Migrate	La politique utilisée pour migrer les 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 un autre serveur physique et redémarrées. Si des disques cloud sont attachés à l'hôte dédié, la valeur par défaut est Migrate. 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 locaux sont attachés à l'hôte dédié, 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.
Description	String	No	This-is-my-DDH	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://` ni `https://`.
AutoPlacement	String	No	off	Indique s'il faut ajouter l'hôte dédié au pool de ressources pour le déploiement automatique. Si vous créez une instance ECS sur un hôte dédié sans spécifier le paramètre DedicatedHostId, Alibaba Cloud sélectionne un hôte dédié dans le pool de ressources pour héberger l'instance. Pour plus d'informations, consultez la rubrique Déploiement automatique. 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. Valeur par défaut : on. Remarque Si vous ne souhaitez pas ajouter l'hôte dédié au pool de ressources pour le déploiement automatique, définissez la valeur sur off.
CpuOverCommitRatio	Float	No	1	Le ratio de surcommit CPU. Vous pouvez configurer les ratios de surcommit CPU uniquement pour les types d'hôtes dédiés suivants : g6s, c6s et r6s. Valeurs valides : 1 à 5. Le ratio de surcommit CPU affecte le nombre de vCPU disponibles sur un hôte dédié. Utilisez la formule suivante pour calculer le nombre de vCPU disponibles sur un hôte dédié : Nombre de vCPU disponibles = Nombre de cœurs CPU physiques × 2 × Ratio de surcommit CPU. Par exemple, le nombre de cœurs CPU physiques sur chaque hôte dédié g6s est de 52. Si vous définissez le ratio de surcommit CPU d'un hôte dédié g6s sur 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 CPU ou dont la charge CPU 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 ratio de surcommit CPU. De cette façon, 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.
MinQuantity	Integer	No	2	Le nombre minimum d'hôtes dédiés à créer. Valeurs valides : 1 à 100. Remarque Si le nombre d'hôtes dédiés que les ressources disponibles permettent de créer est inférieur au nombre minimum d'hôtes dédiés à créer, la création des hôtes dédiés échoue.
ChargeType	String	No	PrePaid	La méthode de facturation de l'hôte dédié. Valeurs valides : PrePaid : abonnement. Si vous définissez ce paramètre sur PrePaid, assurez-vous que votre solde de compte ou vos crédits sont suffisants. Sinon, `InvalidPayMethod` est renvoyé. PostPaid : paiement à l'utilisation. Valeur par défaut : PostPaid.
Quantity	Integer	No	2	Le nombre d'hôtes dédiés que vous souhaitez créer. Valeurs valides : 1 à 100. Valeur par défaut : 1.
Period	Integer	No	6	La durée d'abonnement de l'hôte dédié. Le paramètre `Period` est requis et prend effet uniquement lorsque le paramètre `ChargeType` est défini sur `PrePaid`. Valeurs valides : Valeurs valides lorsque le paramètre PeriodUnit est défini sur Month : 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48 et 60. Valeurs valides lorsque le paramètre PeriodUnit est défini sur Year : 1, 2, 3, 4 et 5.
PeriodUnit	String	No	Month	L'unité de la durée d'abonnement de l'hôte dédié. Valeurs valides : Month Year Valeur par défaut : Month.
AutoRenew	Boolean	No	false	Indique s'il faut renouveler automatiquement l'hôte dédié par abonnement. Remarque Le paramètre AutoRenew prend effet uniquement lorsque le paramètre ChargeType est défini sur PrePaid. Valeur par défaut : false.
AutoRenewPeriod	Integer	No	1	La durée de renouvellement automatique de l'hôte dédié. Le paramètre AutoRenewPeriod prend effet et est requis uniquement lorsque le paramètre AutoRenew est défini sur true. Valeurs valides : Valeurs valides lorsque PeriodUnit est défini sur Month : 1, 2, 3, 6 et 12.
AutoReleaseTime	String	No	2019-08-21T12:30:24Z	L'heure à laquelle libérer automatiquement l'hôte dédié. Spécifiez l'heure selon la norme `ISO 8601` au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être en UTC. Remarque Elle doit être postérieure d'au moins une demi-heure à l'heure actuelle. Elle doit être antérieure d'au plus trois ans à l'heure actuelle. Si la valeur des secondes (ss) n'est pas 00, elle est automatiquement définie sur 00.
ClientToken	String	No	123e4567-e89b-12d3-a456-426655440000	Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer la valeur, mais vous devez vous assurer que celle-ci est unique parmi différentes requêtes. La valeur ClientToken ne peut contenir que des caractères ASCII et ne peut pas dépasser 64 caractères. Pour plus d'informations, consultez la rubrique Comment garantir l'idempotence.

Paramètres de réponse

Parameter

Type

Example

Description

RequestId

String

E2A664A6-2933-4C64-88AE-5033D003****

L'ID de la requête.

DedicatedHostIdSets

Array of String

"DedicatedHostIdSets":{"DedicatedHostId":["dh-bp67acfmxazb4p**", "dh-bp67acfmxazb4d**"]}

Les ID des hôtes dédiés.

Exemples

Exemples de requêtes

http(s)://ecs.aliyuncs.com/?Action=AllocateDedicatedHosts
&RegionId=cn-hangzhou
&DedicatedHostType=ddh.sn1ne
&Quantity=2
&ChargeType=PostPaid
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<AllocateDedicatedHostsResponse>
    <RequestId>E2A664A6-2933-4C64-88AE-5033D003EADF</RequestId>
    <DedicatedHostIdSets>
        <DedicatedHostId>dh-bp67acfmxazb4p****</DedicatedHostId>
        <DedicatedHostId>dh-bp67acfmxazb4d****</DedicatedHostId>
    </DedicatedHostIdSets>
</AllocateDedicatedHostsResponse>

JSON format

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

{
  "RequestId" : "E2A664A6-2933-4C64-88AE-5033D003EADF",
  "DedicatedHostIdSets" : {
    "DedicatedHostId" : [ "dh-bp67acfmxazb4p****", "dh-bp67acfmxazb4d****" ]
  }
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.	Le message d'erreur renvoyé indique que vous n'êtes pas autorisé à utiliser le type d'instance spécifié.
400	InvalidDescription.Malformed	The specified parameter "Description" is not valid.	Le message d'erreur renvoyé indique que le paramètre Description spécifié n'est pas valide. La description doit comporter entre 2 et 256 caractères et ne peut pas commencer par http:// ou https://.
400	InvalidParameter.Conflict	The specified region and cluster do not match.	Le message d'erreur renvoyé indique que la région spécifiée et le cluster spécifié ne correspondent pas.
400	InvalidAutoRenewPeriod.ValueNotSupported	The specified autoRenewPeriod is not valid.	Le message d'erreur renvoyé indique que le paramètre AutoRenewPeriod spécifié n'est pas valide.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Le message d'erreur renvoyé indique que le paramètre Tag.N.Key spécifié n'est pas valide.
400	InvalidDedicatedHostType.ValueNotSupported	%s	Le message d'erreur renvoyé indique que le paramètre DedicatedHostType spécifié n'est pas valide.
400	RegionUnauthorized	%s	Le message d'erreur renvoyé indique que vous n'êtes pas autorisé à effectuer l'opération dans la région spécifiée. %s est une variable. Un message d'erreur est renvoyé dynamiquement en fonction des conditions d'appel.
400	Zone.NotOnSale	%s	Le message d'erreur renvoyé indique que les ressources demandées ne sont pas disponibles dans la zone spécifiée. %s est une variable. Un message d'erreur est renvoyé dynamiquement en fonction des conditions d'appel.
400	OperationDenied	The specified DedicatedHostType or Zone is not available or not authorized.	Le message d'erreur renvoyé indique que le type d'hôte dédié ou la zone spécifiée n'est pas disponible, ou que vous n'êtes pas autorisé à gérer les ressources.
400	InvalidPeriodUnit.ValueNotSupported	The specified parameter PeriodUnit is not valid.	Le message d'erreur renvoyé indique que le paramètre PeriodUnit spécifié n'est pas valide.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Le message d'erreur renvoyé indique que le paramètre Tag.N.Value spécifié n'est pas valide.
400	QuotaExceed.AfterpayDedicatedHost	The maximum number of Pay-As-You-Go DedicatedHosts is exceeded: %s	Le message d'erreur renvoyé indique que les ressources en paiement à l'utilisation du type d'hôte dédié spécifié sont insuffisantes. Réduisez le nombre d'hôtes dédiés à créer.
400	InvalidChargeType.ValueNotSupported	ChargeType is not valid	Le message d'erreur renvoyé indique que le paramètre ChargeType spécifié n'est pas valide.
400	InvalidParameter.SlbUdpTimeout	The specified value is invalid.	Le message d'erreur renvoyé indique que le paramètre NetworkAttributes.SlbUdpTimeout spécifié n'est pas valide.
400	InvalidParameter.UdpTimeout	The specified value is invalid.	Le message d'erreur renvoyé indique que le paramètre NetworkAttributes.UdpTimeout spécifié n'est pas valide.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Le message d'erreur renvoyé indique que la clé de tag spécifiée existe déjà. Les clés de tag doivent être uniques.
403	OperationDenied	The creation of Host to the specified Zone is not allowed.	Le message d'erreur renvoyé indique que vous n'êtes pas autorisé à créer des hôtes dédiés dans la zone spécifiée.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone; try other types of resources or other regions and zones.	Le message d'erreur renvoyé indique que les ressources demandées ne sont pas disponibles dans la zone spécifiée. Essayez un autre type d'instance ou une autre zone. Appelez l'opération DescribeZones pour interroger les ressources disponibles.
403	OperationDenied	Sales of this resource are temporarily suspended in the specified region; please try again later.	Le message d'erreur renvoyé indique que les ressources demandées ne sont pas disponibles dans la région spécifiée. Réessayez ultérieurement.
403	NodeControllerUnavailable	The Node Controller is temporarily unavailable.	Le message d'erreur renvoyé indique que le contrôleur de nœud n'est pas disponible.
403	OperationDenied	The resource is out of usage.	Le message d'erreur renvoyé indique que l'instance n'est pas dans l'état Running. Démarrez l'instance ou vérifiez si l'opération spécifiée est valide.
403	InvalidParameter.ResourceOwnerAccount	ResourceOwnerAccount is Invalid.	Le message d'erreur renvoyé indique que le paramètre ResourceOwnerAccount spécifié n'est pas valide.
403	Zone.NotOpen	The specified zone is not granted to you to buy resources yet.	Le message d'erreur renvoyé indique que vous n'êtes pas autorisé à acheter des ressources dans la zone spécifiée.
403	Zone.NotOnSale	The specified zone is not available for purchase.	Le message d'erreur renvoyé indique que les ressources demandées ne sont pas disponibles dans la zone spécifiée. Essayez un autre type d'instance ou sélectionnez une autre région ou zone.
403	InvalidDedicatedHostType.ValueNotSupported	The specified DedicatedHostType does not exist or beyond the permitted range.	Le message d'erreur renvoyé indique que le paramètre DedicatedHostType spécifié n'existe pas.
403	InvalidDedicatedHostType.ZoneNotSupported	The specified zone does not support this dedicatedHostType.	Le message d'erreur renvoyé indique que le type d'hôte dédié spécifié n'est pas pris en charge dans la zone spécifiée.
403	InvalidParameter.NotMatch	%s	Le message d'erreur renvoyé indique qu'un paramètre spécifié n'est pas valide. Vérifiez l'existence de conflits de paramètres.
403	Account.Arrearage	Your account has been in arrears.	Le message d'erreur renvoyé indique que le solde de votre compte est insuffisant. Approvisionnez votre compte Alibaba Cloud et réessayez.
404	OperationDenied	Another Host has been creating	Le message d'erreur renvoyé indique qu'un autre hôte est en cours de création.
404	PaymentMethodNotFound	No payment method has been registered on the account.	Le message d'erreur renvoyé indique que vous n'avez pas configuré de méthode de paiement pour votre compte.
404	InvalidDedicatedHostName.Malformed	The specified parameter DedicatedHostName is not valid.	Le message d'erreur renvoyé indique que le paramètre DedicatedHostName spécifié n'est pas valide.
500	InternalError	The request processing has failed due to some unknown error.	Le message d'erreur renvoyé indique qu'une erreur interne s'est produite. Réessayez ultérieurement.
500	InternalError	%s	Le message d'erreur renvoyé indique qu'une erreur interne s'est produite.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API .