Tous les produits
Search
Centre de documentation

:CreateDedicatedHostGroup

Dernière mise à jour :Aug 11, 2026

Crée un cluster dédié.

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

ParameterTypeRequiredExampleDescription
ActionStringYesCreateDedicatedHostGroup

L'opération que vous souhaitez effectuer. Définissez la valeur sur CreateDedicatedHostGroup.

RegionIdStringYescn-hangzhou

L'ID de la région dans laquelle vous souhaitez créer le cluster dédié. Pour plus d'informations, consultez ID de région.

EngineStringYesMySQL

Le moteur de base de données du cluster dédié. Valeurs valides :

  • MySQL
  • SQL Server
CpuAllocationRatioIntegerNo200 %

Le taux de surallocation CPU du cluster dédié.

Remarque Valeurs valides : 100 % à 300 %. Valeur par défaut : 200 %. Le ratio par défaut indique que le système peut allouer deux fois les ressources CPU fournies. Cela maximise l'utilisation du CPU.
MemAllocationRatioIntegerNo100 %

L'utilisation maximale de la mémoire pour chaque hôte du cluster dédié.

Remarque Valeurs valides : 0 % à 100 %. Valeur par défaut : 100 %.
DiskAllocationRatioIntegerNo200 %

Le taux de surallocation du stockage du cluster dédié.

Remarque Valeurs valides : 100 % à 300 %. Valeur par défaut : 200 %. Le ratio par défaut indique que le système peut allouer deux fois les ressources de stockage fournies. Cela maximise l'utilisation des ressources.
AllocationPolicyStringNoEvenly

La politique utilisée pour allouer les ressources dans le cluster dédié. Valeur par défaut : Evenly. Valeurs valides :

  • Evenly : Le système crée préférentiellement des instances sur les hôtes ayant les charges les plus faibles. Ainsi, les charges sur les hôtes du cluster dédié peuvent être équilibrées. Cela maximise la stabilité du système.
  • Intensively : Le système crée préférentiellement des instances sur les hôtes créés avant les autres et disposant de moins de ressources disponibles que les autres hôtes du cluster dédié. Cela maximise l'utilisation des ressources.
VPCIdStringYesvpc-t4n7v5m6icc0a4314****

L'ID du cloud privé virtuel (VPC) où réside le cluster dédié. Pour afficher l'ID du VPC que vous souhaitez gérer, connectez-vous à la console VPC et cliquez sur VPCs dans le volet de navigation de gauche.

HostReplacePolicyStringNoAuto

La politique utilisée par le système pour gérer les défaillances des hôtes. Valeur par défaut : Auto. Valeurs valides :

  • Auto : Le système remplace automatiquement les hôtes défectueux.
  • Manual : Vous devez remplacer manuellement les hôtes défectueux.
Remarque Vous pouvez sélectionner une politique en fonction de vos besoins professionnels uniquement si le cluster dédié exécute le moteur de base de données MySQL. Pour un cluster dédié exécutant un autre moteur de base de données, la valeur par défaut Auto est utilisée.
ClientTokenStringYesETnLKlblzczshOTUbOCz*******

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 qu'elle est unique parmi les différentes requêtes. Le jeton ne peut contenir que des caractères ASCII et ne doit pas dépasser 64 caractères de longueur.

OpenPermissionIntegerNo1

Indique s'il faut activer la fonctionnalité permettant d'avoir des permissions OS sur les hôtes du cluster dédié. Valeur par défaut : 1. Valeurs valides :

  • 0 : non
  • 1 : oui
Remarque Vous pouvez activer cette fonctionnalité en fonction de vos besoins professionnels uniquement si vous créez un cluster dédié exécutant le moteur de base de données MySQL, SQL Server. Cette fonctionnalité n'est pas disponible pour les clusters dédiés exécutant d'autres moteurs de base de données. Pour ces clusters dédiés, la valeur par défaut 0 est utilisée.
DedicatedHostGroupDescStringNomysqlcluster

Le nom du cluster dédié. Le nom doit comporter entre 1 et 64 caractères et peut contenir des lettres, des chiffres, des traits de soulignement (_) et des tirets (-). Le nom doit commencer par une lettre.

Paramètres de réponse

Parameter Type Example Description

| RequestId | String | C6592723-09E1-4248-A78E-12AB00D7A79D |


L'ID de la requête.

|

| DedicatedHostGroupId | String | dhg-7a9**** |


L'ID du cluster dédié.

|

Exemples

Exemples de requêtes

http(s)://cddc.aliyuncs.com?Action=CreateDedicatedHostGroup
&ClientToken=ETnLKlblzczshOTUbOCz*******
&Engine=MySQL
&RegionId=cn-hangzhou
&VPCId=vpc-t4n7v5m6icc0a4314****
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<CreateDedicatedHostGroupReponse>
<RequestId>C6592723-09E1-4248-A78E-12AB00D7A79D</RequestId>
<DedicatedHostGroupId>dhg-7a9********</DedicatedHostGroupId>
</CreateDedicatedHostGroupReponse>

JSON format

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

{
  "RequestId" : "C6592723-09E1-4248-A78E-12AB00D7A79D",
  "DedicatedHostGroupId" : "dhg-7a9********"
}

Codes d'erreur

HTTP status code Error code Error message Description
403 Permission.NotSupport You are not authorized to perform this action. Le message d'erreur renvoyé car vous n'êtes pas autorisé à effectuer cette opération.
404 ClustersTemplateNotFound Key account cluster is not supported for the region. Le message d'erreur renvoyé car les clusters dédiés ne peuvent pas être créés dans la région spécifiée.

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