CreateDBNodes - - Centre de documentation Alibaba Cloud

Ajoute des nœuds en lecture seule à un cluster PolarDB.

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

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
ResourceGroupId	string	Non	L'identifiant du groupe de ressources.	rg-************
DBClusterId	string	Oui	L'identifiant du cluster.	pc-*************
ClientToken	string	Non	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 la valeur est unique parmi les différentes requêtes. Le jeton est sensible à la casse et ne peut contenir que des caractères ASCII. Le jeton peut comporter jusqu'à 64 caractères.	6000170000591aed949d0f54a343f1a4233c1e7d1c5c******
EndpointBindList	string	Non	L'identifiant du point de terminaison du cluster auquel vous souhaitez ajouter le nouveau nœud. Si vous souhaitez ajouter le nœud à plusieurs points de terminaison, séparez les identifiants des points de terminaison par des virgules (,). Remarque Vous pouvez appeler l'opération DescribeDBClusterEndpoints pour consulter les détails des points de terminaison du cluster, y compris les identifiants des points de terminaison. Vous pouvez spécifier les identifiants du point de terminaison de cluster par défaut et des points de terminaison de cluster personnalisés. Si vous laissez ce paramètre vide, le nouveau nœud est ajouté à tous les points de terminaison du cluster pour lesquels la fonctionnalité Associer automatiquement les nouveaux nœuds est activée (la valeur de `AutoAddNewNodes` est `Enable`).	pe-**************,pe-**************
PlannedStartTime	string	Non	L'heure de début au plus tôt pour l'exécution de la tâche planifiée d'ajout de nœuds. Spécifiez l'heure au format `YYYY-MM-DDThh:mm:ssZ` (UTC). Remarque L'heure de début doit se situer dans les 24 heures suivantes. Par exemple, si l'heure actuelle est `2021-01-14T09:00:00Z`, vous pouvez spécifier une heure de début comprise entre `2021-01-14T09:00:00Z` et `2021-01-15T09:00:00Z`. Si vous laissez ce paramètre vide, la tâche d'ajout de nœuds est exécutée immédiatement.	2021-01-14T09:00:00Z
PlannedEndTime	string	Non	L'heure de début au plus tard pour l'exécution de la tâche planifiée. Spécifiez l'heure au format `YYYY-MM-DDThh:mm:ssZ` (UTC). Remarque L'heure de début au plus tard doit être postérieure d'au moins 30 minutes à l'heure de début. Si vous spécifiez `PlannedStartTime` mais laissez ce paramètre vide, l'heure de début au plus tard par défaut est `heure de début + 30 minutes`. Par exemple, si vous définissez `PlannedStartTime` sur `2021-01-14T09:00:00Z` et laissez ce paramètre vide, la tâche démarre au plus tard à `2021-01-14T09:30:00Z`.	2021-01-14T09:30:00Z
DBNode	array<object>	Oui	Les informations relatives au nouveau nœud.
	object	Non
TargetClass	string	Non	La spécification du nouveau nœud. La spécification doit être identique à celle des nœuds existants. Pour plus d'informations, consultez les rubriques suivantes : PolarDB for MySQL : Spécifications des nœuds de calcul. PolarDB for PostgreSQL (Compatible with Oracle) : Spécifications des nœuds de calcul. PolarDB for PostgreSQL : Spécifications des nœuds de calcul. Remarque Vous devez spécifier au moins l'un des paramètres DBNode.N.ZoneId et DBNode.N.TargetClass. N est un entier commençant à 1. Valeur maximale de N = 16 - nombre actuel de nœuds. Seuls les clusters PolarDB for MySQL prennent en charge l'ajout de plusieurs nœuds en lecture seule à la fois. Vous pouvez ajouter jusqu'à 15 nœuds en lecture seule. Ce paramètre est requis pour les clusters PolarDB for PostgreSQL (Compatible with Oracle) ou PolarDB for PostgreSQL. Ce paramètre est facultatif pour les clusters PolarDB for MySQL.	polar.mysql.x4.medium
ZoneId	string	Non	La zone du nouveau nœud. La zone doit être identique à celle des nœuds existants. Vous pouvez appeler l'opération DescribeRegions pour interroger les identifiants de zone. Remarque Vous devez spécifier au moins l'un des paramètres DBNode.N.ZoneId et DBNode.N.TargetClass. N est un entier commençant à 1. Valeur maximale de N = 16 - nombre actuel de nœuds. Seuls les clusters PolarDB for MySQL prennent en charge l'ajout de plusieurs nœuds en lecture seule à la fois. Vous pouvez ajouter jusqu'à 15 nœuds en lecture seule. Ce paramètre est requis pour les clusters PolarDB for PostgreSQL (Compatible with Oracle) ou PolarDB for PostgreSQL. Ce paramètre est facultatif pour les clusters PolarDB for MySQL.	cn-qingdao-c
DBNodeType	string	Non	Le type de nœud. Valeurs valides : RO STANDBY DLNode. Valeurs valides : DLNode : Nœud d'IA. STANDBY : Nœud de secours. RO : Nœud en lecture seule.	RO
ImciSwitch	string	Non	Indique si l'index de colonnes en mémoire (IMCI) doit être activé. Valeurs valides : ON : activé. OFF : désactivé. Il s'agit de la valeur par défaut. Remarque PolarDB for PostgreSQL (Compatible with Oracle) et PolarDB for PostgreSQL ne prennent pas en charge ce paramètre.	ON
CloudProvider	string	Non	Le fournisseur de services cloud auquel le nœud appartient.	ENS
AutoUseCoupon	boolean	Non	Indique si les coupons doivent être utilisés automatiquement. Valeurs valides : true (par défaut) : utiliser les coupons. false : ne pas utiliser les coupons.
PromotionCode	string	Non	Le code de coupon. Si vous ne spécifiez pas ce paramètre, le coupon par défaut est utilisé.	727xxxxxx934

Éléments de réponse

Élément	Type	Description	Exemple
	object
DBNodeIds	object
DBNodeId	array	La liste des DBNodeId créés.
	string	La liste des DBNodeId créés.	pi-***************
RequestId	string	L'identifiant de la requête.	E053E730-5755-4AA9-AA9D-A47867******
DBClusterId	string	L'identifiant du cluster.	pc-***************
OrderId	string	L'identifiant de la commande.	2148126708*****

Exemples

JSON format

{
  "DBNodeIds": {
    "DBNodeId": [
      "pi-***************"
    ]
  },
  "RequestId": "E053E730-5755-4AA9-AA9D-A47867******",
  "DBClusterId": "pc-***************",
  "OrderId": "2148126708*****"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	ORDER.ARREARAGE	您有欠费账单，不符合购买条件，请先结清账单后再购买	You must settle the overdue payments for your account before you can make a purchase.
400	InvalidDBNodeNum.Malformed	The number of parameter DBNode.N is not valid.	The specified number of database nodes is invalid.
400	InvalidDBNode.Malformed	The specified parameter DBNode.N is not valid.	The specified DBNode.N parameter is invalid.
400	OperationDenied.CreateDBNodesWithStrictConsistencyOn	3AZ cluster does not allow create db nodes.	Nodes cannot be added for multi-zone clusters.
400	InvalidZoneId.Malformed	The specified parameter ZoneId is not valid.	The specified ZoneId parameter is invalid.
403	OperationDenied.ClusterCategory	The operation is not permitted due to cluster category.	This series is not supported by the cluster.
403	OperationDenied.DbVersion	The operation is not permitted due to DbVersion.	This operation is not supported by the database version.
404	InvalidDBClusterId.NotFound	The DBClusterId provided does not exist in our records.	The specified DBClusterId parameter does not exist in the current record.
404	InvalidDBClusterId.Malformed	The specified parameter DBClusterId is not valid.	The specified DBClusterId parameter is invalid.

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

Notes de version

Consultez Notes de version pour la liste complète.