CreateDedicatedHost - - Centre de documentation Alibaba Cloud

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de 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	CreateDedicatedHost	L'opération que vous souhaitez effectuer. Définissez la valeur sur CreateDedicatedHost.
RegionId	String	Yes	cn-hangzhou	L'ID de la région où le cluster est déployé. Pour obtenir l'ID de la région, consultez ID des régions.
DedicatedHostGroupId	String	Yes	dhg-6w7q18iwt5jo****	L'ID du cluster contenant l'hôte. Pour afficher l'ID du cluster, connectez-vous à la console ApsaraDB MyBase et consultez l'ID du cluster sur la page Dedicated Clusters. Remarque Le moteur de base de données de l'hôte doit être identique à celui du cluster.
ZoneId	String	Yes	cn-hangzhou-i	L'ID de la zone où vous souhaitez déployer l'hôte. Pour obtenir l'ID de la zone, consultez Clusters dédiés.
VSwitchId	String	Yes	vsw-bp133c8ifzxd3iv6q****	L'ID du vSwitch auquel vous souhaitez connecter l'hôte. Vous pouvez afficher l'ID du vSwitch dans la console Virtual Private Cloud (VPC).
HostClass	String	Yes	rds.g6.4xlarge	La spécification de l'hôte. Pour en savoir plus sur les spécifications d'hôtes prises en charge par les différents types de bases de données, consultez Types d'instance des hôtes.
PayType	String	Yes	prepaid	La méthode de facturation. Définissez la valeur sur prepaid. prepaid indique la méthode de facturation par abonnement.
Period	String	No	Month	L'unité de durée de l'abonnement. Valeurs possibles : Year Month
UsedTime	String	No	1	La durée de l'abonnement de l'hôte. Valeurs possibles : Si le paramètre Period est défini sur Year, les valeurs valides pour le paramètre UsedTime sont des entiers compris entre 1 et 5. Si le paramètre Period est défini sur Month, les valeurs valides pour le paramètre UsedTime sont des entiers compris entre 1 et 9.
ClientToken	String	Yes	ETnLKlblzczshOTUbOCzSBZH8****	Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer la valeur. Assurez-vous que le jeton est unique parmi différentes requêtes. Le jeton ne peut contenir que des caractères ASCII et sa longueur maximale est de 64 caractères.
AutoRenew	String	No	false	Indique s'il faut activer la fonction de renouvellement automatique. Valeurs possibles : true : active la fonction de renouvellement automatique. false : désactive la fonction de renouvellement automatique. Remarque Si vous ne spécifiez pas ce paramètre, la valeur par défaut false est utilisée.
ImageCategory	String	No	AliLinux	L'image que vous souhaitez utiliser pour créer l'hôte. Valeurs possibles : WindowsWithMssqlEntAlwaysonLicense : SQL Server Cluster Edition WindowsWithMssqlStdLicense : SQL Server Standard Edition WindowsWithMssqlEntLicense : SQL Server Enterprise Edition WindowsWithMssqlWebLicense : SQL Server Web Edition AliLinux : autres images Remarque Lorsque vous créez un hôte SQL Server, vous devez spécifier une image correspondant à l'édition de l'hôte.
OsPassword	String	No	Test123456	Le mot de passe utilisé pour se connecter à l'hôte. Vous ne pouvez créer un mot de passe que si l'hôte fait partie d'un cluster privé. Le mot de passe doit répondre aux exigences suivantes : La longueur du mot de passe doit être comprise entre 8 et 30 caractères. Le mot de passe doit contenir au moins trois des types de caractères suivants : lettres majuscules, lettres minuscules, chiffres et caractères spéciaux. Les caractères spéciaux suivants sont pris en charge : `( ) \ ~ ! @ # $ % ^ & * - _ + = \| { } [ ] : ; ' < > , . ? /`
HostStorageType	String	No	cloud_essd0	Le type de disque que vous souhaitez utiliser pour l'hôte. Ce paramètre n'est effectif que pour les hôtes Tair. Seuls les deux types de disques suivants sont pris en charge : cloud_essd : Disque SSD amélioré (ESSD) avec niveau de performance (PL) 1 cloud_essd0 : ESSD avec PL 0
HostStorage	String	No	512	La capacité du disque de l'hôte. Ce paramètre n'est effectif que pour les hôtes Tair. Unité : Go. Valeurs possibles : 512 1024 1536 2048 2560 3072 3584 4096

Paramètres de réponse

Parameter	Type	Example	Description
OrderId	Long	102565235	L'ID de la commande.
RequestId	String	C860658E-68A6-46C1-AF6E-3AE7C4D32375	L'ID de la requête.
DedicateHostList	Array of DedicateHostList		Les informations relatives à l'hôte créé.
DedicateHostList
DedicatedHostId	String	ch-bp108dki3wdl6****	L'ID de l'hôte créé.

Exemples

Exemple de requête

http(s)://cddc.aliyuncs.com/?Action=CreateDedicatedHost
&RegionId=cn-hangzhou
&DedicatedHostGroupId=dhg-6w7q18iwt5jo****
&ZoneId=cn-hangzhou-i
&VSwitchId=vsw-bp133c8ifzxd3iv6q****
&HostClass=rds.g6.4xlarge
&PayType=prepaid
&Period=Month
&UsedTime=1
&ClientToken=ETnLKlblzczshOTUbOCzSBZH8****
&AutoRenew=false
&ImageCategory=AliLinux

&<Common request parameters>

Exemple de réponse en cas de succès

XML format

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

<CreateDedicatedHostResponse>
    <OrderId>102565235</OrderId>
    <RequestId>C860658E-68A6-46C1-AF6E-3AE7C4D32375</RequestId>
    <DedicateHostList>
        <DedicatedHostId> ch-bp108dki3wdl6****</DedicatedHostId>
    </DedicateHostList>
</CreateDedicatedHostResponse>

JSON format

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

{
  "OrderId" : 102565235,
  "RequestId" : "C860658E-68A6-46C1-AF6E-3AE7C4D32375",
  "DedicateHostList" : [ {
    "DedicatedHostId" : " ch-bp108dki3wdl6****"
  } ]
}

Codes d'erreur

HttpCode	Error code	Error message	Description
400	InvalidParameter	The parameter is invalid.	Le message d'erreur renvoyé indique qu'un paramètre a une valeur non valide.
400	InvalidAccountPassword.Format	The account password format is invalid.	Le message d'erreur renvoyé indique que le mot de passe spécifié n'est pas valide.
400	InsufficientResourceCapacity	No host is available for the requested instance.	Le message d'erreur renvoyé indique que le système n'a pas pu créer l'hôte en raison de ressources insuffisantes dans le cluster dédié.

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