Todos los productos
Search
Centro de documentos

:ModifyDBInstanceSpec

Última actualización: Sep 03, 2026

Modifica las especificaciones o el espacio de almacenamiento de una instancia independiente, de conjunto de réplicas o serverless de ApsaraDB for MongoDB. Las instancias serverless están disponibles únicamente en el sitio de China (aliyun.com).

Antes de llamar a esta operación, asegúrese de comprender los métodos de facturación y la información de precios de ApsaraDB for MongoDB.

Esta operación se aplica únicamente a instancias independientes y de conjunto de réplicas. Para modificar las especificaciones de instancias de clúster fragmentado, llame a la operación ModifyNodeSpec, CreateNode, DeleteNode o ModifyNodeSpecBatch.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro Tipo Obligatorio Ejemplo Descripción
Action String Sí ModifyDBInstanceSpec

La operación que desea ejecutar. Establezca el valor en ModifyDBInstanceSpec.

RegionId String No cn-hangzhou

El ID de región de la instancia. Llame a la operación DescribeRegions para consultar la lista de regiones más reciente.

DBInstanceId String Sí dds-bp1ea17b41ab****

El ID de la instancia.

DBInstanceClass String No dds.sn4.xlarge.1

El tipo de instancia. Para obtener más información, consulte Tipos de instancia. También puede llamar a la operación DescribeAvailableResource para ver los tipos de instancia.

Nota Debe especificar como mínimo uno de los parámetros DBInstanceClass y DBInstanceStorage.
DBInstanceStorage String No 50

La capacidad de almacenamiento de la instancia. Valores válidos: de 10 a 3000. El valor debe ser múltiplo de 10. Unidad: GB. Los valores admisibles para este parámetro dependen del tipo de instancia. Para obtener más información, consulte Tipos de instancia.

Nota
  • Debe especificar como mínimo uno de los parámetros DBInstanceStorage y DBInstanceClass.
  • La capacidad de almacenamiento solo se puede reducir en instancias de conjunto de réplicas con modelo pay-as-you-go. La nueva capacidad de almacenamiento que especifique debe ser mayor que la capacidad utilizada.
OrderType String No UPGRADE

El tipo de modificación. Valores válidos:

  • UPGRADE
  • DOWNGRADE
Nota Este parámetro solo se puede configurar cuando el método de facturación de la instancia es suscripción.
AutoPay Boolean No true

Especifica si se habilita el pago automático. Valor predeterminado: true. Valores válidos:

  • true: habilita el pago automático. Asegúrese de que su cuenta de Alibaba Cloud tenga saldo suficiente.
  • false: deshabilita el pago automático. Siga estos pasos para pagar la instancia: inicie sesión en la consola de ApsaraDB for MongoDB. En la esquina superior derecha de la página, elija Expenses > User Center. En el panel de navegación izquierdo, elija Order Management > Order. En la pestaña Orders for Services, busque el pedido y páguelo.
BusinessInfo String No {“ActivityId":"000000000"}

La información comercial.

ReplicationFactor String No 3

El número de nodos en la instancia.

  • Valores válidos para instancias de conjunto de réplicas: 3, 5 y 7
  • Valores válidos para instancias independientes: 1
Nota Este parámetro no es obligatorio para una instancia serverless, disponible únicamente en el sitio de China (aliyun.com).
ReadonlyReplicas String No 1

El número de nodos de solo lectura. Valores válidos: de 0 a 5.

Si su instancia solo tiene endpoints de Classic Network y VPC, solicite un endpoint público o libere el endpoint de red clásica antes de cambiar el valor de Read-only Nodes.

Nota Vaya a la página Database Connections para consultar los tipos de red habilitados.
CouponNo String No youhuiquan_promotion_option_id_for_blank

El código de cupón. Valor predeterminado: youhuiquan_promotion_option_id_for_blank.

EffectiveTime String No Immediately

El momento en que surten efecto las configuraciones modificadas. Valor predeterminado: Immediately. Valores válidos:

  • Immediately: las configuraciones surten efecto de inmediato.
  • MaintainTime: las configuraciones surten efecto durante la ventana de mantenimiento de la instancia.

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

RequestId

String

1E9F1104-19E7-59F0-AB7F-F4EBFDEA****

El ID de la solicitud.

OrderId

String

21012408824****

El ID del pedido.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

Formato XML

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

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

Formato JSON

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

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

Códigos de error

Para consultar una lista de códigos de error, visite el Centro de errores de API.