ModifyDBInstanceSpec - - Centre de documentation Alibaba Cloud

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

Cette opération s'applique uniquement aux instances autonomes et en jeu de réplicas. Pour modifier les spécifications des instances en cluster fragmenté, appelez les opérations ModifyNodeSpec, CreateNode, DeleteNode ou ModifyNodeSpecBatch.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Par commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. Celui-ci génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	ModifyDBInstanceSpec	Opération à effectuer. Définissez la valeur sur ModifyDBInstanceSpec.
RegionId	String	Non	cn-hangzhou	ID de région de l'instance. Appelez l'opération DescribeRegions pour consulter la liste des régions les plus récentes.
DBInstanceId	String	Oui	dds-bp1ea17b41ab****	ID de l'instance.
DBInstanceClass	String	Non	dds.sn4.xlarge.1	Type d'instance. Pour plus d'informations, consultez les types d'instance. Vous pouvez également appeler l'opération DescribeAvailableResource pour afficher les types d'instance. Remarque Spécifiez au moins l'un des paramètres DBInstanceClass et DBInstanceStorage.
DBInstanceStorage	String	Non	50	Capacité de stockage de l'instance. Valeurs valides : 10 à 3000. La valeur doit être un multiple de 10. Unité : Go. Les valeurs pouvant être spécifiées pour ce paramètre dépendent des types d'instance. Pour plus d'informations, consultez les types d'instance. Remarque Spécifiez au moins l'un des paramètres DBInstanceStorage et DBInstanceClass. La réduction de la capacité de stockage n'est possible que pour les instances en jeu de réplicas en paiement à l'utilisation. La nouvelle capacité de stockage que vous spécifiez doit être supérieure à la capacité de stockage utilisée.
OrderType	String	Non	UPGRADE	Type de modification. Valeurs valides : UPGRADE DOWNGRADE Remarque Ce paramètre ne peut être configuré que lorsque la méthode de facturation de l'instance est l'abonnement.
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 Alibaba Cloud dispose d'un solde suffisant. false : désactive le paiement automatique. Réglez l'instance en suivant la procédure ci-dessous : Connectez-vous à la console ApsaraDB for MongoDB. Dans le coin supérieur droit de la page, choisissez Expenses > User Center. Dans le volet de navigation de gauche, choisissez Order Management > Order. Dans l'onglet Orders for Services, localisez la commande et effectuez le paiement.
BusinessInfo	String	Non	{“ActivityId":"000000000"}	Informations commerciales.
ReplicationFactor	String	Non	3	Nombre de nœuds dans l'instance. Valeurs valides pour les instances en jeu de réplicas : 3, 5 et 7 Valeurs valides pour les instances autonomes : 1 Remarque Ce paramètre n'est pas requis pour une instance serverless, disponible uniquement sur le site Chine (aliyun.com).
ReadonlyReplicas	String	Non	1	Nombre de nœuds en lecture seule. Valeurs valides : 0 à 5. Si votre instance ne dispose que de points de terminaison Classic Network et VPC, demandez un point de terminaison public ou libérez le point de terminaison du réseau classique pour l'instance avant de pouvoir modifier la valeur de Read-only Nodes. Remarque Accédez à la page Database Connections pour afficher les types de réseaux activés.
CouponNo	String	Non	youhuiquan_promotion_option_id_for_blank	Code du coupon. Valeur par défaut : `youhuiquan_promotion_option_id_for_blank`.
EffectiveTime	String	Non	Immediately	Moment où les modifications de configuration prennent effet. Valeur par défaut : Immediately. Valeurs valides : Immediately : les configurations prennent effet immédiatement. MaintainTime : les configurations prennent effet pendant la fenêtre de maintenance de l'instance.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	1E9F1104-19E7-59F0-AB7F-F4EBFDEA****	ID de la requête.
OrderId	String	21012408824****	ID de la commande.

Exemples

Exemples de requêtes

http(s)://mongodb.aliyuncs.com/?Action=ModifyDBInstanceSpec
&DBInstanceId=dds-bp1ea17b41ab****
&DBInstanceClass=dds.sn4.xlarge.1
&DBInstanceStorage=50
&OrderType=UPGRADE
&AutoPay=true
&BusinessInfo={“ActivityId":"000000000"}
&ReplicationFactor=3
&ReadonlyReplicas=1
&CouponNo=youhuiquan_promotion_option_id_for_blank
&EffectiveTime=Immediately
&Common request parameters

Exemples de réponses réussies

XML format

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

<ModifyDBInstanceSpecResponse>
    <RequestId>1E9F1104-19E7-59F0-AB7F-F4EBFDEA****</RequestId>
    <OrderId>21012408824****</OrderId>
</ModifyDBInstanceSpecResponse>

JSON format

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

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

Codes d'erreur

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