Modificación de las especificaciones de una instancia - - Centro de documentación de Alibaba Cloud

Puede llamar a la operación ModifyDBInstanceSpec para cambiar el tipo o la capacidad de almacenamiento de una instancia. Esta operación es compatible con instancias principales y de solo lectura. No se admite para instancias de recuperación ante desastres ni temporales.

Antes de llamar a esta operación, asegúrese de cumplir los siguientes requisitos:

La instancia se encuentra en estado Running.
La instancia no tiene tareas de copia de seguridad en curso.
Se especifica como mínimo uno de los parámetros DBInstanceClass y DBInstanceStorage en la solicitud.
Si desea reducir la capacidad de almacenamiento, la nueva capacidad que especifique debe ser mayor o igual a 1.1 veces la capacidad utilizada.
La instancia es principal o de solo lectura.

Nota

Si desea actualizar la edición de RDS de la instancia, seleccione un tipo de instancia compatible con la nueva edición. Por ejemplo, para actualizar de RDS Basic Edition a RDS High-availability Edition, seleccione un tipo de instancia compatible con RDS High-availability Edition.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer 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.
DBInstanceId	String	Sí	rm-uf6wjk5*******	El ID de la instancia.
DBInstanceClass	String	No	rds.mys2.small	El nuevo tipo de la instancia. Para obtener más información, consulte Tipos de instancias principales de ApsaraDB RDS. Puede llamar a la operación DescribeAvailableClasses para consultar los tipos de instancia disponibles en una región. Nota Debe especificar como mínimo uno de los parámetros DBInstanceClass y DBInstanceStorage. Puede llamar a la operación DescribeDBInstanceAttribute para consultar el tipo de instancia en uso.
DBInstanceStorage	Integer	No	20	La nueva capacidad de almacenamiento de la instancia. Unidad: GB. Puede aumentar la capacidad de almacenamiento en incrementos de 5 GB. Para obtener más información, consulte Tipos de instancias principales de ApsaraDB RDS. Puede llamar a la operación DescribeAvailableClasses para consultar el rango de capacidad de almacenamiento admitido por un tipo de instancia. Nota Debe especificar como mínimo uno de los parámetros DBInstanceStorage y DBInstanceClass. Si la instancia ejecuta MySQL en RDS High-availability Edition y utiliza discos SSD locales, puede reducir la capacidad de almacenamiento en incrementos de 5 GB. Puede llamar a la operación DescribeDBInstanceAttribute para consultar la capacidad de almacenamiento actual de la instancia.
PayType	String	Sí	Postpaid	El método de facturación de la instancia. Valores válidos: Postpaid: pay-as-you-go Prepaid: suscripción
EffectiveTime	String	No	MaintainTime	El momento en que desea que el cambio surta efecto. Valores válidos: Immediate: El cambio surte efecto inmediatamente. MaintainTime: El cambio surte efecto durante la ventana de mantenimiento especificada. Para obtener más información, consulte ModifyDBInstanceMaintainTime. Nota Valor predeterminado: Immediate.
EngineVersion	String	No	5.6	La versión del motor de base de datos de la instancia. Valores válidos cuando establece el parámetro Engine en MySQL: 5.5, 5.6, 5.7 y 8.0 Valores válidos cuando establece el parámetro Engine en SQLServer: 2008r2, 08r2_ent_ha, 2012, 2012_ent_ha, 2012_std_ha, 2012_web, 2014_std_ha, 2016_ent_ha, 2016_std_ha, 2016_web, 2017_std_ha, 2017_ent, 2019_std_ha y 2019_ent Valores válidos cuando establece el parámetro Engine en PostgreSQL: 10.0, 11.0, 12.0, 13.0, 14.0 y 15.0 Valores válidos cuando establece el parámetro Engine en MariaDB: 10.3
DBInstanceStorageType	String	No	local_ssd	El tipo de almacenamiento de la instancia. Valores válidos: local_ssd: SSD local. cloud_ssd: SSD estándar. Este tipo de almacenamiento no se recomienda y no está disponible en algunas regiones de Alibaba Cloud. cloud_essd: SSD mejorado (ESSD) de nivel de rendimiento 1 (PL1). cloud_essd2: ESSD de PL2. cloud_essd3: ESSD de PL3. Para cambiar el tipo de almacenamiento, tenga en cuenta los siguientes puntos: Si la instancia ejecuta PostgreSQL, puede actualizar el tipo de almacenamiento de SSD estándar a ESSD. Sin embargo, no puede degradar el tipo de almacenamiento de ESSD a SSD estándar. Los ESSD ofrecen los siguientes niveles de rendimiento (PL): ESSD de PL1, ESSD de PL2 y ESSD de PL3. Puede actualizar o degradar el tipo de almacenamiento entre ESSD de PL1, ESSD de PL2 y ESSD de PL3. Para obtener más información, consulte Elementos de configuración.
Direction	String	No	Up	El tipo de cambio que desea aplicar a la instancia. Valores válidos: Up: actualiza una instancia de suscripción, o actualiza o degrada una instancia pay-as-you-go. Down: degrada una instancia de suscripción. TempUpgrade: aplica cambios de especificaciones elásticas en una instancia de suscripción. Este valor es obligatorio para los cambios de especificaciones elásticas. Nota Valor predeterminado: Up. Si especifica únicamente el parámetro DBInstanceStorageType, puede dejar vacío el parámetro Direction. Por ejemplo, si solo desea cambiar el tipo de almacenamiento de la instancia de SSD estándar a ESSD, no necesita especificar el parámetro Direction.
SourceBiz	String	No	N/A	Un parámetro obsoleto.
DedicatedHostGroupId	String	No	dhg-7a9********	El ID del clúster dedicado al que pertenece la instancia.
ZoneId	String	No	cn-hangzhou-b	El ID de zona de la instancia.
SwitchTime	String	No	2019-07-10T13:15:12Z	El momento en el que desea cambiar las especificaciones. Le recomendamos cambiar las especificaciones fuera de las horas pico. Especifique la hora en formato ISO 8601: aaaa-MM-ddTHH:mm:ssZ. La hora debe estar en UTC. Nota Debe especificar un momento posterior a la hora actual. De lo contrario, la tarea de cambio de especificaciones fallará. La hora actual se refiere al momento en que se llama a esta operación. Si la tarea de cambio de especificaciones falla, debe esperar a que el pedido se cancele automáticamente y luego volver a llamar a esta operación. Si desea aumentar la capacidad de almacenamiento o cambiar el tipo de almacenamiento ESSD entre diferentes PL, el cambio de especificaciones surte efecto inmediatamente y no afecta sus cargas de trabajo. No necesita configurar este parámetro.
ResourceGroupId	String	No	rg-acfmy**********	El ID del resource group al que pertenece la instancia.
UsedTime	Long	No	3	El periodo de validez de los cambios de especificaciones en una instancia de ApsaraDB RDS for SQL Server. Unidad: días.
MaxCapacity	double	No	8	El número máximo de Unidades de Capacidad de RDS (RCU).
MinCapacity	double	No	0.5	El número mínimo de RCU.
AutoPause	Boolean	No	true	Especifica si se admite la suspensión automática.
SwitchForce	Boolean	No	false	Especifica si se habilita la función de escalado forzado para la instancia serverless. Valores válidos: true: habilita la función. false: deshabilita la función. Este es el valor predeterminado.
Category	String	No	HighAvailability	La edición de RDS de la instancia. Valores válidos: Basic: RDS Basic Edition. HighAvailability: RDS High-availability Edition. AlwaysOn: RDS Cluster Edition para SQL Server Finance: RDS Enterprise Edition. Esta edición solo está disponible en el sitio de China (aliyun.com). Nota Si establece el parámetro EngineVersion en una versión de SQL Server, también debe especificar este parámetro.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
DBInstanceId	String	rm-uf6wjk5***	El ID de la instancia.
RequestId	String	3C5CFDEE-F774-4DED-89A2-1D76EC63C575	El ID de la solicitud.
OrderId	Long	20793850608****	El ID del pedido.

Ejemplos

Solicitudes de ejemplo

http(s)://rds.aliyuncs.com/?Action=ModifyDBInstanceSpec
&DBInstanceId=rm-uf6wjk5*******
&PayType=Postpaid
&DBInstanceClass=rds.mys2.small
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<ModifyDBInstanceSpecResponse>
    <RequestId>3C5CFDEE-F774-4DED-89A2-1D76EC63C575</RequestId>
    <DBInstanceId>rm-uf6wjk5*******</DBInstanceId>
    <OrderId>20793850608****</OrderId>
</ModifyDBInstanceSpecResponse>

Formato JSON

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

{
  "RequestId" : "3C5CFDEE-F774-4DED-89A2-1D76EC63C575",
  "DBInstanceId" : "rm-uf6wjk5*******",
  "OrderId" : "20793850608****"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	CannotDecreaseEssdPerfLevel	cannot decrease cloud essd performance level.	El mensaje de error devuelto porque no se permite el cambio de tipo de almacenamiento. El tipo de almacenamiento de una instancia que ejecuta SQL Server con SSD estándar solo se puede cambiar a ESSD. El tipo de almacenamiento de una instancia que ejecuta SQL Server con SSD local se puede cambiar a SSD estándar o ESSD.
400	InvalidEssdStorageSize	invalid cloud essd storage size.	El mensaje de error devuelto porque el tipo de instancia especificado no es válido. Seleccione un tipo de instancia válido e inténtelo de nuevo.
400	NotSupportReduceDiskSize	Not support reduce disk size.	El mensaje de error devuelto porque no se puede reducir la capacidad de almacenamiento de la instancia.
400	InvalidDBInstanceClass.NotFound	Specified DB instance class is not found.	El mensaje de error devuelto porque no se encuentra el nuevo tipo de instancia o ya no está disponible para su compra. Seleccione un tipo de instancia disponible.
400	InvalidAvZone.Format	Specified AvZone is not valid.	El mensaje de error devuelto porque el valor del parámetro ZoneID no es válido.
400	OperationDenied.OrderUnPaid	The operation is not permitted due to the wrong Order status (Unpaid).	El mensaje de error devuelto porque tiene pedidos sin pagar. Pague los pedidos antes de llamar a esta operación.
400	OperationDenied.InvalidStorageSize	The storage size limit is exceeded.	El mensaje de error devuelto porque el uso de almacenamiento supera el límite superior. Libere espacio o amplíe la capacidad de almacenamiento.
400	InsufficientResourceCapacity	The instance cluster does not support this operation.	El mensaje de error devuelto porque la operación no es compatible con el clúster dedicado al que pertenece la instancia.
400	InvalidUsedTime	The parameter usedTime is invalid.	El mensaje de error devuelto porque el valor del parámetro UsedTime no es válido.
400	CannotChangeStorageType	Temp upgrade does not support changing storage type.	El mensaje de error devuelto porque las actualizaciones elásticas no admiten cambios de tipo de almacenamiento.
400	TempUpgrade.NotSupport	The instance does not support temp upgrade.	El mensaje de error devuelto porque la instancia no admite actualizaciones elásticas.
400	EngineNotSupported	Engine specified cannot be supported the operation.	El mensaje de error devuelto porque esta operación no es compatible con el motor de base de datos que ejecuta la instancia. Actualice la versión menor del motor.
400	MaxscaleNotSupport	Maxscale not supported	El mensaje de error devuelto porque la instancia no admite la función de proxy de base de datos. Compruebe la configuración del proxy de base de datos que especificó.
400	ADInstanceNotSupportThisOperation	The AD instance is not supported this operation	El mensaje de error devuelto porque la operación no es compatible con una instancia agregada a un dominio de Active Directory (AD).
400	BYOKInstanceNotSupportThisOperation	The BYOK instance is not supported this operation	El mensaje de error devuelto porque la operación no es compatible con una instancia que tiene habilitado el cifrado de disco.
400	BYOLInstanceNotSupportThisOperation	The BYOL instance is not supported this operation	El mensaje de error devuelto porque la operación no es compatible con una instancia que utiliza Bring Your Own License (BYOL).
400	SSLInstanceNotSupportThisOperation	The instance opened SSL, upgrade is not this operation	El mensaje de error devuelto porque la operación no es compatible con una instancia que tiene habilitada la función de cifrado SSL.
400	TDEInstanceNotSupportThisOperation	The instance opened TDE, this operation is not supported	El mensaje de error devuelto porque la operación no es compatible con una instancia que tiene habilitada la función de Transparent Data Encryption (TDE).
400	InstanceIsSnapshotBackupNotSupportThisOperation	The instance backup method is snapshot backup, this operation is not supported	El mensaje de error devuelto porque la operación no es compatible con una instancia que tiene habilitada la función de copia de seguridad mediante instantánea.
400	InstanceHasReadOnlyInstanceNotSupportThisOperation	The instance has read-only instance or is read-only instance, this operation is not supported	El mensaje de error devuelto porque la operación no es compatible con una instancia de solo lectura o una instancia a la que están vinculadas instancias de solo lectura.
400	BackupReadInstanceModifyNotAllowed	Modify Backup Read Instance Is Not Allowed.	El mensaje de error devuelto porque no se permite modificar la instancia de origen de la copia de seguridad.
400	MinorVersionNotSupport	The current database minor version does not support the operation.	El mensaje de error devuelto porque la versión menor actual del motor de la instancia no admite la operación.
400	LX.ARGUMENT.ILLEGAL	The parameters that you specified for the specification change are invalid.	El mensaje de error devuelto porque los parámetros especificados para el cambio de especificaciones no son válidos.
400	ORD.S.QUERY.PROD.ERROR	An error occurred while querying the ordering information	El mensaje de error devuelto porque no se puede encontrar el pedido.
403	IncorrectDBInstanceType	The database instance type does not support the operation.	El mensaje de error devuelto porque el motor de base de datos que ejecuta la instancia no admite la operación.
403	OperationDenied.NotSupportedBackupMethod	When the storage is larger than 4000 GB, only snapshot backup is supported.	El mensaje de error devuelto porque la capacidad de almacenamiento es superior a 4,000 GB y solo se admiten copias de seguridad mediante instantánea.
403	IncorrectReadDBInstanceDisksize	Read instance disk size must be equal or higher than primary instance.	El mensaje de error devuelto porque la capacidad de almacenamiento de la instancia de solo lectura es menor que la de la instancia principal. Asegúrese de que la capacidad de almacenamiento de la instancia de solo lectura sea mayor o igual a la de la instancia principal.
403	GroupReplicationNotSupport.InvalidEngineVersion	Group Replication requires the instance engine version to be 8.0.	El mensaje de error devuelto porque la versión principal del motor de la instancia no es MySQL 8.0 y no se admite la replicación de grupo de MySQL (MGR).
403	GroupReplicationNotSupport.InvalidNodeClassCode	Group Replication requires the ClassCode of each node to be consistent.	El mensaje de error devuelto porque las especificaciones de los nodos en la instancia son diferentes y no se admite MGR.
403	GroupReplicationNotSupport.InvalidNodeNum	Group Replication is not supported, the number of nodes must be an odd number greater than or equal to 3.	El mensaje de error devuelto porque el número de nodos en la instancia no es un número impar mayor o igual a 3 y no se admite MGR.
403	GroupReplicationNotSupport.InvalidXengine	Group Replication is not supported because the instance has xengine tables.	El mensaje de error devuelto porque existen tablas X-Engine en la instancia y no se admite MGR.
403	GroupReplicationNotSupport.MemoryTooSmall	Group Replication is not supported because the memory is too small.	El mensaje de error devuelto porque la capacidad de memoria de la instancia es insuficiente y no se admite MGR.
403	ARMNotSupport	ARM arch does not support this operation.	El mensaje de error devuelto porque la arquitectura ARM no admite esta operación.
403	HostTypeNotSupport	Host type is inconsistent, please check that the original host type is the same as the target host type.	El mensaje de error devuelto porque los tipos de host antes y después del cambio de especificaciones son diferentes.
403	CloudSSDNotSupport	Cloud ssd does not support this operation, please upgrade to essd.	El mensaje de error devuelto porque el tipo de almacenamiento SSD estándar no admite esta operación. Actualice el tipo de almacenamiento de la instancia a ESSD.
403	MaxscaleInstanceNotSupport	Instances with maxscale instance do not support this operation.	El mensaje de error devuelto porque la instancia con MaxScale habilitado no admite esta operación.
403	ReadInstanceNotSupport	Instances with read-only do not support this operation.	El mensaje de error devuelto porque la instancia a la que están vinculadas instancias de solo lectura no admite esta operación.
404	InvalidClusterKms	The current instance does not authorized to access the Key Management Service.	El mensaje de error devuelto porque la instancia no tiene permisos para acceder a Key Management Service (KMS).

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.