ModifyDBInstanceSpec - ApsaraDB for MongoDB - Centro de documentación de Alibaba Cloud

Cambia el tipo de instancia o el espacio de almacenamiento para instancias independientes, de conjunto de réplicas o serverless de ApsaraDB for MongoDB. Las instancias serverless están disponibles exclusivamente en el sitio web de Alibaba Cloud China.

Descripción de la operación

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

Esta operación se aplica únicamente a instanciasindependientes y de conjunto de réplicas de ApsaraDB for MongoDB. Para cambiar la configuración de una instancia de clúster fragmentado, llame a las operaciones ModifyNodeSpec, CreateNode, DeleteNode o ModifyNodeSpecBatch.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

dds:ModifyDBInstanceSpec

update

*Instance

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
DBInstanceId	string	Sí	El ID de la instancia.	dds-bp1ea17b41ab****
DBInstanceClass	string	No	El tipo de instancia. Para obtener más información, consulte Tipos de instancia. También puede llamar a la operación DescribeAvailableResource para consultar los tipos de instancia. Para una instancia independiente o de conjunto de réplicas, este parámetro especifica el tipo de instancia. Para obtener más información, consulte Tipos de instancia. También puede llamar a la operación DescribeAvailableResource para consultar los tipos de instancia independientes y de conjunto de réplicas. Para una instancia serverless, este parámetro especifica la capacidad de cómputo de la instancia. Valores válidos: de 100 a 8000. Nota Debe configurar uno de los parámetros DBInstanceStorage o DBInstanceClass.	dds.sn4.xlarge.1
DBInstanceStorage	string	No	La capacidad de almacenamiento de la instancia. El valor debe ser un número entero mayor o igual a 10. El valor aumenta en incrementos de 10. Unidad: GB. Los valores que se pueden especificar para este parámetro están sujetos al tipo de instancia. Para obtener más información, consulte Tipos de instancia. Nota Debe configurar uno de los parámetros DBInstanceClass o DBInstanceStorage. No puede reducir la capacidad de almacenamiento de una instancia.	50
OrderType	string	No	El tipo de cambio de especificaciones. Valores válidos: UPGRADE: actualiza las especificaciones. Este es el valor predeterminado. DOWNGRADE: reduce las especificaciones. Nota Este parámetro está disponible solo para instancias de suscripción.	UPGRADE
AutoPay	boolean	No	Especifica si se debe habilitar el pago automático para la instancia. Valores válidos: true: habilita el pago automático. Asegúrese de que su cuenta tenga saldo suficiente. Este es el valor predeterminado. false: deshabilita el pago automático. Puede iniciar sesión en la consola de ApsaraDB for MongoDB para pagar la instancia. En la esquina superior derecha de la página, seleccione Gestión de facturación > Gestión de facturación. En el panel de navegación izquierdo, haga clic en Pedidos. En la página Pedidos de productos, busque el pedido y complete el pago.	true
BusinessInfo	string	No	La información comercial.	{“ActivityId":"000000000"}
ReplicationFactor	string	No	El número de nodos en la instancia. Valor predeterminado: 3. Valores válidos para instancias de conjunto de réplicas: 3, 5 y 7. El valor para instancias independientes es fijo en 1. El valor para instancias de conjunto de réplicas con almacenamiento compartido (disponible solo en el sitio de China) es fijo en 2. Nota Este parámetro no es necesario para instancias serverless (disponibles solo en el sitio de China).	3
ReadonlyReplicas	string	No	El número de nodos de solo lectura. Valores válidos: de 0 a 5. Si el tipo de red de la instancia está configurado únicamente como red clásica y VPC, debe habilitar el acceso público o liberar el endpoint de red clásica antes de poder cambiar el número de nodos de solo lectura. Nota Puede iniciar sesión en la consola de ApsaraDB for MongoDB e ir a la página Conexiones de base de datos para ver los tipos de red que se han habilitado.	1
CouponNo	string	No	Especifica si se debe usar un cupón. Valores válidos: default o null (predeterminado): se usa un cupón. youhuiquan_promotion_option_id_for_blank: no se usa ningún cupón.	default
EffectiveTime	string	No	La hora de entrada en vigor del cambio de configuración. Valores válidos: Immediately: el cambio de configuración entra en vigor inmediatamente. Este es el valor predeterminado. MaintainTime: el cambio de configuración entra en vigor durante la ventana de mantenimiento de la instancia.	Immediately
ExtraParam	string	No	Parámetros adicionales. Valores válidos: async: el resultado se devuelve después de crear el pedido de cambio de especificaciones. sync: el resultado se devuelve después de entregar el cambio de especificaciones de la instancia. Valores válidos: async : async. sync : sync.	async
TargetZoneId	string	No	La zona de destino a la que desea migrar la instancia cuando cambia las especificaciones y migra la instancia entre zonas. Importante Este parámetro se aplica únicamente a instancias de disco en la nube. Importante El valor de este parámetro no puede ser igual al valor del parámetro TargetSecondaryZoneId o TargetHiddenZoneId. Nota Debe especificar este parámetro únicamente cuando cambie las especificaciones y migre la instancia entre zonas. La zona de destino y la zona actual deben estar en la misma región. Puede llamar a la operación DescribeRegions para consultar los ID de zona.	cn-hangzhou-j
TargetSecondaryZoneId	string	No	La zona secundaria de destino para el nodo secundario cuando cambia las especificaciones y migra la instancia entre zonas. Importante Este parámetro se aplica únicamente a instancias de disco en la nube. Importante El valor de este parámetro no puede ser igual al valor del parámetro TargetZoneId o TargetHiddenZoneId. Nota Debe especificar este parámetro únicamente cuando cambie las especificaciones y migre la instancia entre zonas. Este parámetro está disponible solo para migración entre múltiples zonas. La zona de destino y la zona actual deben estar en la misma región. Puede llamar a la operación DescribeRegions para consultar los ID de zona.	cn-hangzhou-h
TargetHiddenZoneId	string	No	La zona de destino para el nodo oculto cuando cambia las especificaciones y migra la instancia entre zonas. Importante Este parámetro se aplica únicamente a instancias de disco en la nube. Importante El valor de este parámetro no puede ser igual al valor del parámetro TargetZoneId o TargetSecondaryZoneId. Nota Debe especificar este parámetro únicamente cuando cambie las especificaciones y migre la instancia entre zonas. Este parámetro está disponible solo para migración entre múltiples zonas. La zona de destino y la zona actual deben estar en la misma región. Puede llamar a la operación DescribeRegions para consultar los ID de zona.	cn-hangzhou-i
TargetVswitchId	string	No	El ID de vSwitch de destino cuando cambia las especificaciones y migra la instancia entre zonas. Importante Este parámetro se aplica únicamente a instancias de disco en la nube. Nota Debe especificar este parámetro únicamente cuando cambie las especificaciones y migre la instancia entre zonas.	vsw-bp1buy0h9myt5i9e7****
SearchNodeClass	string	No	Las especificaciones del nodo Search que se van a cambiar.	mdb.shard.2x.xlarge.d
SearchNodeStorage	integer	No	La capacidad del nodo Search que se va a cambiar.	20
SearchNodeCount	integer	No	El número de nodos Search que se van a cambiar.	2

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	1E9F1104-19E7-59F0-AB7F-F4EBFDEA****
OrderId	string	El ID del pedido.	21012408824****

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
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.	There is not enough resource for your operation, requestId: %s.
403	OperationDenied	The resource is out of usage.
403	InvaildDBInstanceClassInRegion.NotAvailable	The DBInstanceClass in the Region is not available.
404	InvalidDBInstanceId.NotFound	The DBInstanceId provided does not exist in our records.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.