ModifyDBInstanceSpec - - Centre de documentation Alibaba Cloud

Modifie les spécifications ou l'espace de stockage des instances autonomes, des instances de jeu de réplicas et des instances serverless d'ApsaraDB for MongoDB. Les instances serverless sont prises en charge uniquement sur le site chinois d'Alibaba Cloud.

Description de l'opération

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 autonomes et instances de jeu de réplicas d'ApsaraDB for MongoDB. Pour modifier les configurations d'une instance de cluster shardé, appelez l'opération ModifyNodeSpec, CreateNode, DeleteNode ou ModifyNodeSpecBatch en fonction de vos besoins métier.

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

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

dds:ModifyDBInstanceSpec

update

*Instance

acs:dds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
DBInstanceId	string	Oui	L'identifiant de l'instance.	dds-bp1ea17b41ab****
DBInstanceClass	string	Non	Le type d'instance. Pour plus d'informations, consultez Types d'instances. Vous pouvez également appeler l'opération DescribeAvailableResource pour interroger les types d'instances. Pour les instances autonomes et les instances de jeu de réplicas, ce paramètre spécifie le type d'instance. Pour plus d'informations, consultez Types d'instances. Vous pouvez également appeler l'opération DescribeAvailableResource pour interroger les types d'instances autonomes et d'instances de jeu de réplicas. Pour les instances serverless, ce paramètre spécifie les spécifications de calcul de l'instance. Valeurs valides : 100 à 8000. Remarque Vous devez spécifier au moins l'un des paramètres DBInstanceClass et DBInstanceStorage.	dds.sn4.xlarge.1
DBInstanceStorage	string	Non	Espace de stockage de l'instance. Valeurs valides : 10 à 3000. Unité : Go. Le pas est de 10 Go. Les valeurs valides dépendent du type d'instance. Pour plus d'informations, consultez Types d'instances. Remarque Vous devez spécifier au moins l'un des paramètres DBInstanceStorage et DBInstanceClass. Vous ne pouvez pas réduire l'espace de stockage de l'instance.	50
OrderType	string	Non	Le type de modification de configuration. Valeurs valides : UPGRADE : met à niveau les configurations. Il s'agit de la valeur par défaut. DOWNGRADE : rétrograde les configurations. Remarque Vous ne pouvez spécifier ce paramètre que lorsque l'instance utilise la méthode de facturation par abonnement.	UPGRADE
AutoPay	boolean	Non	Indique si le paiement automatique doit être activé pour l'instance. Valeurs valides : true : active le paiement automatique. Il s'agit de la valeur par défaut. Assurez-vous que votre compte dispose d'un solde suffisant. false : désactive le paiement automatique. Vous devez payer manuellement la commande dans la console. Connectez-vous à la console ApsaraDB for MongoDB. Dans le coin supérieur droit de la page, choisissez Dépenses > Dépenses et coûts. Dans le volet de navigation gauche, cliquez sur Gestion des commandes. Sur la page Commandes, recherchez la commande et procédez au paiement.	true
BusinessInfo	string	Non	Les informations métier.	{“ActivityId":"000000000"}
ReplicationFactor	string	Non	Le nombre de nœuds dans l'instance. Valeur par défaut : 3. Pour une instance de jeu de réplicas, les valeurs valides sont 3, 5 et 7. Pour une instance autonome, la valeur est fixée à 1. Pour une instance de jeu de réplicas qui utilise le stockage partagé (prise en charge uniquement sur le site chinois d'Alibaba Cloud), la valeur est fixée à 2. Remarque Vous n'avez pas besoin de spécifier ce paramètre pour une instance serverless (prise en charge uniquement sur le site chinois d'Alibaba Cloud).	3
ReadonlyReplicas	string	Non	Le nombre de nœuds en lecture seule. Valeurs valides : 0 à 5. Si l'instance est connectée uniquement via le réseau classique et un VPC, vous devez activer l'accès à Internet ou libérer le réseau classique avant de pouvoir modifier le nombre de nœuds en lecture seule. Remarque Vous pouvez vous connecter à la console ApsaraDB for MongoDB et afficher les types de réseau activés sur la page Connexions à la base de données.	1
CouponNo	string	Non	Indique si un coupon doit être utilisé. Valeurs valides : default ou null : utilise un coupon. Il s'agit de la valeur par défaut. youhuiquan_promotion_option_id_for_blank : n'utilise pas de coupon.	default
EffectiveTime	string	Non	L'heure à laquelle la modification de configuration prend effet. Valeurs valides : Immediately : prend effet immédiatement. Il s'agit de la valeur par défaut. MaintainTime : prend effet pendant la fenêtre de maintenance de l'instance.	Immediately
ExtraParam	string	Non	Le paramètre supplémentaire. Valeurs valides : async : renvoie le résultat après la création de la commande de modification de configuration. sync : renvoie le résultat lorsque la modification de configuration est appliquée après la création de la commande. Valeurs valides : async : async. sync : sync.	async
TargetZoneId	string	Non	La zone de destination pour la migration de l'instance lorsque vous migrez l'instance entre plusieurs zones et modifiez ses configurations en même temps. Important Ce paramètre est pris en charge uniquement pour les instances sur disque cloud. Important La valeur de ce paramètre ne peut pas être identique à la valeur du paramètre TargetSecondaryZoneId ou TargetHiddenZoneId. Remarque Vous ne devez spécifier ce paramètre que lorsque vous migrez l'instance entre plusieurs zones et modifiez ses configurations en même temps. La zone de destination et la zone actuelle de l'instance doivent se trouver dans la même région. Vous pouvez appeler l'opération DescribeRegions pour interroger les identifiants de zone.	cn-hangzhou-j
TargetSecondaryZoneId	string	Non	La zone de destination pour le nœud secondaire lorsque vous migrez une instance sur disque cloud entre plusieurs zones et modifiez ses configurations en même temps. Important Ce paramètre est pris en charge uniquement pour les instances qui utilisent des disques cloud. Important La valeur de ce paramètre ne peut pas être identique à la valeur du paramètre TargetZoneId ou TargetHiddenZoneId. Remarque Vous ne devez spécifier ce paramètre que lorsque vous migrez une instance sur disque cloud entre plusieurs zones et modifiez ses configurations en même temps. Ce paramètre est disponible uniquement pour la migration multi-zones. La zone de destination et la zone actuelle de l'instance doivent se trouver dans la même région. Vous pouvez appeler l'opération DescribeRegions pour interroger les identifiants de zone.	cn-hangzhou-h
TargetHiddenZoneId	string	Non	La zone de destination pour le nœud masqué lorsque vous migrez une instance sur disque cloud entre plusieurs zones et modifiez ses configurations en même temps. Important Ce paramètre est pris en charge uniquement pour les instances qui utilisent des disques cloud. Important La valeur de ce paramètre ne peut pas être identique à la valeur du paramètre TargetZoneId ou TargetSecondaryZoneId. Remarque Vous ne devez spécifier ce paramètre que lorsque vous migrez une instance sur disque cloud entre plusieurs zones et modifiez ses configurations en même temps. Ce paramètre est disponible uniquement pour la migration multi-zones. La zone de destination et la zone actuelle de l'instance doivent se trouver dans la même région. Vous pouvez appeler l'opération DescribeRegions pour interroger les identifiants de zone.	cn-hangzhou-i
TargetVswitchId	string	Non	Indique si le nœud principal doit être automatiquement aligné sur la zone principale pour une instance multi-zones après des opérations telles que des modifications de configuration. Si vous choisissez de ne pas aligner le nœud, un basculement principal/secondaire (déconnexion transitoire) est évité. Valeur par défaut : true (aligné).	vsw-bp1buy0h9myt5i9e7****
SearchNodeClass	string	Non	L'identifiant du vSwitch de destination lorsque vous migrez une instance sur disque cloud entre plusieurs zones et modifiez ses configurations en même temps. Important Ce paramètre est pris en charge uniquement pour les instances qui utilisent des disques cloud. Remarque Vous ne devez spécifier ce paramètre que lorsque vous migrez une instance sur disque cloud entre plusieurs zones et modifiez ses configurations en même temps.	vsw-bp1buy0h9myt5i9e7****
SearchNodeStorage	integer	Non	Les spécifications du nœud de recherche pour la modification de configuration.	mdb.shard.2x.xlarge.d
SearchNodeCount	integer	Non	La capacité de stockage du nœud de recherche pour la modification de configuration.	20

Éléments de réponse

Élément	Type	Description	Exemple
	object
OrderId	string	L'identifiant de la commande.	21012408824****
RequestId	string	L'identifiant de la requête.	1E9F1104-19E7-59F0-AB7F-F4EBFDEA****

Exemples

JSON format

{
  "OrderId": "21012408824****",
  "RequestId": "1E9F1104-19E7-59F0-AB7F-F4EBFDEA****"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	MissingParameter	The input parameters DBInstanceClass and DBInstanceStorage all blank or no change.
400	InvalidDBInstanceClass.ValueNotSupported	The specified parameter DBInstanceClass is not valid.
400	InvalidDBInstanceStorage.ValueNotSupported	The specified parameter DBInstanceStorage is not valid.
400	LX_REQUEST_TOKEN_CONFLICT	The request token is conflict.
400	TradeConfirmPayError	BIZ_ERROR - degrade refund error
400	PRICE.ORIGIN_PRICE_ERROR	Origin lingxiao price request error.
400	ErrorInsufficientResource	There is not enough resource for your operation, requestId: %s.	Ressources insuffisantes. Sélectionnez une autre région ou soumettez un ticket.
403	OperationDenied	The resource is out of usage.	La ressource n'est plus utilisée.
403	InvaildDBInstanceClassInRegion.NotAvailable	The DBInstanceClass in the Region is not available.
404	InvalidDBInstanceId.NotFound	The DBInstanceId provided does not exist in our records.

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

Notes de version

Consultez Notes de version pour la liste complète.