Tous les produits
Search
Centre de documentation

:CreateNode

Dernière mise à jour :Aug 08, 2026

Ajoute un nœud shard ou mongos à une instance de cluster fragmenté ApsaraDB for MongoDB.

Avant d'appeler cette opération, assurez-vous de bien comprendre les méthodes de facturation et la tarification d'ApsaraDB for MongoDB.

Cette opération s'applique uniquement aux instances de cluster fragmenté.

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

Paramètre Type Obligatoire Exemple Description
Action String Oui CreateNode

Opération à effectuer. Définissez la valeur sur CreateNode.

DBInstanceId String Oui dds-bp11501cd7b5****

ID de l'instance de cluster fragmenté.

NodeClass String Oui dds.shard.mid

Spécifications du nœud shard ou mongos. Pour plus d'informations, consultez Types d'instances.

NodeStorage Integer Non 10

Capacité du disque du nœud. Unité : Go.

Valeurs valides : 10 à 2000. La valeur doit être un multiple de 10. Unité : Go.

Remarque Ce paramètre est obligatoire si le paramètre NodeType est défini sur shard.
NodeType String Oui shard

Type de nœud. Valeurs valides :

  • shard : nœud shard
  • mongos : nœud mongos
ClientToken String Non ETnLKlblzczshOTUbOCz****

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 différentes requêtes. Le jeton ne peut contenir que des caractères ASCII et ne peut pas dépasser 64 caractères.

AutoPay Boolean Non true

Indique si le paiement automatique est activé. Valeur par défaut : true. Valeurs valides :

  • true : active le paiement automatique. Assurez-vous que votre compte dispose d'un solde suffisant.
  • false : désactive le paiement automatique. Pour payer l'instance, connectez-vous à la console ApsaraDB for MongoDB. Dans le coin supérieur droit de la page, choisissez Expenses > Orders. Sur la page Orders, localisez la commande et effectuez le paiement.
Remarque Ce paramètre est obligatoire lorsque la méthode de facturation de l'instance est l'abonnement.
ReadonlyReplicas Integer Non 5

Nombre de nœuds en lecture seule dans le nœud shard.

Valeurs valides : 0 à 5. La valeur doit être un entier. Valeur par défaut : 0.

Remarque Ce paramètre est disponible uniquement pour les instances ApsaraDB for MongoDB achetées sur le site Chine (aliyun.com).
BusinessInfo String Non {“ActivityId":"000000000"}

Informations commerciales. Il s'agit d'un paramètre supplémentaire.

CouponNo String Non youhuiquan_promotion_option_id_for_blank

Code du coupon. Valeur par défaut : youhuiquan_promotion_option_id_for_blank.

ShardDirect Boolean Non false

Indique si un endpoint est demandé pour le nœud shard. Valeur par défaut : false. Valeurs valides :

  • true : demande un endpoint pour le nœud shard.
  • false : ne demande pas d'endpoint pour le nœud shard.
AccountName String Non ceshi

Nom d'utilisateur du compte. Le nom d'utilisateur doit respecter les exigences suivantes :

  • Le nom d'utilisateur commence par une lettre minuscule.
  • Le nom d'utilisateur contient des lettres minuscules, des chiffres et des traits de soulignement (_).
  • Le nom d'utilisateur comporte entre 4 et 16 caractères.
Remarque
  • Les mots-clés ne peuvent pas être utilisés comme noms d'utilisateur de compte.
  • Les autorisations de ce compte sont fixées en lecture seule.
  • Le nom d'utilisateur et le mot de passe ne doivent être définis que lors de la première demande d'endpoint pour le nœud shard.
AccountPassword String Non 123+abc

Mot de passe du compte. Le mot de passe doit respecter les exigences suivantes :

  • Le mot de passe contient au moins trois des types de caractères suivants : lettres majuscules, lettres minuscules, chiffres et caractères spéciaux spécifiques.
  • Ces caractères spéciaux incluent ! @ # $ % ^ & * ( ) _ + - =
  • Le mot de passe comporte entre 8 et 32 caractères.
Remarque Le mot de passe du compte du nœud shard ne peut pas être réinitialisé.

Paramètres de réponse

Paramètre

Type

Exemple

Description

RequestId

String

7D48FB19-20CA-4725-A870-3D8F5CE6****

ID de la requête.

NodeId

String

d-bp1b234bf7a4****

ID du nœud.

OrderId

String

20951063702****

ID de la commande.

Exemples

Exemples de requêtes

http(s)://mongodb.aliyuncs.com/?Action=CreateNode
&DBInstanceId=dds-bp11501cd7b5****
&NodeClass=dds.shard.mid
&NodeStorage=10
&NodeType=shard
&ClientToken=ETnLKlblzczshOTUbOCz****
&FromApp=mongo_buy
&AutoPay=true
&ReadonlyReplicas=5
&BusinessInfo={"ActivityId":"000000000"}
&CouponNo=youhuiquan_promotion_option_id_for_blank
&<Common request parameters>

Exemples de réponses

XML format

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

<CreateNodeResponse>
    <RequestId>7D48FB19-20CA-4725-A870-3D8F5CE6****</RequestId>
    <NodeId>d-bp1b234bf7a4****</NodeId>
    <OrderId>20951063702****</OrderId>
</CreateNodeResponse>

JSON format

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

{
  "RequestId" : "7D48FB19-20CA-4725-A870-3D8F5CE6****",
  "NodeId" : "d-bp1b234bf7a4****",
  "OrderId" : "20951063702****"
}

Codes d'erreur

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