Restaura datos históricos en una nueva instancia, a la que se denomina instancia clon.
Descripción de la operación
Motores compatibles
ApsaraDB RDS for MySQL
ApsaraDB RDS for PostgreSQL
ApsaraDB RDS for SQL Server
ApsaraDB RDS for MariaDB
Documentación relacionada
Pruébelo ahora
Test
Autorización de RAM
|
Action |
Nivel de acceso |
Tipo de recurso |
Clave de condición |
Acción dependiente |
|
rds:CloneDBInstance |
create |
DBInstance
|
|
Ninguna |
Parámetros de la solicitud
|
Parámetro |
Tipo |
Obligatorio |
Descripción |
Ejemplo |
| ClientToken |
string |
No |
El token de cliente que se utiliza para garantizar la idempotencia de la solicitud y evitar envíos duplicados. Puede generar el valor de este parámetro en el lado del cliente. El valor debe ser único en las distintas solicitudes y puede tener una longitud de hasta 64 caracteres ASCII. El valor no puede contener caracteres que no sean ASCII. |
0c593ea1-3bea-11e9-b96b-88********** |
| RegionId |
string |
No |
El ID de la región. Puede llamar a la operación DescribeRegions para consultar los ID de región. |
cn-hangzhou |
| ZoneId |
string |
No |
El ID de la zona principal. Puede llamar a la operación DescribeRegions para consultar los ID de zona. Nota
Valor predeterminado: la zona de la instancia de origen. |
cn-hangzhou-b |
| DBInstanceClass |
string |
No |
El tipo de instancia. Para obtener más información, consulte Tipos de instancia. Nota
Valor predeterminado: el tipo de instancia de la instancia principal. |
mysql.n1.micro.1 |
| DBInstanceStorage |
integer |
No |
Capacidad de almacenamiento de la instancia. Unidad: GB. La capacidad de almacenamiento de la instancia aumenta en incrementos de 5 GB. Para obtener más información, consulte Tipos de instancia. Nota
Valor predeterminado: la capacidad de almacenamiento de la instancia principal. |
1000 |
| DBInstanceDescription |
string |
No |
El nombre de la instancia. El nombre debe tener de 2 a 255 caracteres de longitud. Debe comenzar con una letra o un carácter chino y puede contener letras, caracteres chinos, dígitos, guiones bajos (_) y guiones (-). Nota
No puede comenzar con http:// o https://. |
testInstance |
| DbNames |
string |
No |
Los nombres de las bases de datos. Formato: |
test1,test2 |
| PayType |
string |
Sí |
El método de facturación de la instancia. Valores válidos:
|
Postpaid |
| InstanceNetworkType |
string |
No |
El tipo de red de la instancia. Valores válidos:
Nota
Valor predeterminado: el tipo de red de la instancia principal. |
VPC |
| DBInstanceId |
string |
Sí |
El ID de la instancia. |
rm-uf6wjk5**** |
| BackupId |
string |
No |
El ID del conjunto de copias de seguridad. Puede llamar a la operación DescribeBackups para consultar los conjuntos de copias de seguridad. Nota
Debe especificar al menos uno de los parámetros BackupId y RestoreTime. |
902**** |
| RestoreTime |
string |
No |
El punto en el tiempo al que desea restaurar los datos. El punto en el tiempo debe estar dentro del período de retención de copias de seguridad. Especifique la hora en formato aaaa-MM-ddTHH:mm:ssZ. La hora debe estar en UTC. Nota
Debe especificar al menos uno de los parámetros BackupId y RestoreTime. |
2011-06-11T16:00:00Z |
| VPCId |
string |
No |
El ID de la VPC. Nota
Asegúrese de que la VPC pertenezca a la región especificada. |
vpc-uf6f7l4fg90**** |
| VSwitchId |
string |
No |
El ID del vSwitch. El vSwitch debe estar en la zona activa que corresponde al ID de zona especificado en el parámetro ZoneId.
|
vsw-uf6adz52c2p**** |
| PrivateIpAddress |
string |
No |
La dirección IP de red interna de la nueva instancia. La dirección IP debe estar dentro del rango de direcciones IP del vSwitch especificado. De forma predeterminada, el sistema asigna automáticamente una dirección IP en función de los parámetros VPCId y VSwitchId. |
172.XX.XX.69 |
| UsedTime |
integer |
No |
La duración de la suscripción. Valores válidos:
Nota
Este parámetro es obligatorio cuando el parámetro PayType se establece en Prepaid. |
1 |
| Period |
string |
No |
El período de suscripción de la instancia de suscripción. Valores válidos:
Nota
Este parámetro es obligatorio cuando el parámetro PayType se establece en Prepaid. Valores válidos:
|
Year |
| Category |
string |
No |
La edición de la instancia. Valores válidos:
Instancias serverless
Nota
No es necesario especificar este parámetro. La edición de la instancia clon es la misma que la de la instancia de origen. |
HighAvailability |
| ZoneIdSlave1 |
string |
No |
El ID de la zona activa del nodo secundario. Si este parámetro se establece con el mismo valor que el parámetro ZoneId, se trata de un despliegue en una sola zona. Si este parámetro se establece con un valor distinto al del parámetro ZoneId, se trata de un despliegue en varias zonas. |
cn-hangzhou-c |
| ZoneIdSlave2 |
string |
No |
El ID de la zona activa del nodo de registro. Si este parámetro se establece con el mismo valor que el parámetro ZoneId, se trata de un despliegue en una sola zona. Si este parámetro se establece con un valor distinto al del parámetro ZoneId, se trata de un despliegue en varias zonas. |
cn-hangzhou-d |
| DBInstanceStorageType |
string |
No |
El tipo de almacenamiento de la instancia. Valores válidos:
Nota
Las instancias serverless solo admiten discos en la nube ESSD PL1 y discos de rendimiento premium. |
general_essd |
| RestoreTable |
string |
No |
Especifica si se deben restaurar bases de datos y tablas individuales. Establezca el valor en true para restaurar bases de datos y tablas individuales. Deje este parámetro vacío si no desea restaurar bases de datos y tablas individuales. |
true |
| TableMeta |
string |
No |
La información sobre las bases de datos y las tablas que desea restaurar. Este parámetro es obligatorio cuando se restauran bases de datos y tablas individuales. Formato:
|
[{"type":"db","name":"testdb1","newname":"testdb1_new","tables":[{"type":"table","name":"testdb1table1","newname":"testdb1table1_new"}]}] |
| DedicatedHostGroupId |
string |
No |
El ID del clúster dedicado. |
dhg-7a9**** |
| BackupType |
string |
No |
El tipo de copia de seguridad. Valores válidos:
|
FullBackup |
| DeletionProtection |
boolean |
No |
Especifica si se debe habilitar la protección contra liberación. Valores válidos:
|
true |
| IoAccelerationEnabled |
string |
No |
Las configuraciones serverless. Este parámetro solo es obligatorio cuando se clonan datos en una instancia serverless. Nota
Este parámetro solo se admite en el sitio de China. |
0 |
| BurstingEnabled |
boolean |
No |
[Obsoleto] Este parámetro está obsoleto y no es necesario configurarlo. |
0 |
| AutoPay |
boolean |
No |
Especifica si se debe habilitar la función Buffer Pool Extension (BPE) para discos de rendimiento premium. Valores válidos:
Nota
Para obtener más información sobre la función BPE, consulte Buffer Pool Extension (BPE). |
0 |
| CustomExtraInfo |
string |
No |
Especifica si se debe habilitar la función de ráfaga de rendimiento de E/S para discos de rendimiento premium. Valores válidos:
Nota
Para obtener más información sobre la función de ráfaga de rendimiento de E/S, consulte ¿Qué es un disco de rendimiento premium?. |
false |
| Tag |
array<object> |
No |
Especifica si se debe habilitar el pago automático. Valores válidos:
Nota
Valor predeterminado: true. Si su método de pago tiene un saldo insuficiente, puede establecer el parámetro AutoPay en false. En este caso, se genera un pedido no pagado y puede iniciar sesión en la consola de ApsaraDB RDS para completar el pago. |
true |
|
object |
No |
Los detalles de las etiquetas. |
||
| Key |
string |
No |
La clave de la etiqueta. Especifique este parámetro para vincular una etiqueta a la instancia.
|
testkey1 |
| Value |
string |
No |
El valor de la etiqueta que corresponde a la clave de la etiqueta. Especifique este parámetro para vincular una etiqueta a la instancia.
|
testvalue1 |
Elementos de la respuesta
|
Elemento |
Tipo |
Descripción |
Ejemplo |
|
object |
Los parámetros de respuesta. |
||
| DBInstanceId |
string |
El ID de la instancia. |
rm-uf6wjk5**** |
| OrderId |
string |
El ID del pedido. |
100789370**** |
| RequestId |
string |
El ID de la solicitud. |
1E43AAE0-BEE8-43DA-860D-EAF2**** |
Ejemplos
Respuesta exitosa
JSON Formato
{
"DBInstanceId": "rm-uf6wjk5****",
"OrderId": "100789370****",
"RequestId": "1E43AAE0-BEE8-43DA-860D-EAF2****"
}
Códigos de error
|
Código de estado HTTP |
Código de error |
Mensaje de error |
Descripción |
|---|---|---|---|
| 400 | InvalidAvZone.Format | Specified AvZone is not valid. | La AvZone especificada no es válida. Verifique si este parámetro es correcto. |
| 400 | InvalidAvZone.NotSupport | Specified availableArea multiZone does not support in RDS. | El valor availableArea multiZone especificado no se admite en ApsaraDB RDS. |
| 400 | CannotDecreaseEssdPerfLevel | cannot decrease cloud essd performance level. | La operación falló porque la especificación del disco en la nube no admite operaciones de degradación. |
| 400 | InvalidIPAddress.Conflict | IP address conflict. | Se produjo un conflicto de direcciones IP. |
| 400 | CDDC.AvailableHostsNotEnoughInZone | Not enough available hosts are in the target zone. | La zona de destino no cuenta con recursos de host suficientes. Cree un host en la zona. |
| 400 | InvalidInstanceLevel.DiskType | Specified instance level not support request disk type | El tipo de instancia actual no admite este tipo de almacenamiento. |
| 400 | InvalidRecoveryDbInstance.StorageType | The disk local_ssd can not clone to cloud disk type | No se puede clonar un disco local a un disco en la nube. |
| 400 | InvalidRecoveryDbInstance.StorageSize | The disk space of the new instance cannot be less than that of the current instance | La operación falló. El espacio en disco de la nueva instancia no puede ser menor que el de la instancia actual. |
| 400 | InvalidDBInstanceClass.Offline | The specified instance type is no longer provided. Please specify another instance type. | El tipo de instancia seleccionado está descontinuado. Especifique un tipo de instancia diferente. |
| 400 | InvalidTunnelId | Specified conn tunnel is not valid. | El canal de conexión especificado no es válido. |
| 400 | ZoneId.NotMatchWithCategory | The number of available zones does not match the database engine or instance edition. Please reset it. | El número de zonas no coincide con el tipo de base de datos ni con la edición de la instancia. Reconfigure la configuración. |
| 400 | UnsupportExtendDisk.NotSupport | Specified DB instance is unsupport extend disk. | La instancia especificada no admite la expansión de disco. |
| 400 | Order.ComboInstanceNotAllowOperate | A package instance is not allowed to operate independently. | No se permiten operaciones individuales en instancias de paquete. |
| 400 | Price.PricingPlanResultNotFound | Pricing plan price result not found. | No se encontró el resultado del plan de precios. |
| 400 | Order.NoRealNameAuthentication | You have not passed the real-name authentication and do not meet the purchase conditions. Please log in to the user center for real-name authentication. | No ha completado la verificación de nombre real y no es elegible para realizar una compra. Inicie sesión en Gastos y costos para completar la verificación de nombre real. |
| 400 | InsufficientAvailableQuota | Your account quota limit is less than 0, please recharge before trying to purchase. | El saldo de su cuenta es inferior a 0. Recargue su cuenta e inténtelo de nuevo. |
| 400 | CommodityServiceCalling.Exception | Failed to call commodity service. | La llamada al servicio de productos falló. |
| 400 | RegionDissolvedEOM | Dear customer, Alibaba Cloud plans to optimize and adjust the current region. Cloud services in this region will cease operations. You are currently unable to operate new purchase orders. Thank you for your understanding and support. | Alibaba Cloud planea optimizar y ajustar la región actual. Los servicios en la nube de esta región se descontinuarán. Para garantizar la continuidad de su negocio y una migración de datos sin problemas, no puede crear nuevos pedidos de compra en este momento. Gracias por su comprensión y apoyo. |
| 400 | Commodity.InvalidComponent | The module you purchased is not legal, please buy it again. | El módulo que adquirió no es válido. Adquiera un módulo válido. |
| 400 | RegionEndTimeDissolvedAustralia | Cloud services in the Australia (Sydney) region will be discontinued. Set the validity date to September 30, 2024 or earlier than September 30, 2024. | La región especificada se ha retirado. |
| 400 | Price.CommoditySys | Commodity system call exception. | Se produjo una excepción al llamar al sistema de productos. |
| 400 | Pay.InsufficientBalance | Insufficient available balance. | El saldo actual de la cuenta es inferior a 100. Recargue su cuenta antes de comprar. |
| 400 | Order.PeriodInvalid | There is a problem with the period you selected, please choose again. | El periodo de suscripción seleccionado no es válido. Seleccione un periodo diferente. |
| 400 | pay.noCreditCard | Account not bound to credit card. | |
| 400 | Order.InstHasUnpaidOrder | There is an unpaid order for the service you have purchased. Please pay or void it before placing the order. | Existe un pedido sin pagar para el servicio que seleccionó. Pague o cancele el pedido existente antes de crear uno nuevo. |
| 400 | noAvailablePaymentMethod | No payment method is specified for your account. We recommend that you add a payment method. | |
| 400 | BasicInfoUncompleted | Your information is incomplete. Complete your information before the operation. | Su información está incompleta. Complétela antes de continuar. |
| 400 | Risk.RiskControlRejection | Your account is abnormal, please contact customer service for details. | Su cuenta se encuentra en un estado anómalo. Contacte al servicio de atención al cliente para obtener más detalles. |
| 400 | Api.NotSupport | Specified api is not supported. | La operación actual no es compatible. |
| 400 | ContainForbiddenLabelError | There is a label that prohibits placing orders. Please contact your distributor for assistance. | Existe una etiqueta que bloquea el pedido. Contacte a su distribuidor para resolver este problema. |
| 400 | InvalidDBInstanceId.NotFound | The DBInstanceId provided does not exist in records. | La instancia especificada no existe. Verifique si la instancia existe y no se ha eliminado. |
| 400 | InvalidParam | Sepcified wal level Parameter is invalid. There are still logical slots in instance, so it can not be set as replica. | La operación falló. El parámetro no es válido. |
| 400 | KmsApiError | User secret key invalid. | La clave de usuario no es válida. |
| 400 | System.SaleValidateFailed | Sales expression validation system error. | La solicitud no contiene un periodo de suscripción válido. Verifique el parámetro Period o el parámetro UsedTime. |
| 400 | Abs.InvalidAccount.NotFound | account is not found. | La cuenta no existe. |
| 400 | SqlExecuteFailedOrTimeout | sql command execution failed or timed out:%s. | El comando SQL no se pudo ejecutar o se agotó el tiempo de espera. |
| 400 | ColdData.EngineVersionNotSupport | The current instance engine version not support coldDataEnabled. | La versión actual del motor de base de datos de la instancia no admite el archivado de datos fríos. |
| 400 | ColdData.MinorVersionNotSupport | The current instance minor version not support coldDataEnabled. | La versión actual del kernel no admite el archivado de datos fríos. |
| 400 | IncorrectTargetClasscode | The current instance type does not support this operation. | La especificación actual no admite esta operación. |
| 400 | InvalidConnectionString.Duplicate | Specified connection string already exists in the RDS. | El nombre de la dirección de conexión ya existe. Especifique una cadena de conexión diferente. |
| 400 | RequiredParam.NotFound | Required input param is not found. | Falta un parámetro requerido. |
| 400 | Parameters.Invalid | Parameter error, please check the parameters. | El parámetro no es válido. Verifique el parámetro. |
| 400 | BackupPolicyNotSupport | Cold Data won't open with CrossBackup or Flash Backup, please check Backup Policy. | El archivado de datos no admite la copia de seguridad entre regiones ni la copia de seguridad de instantáneas de alta frecuencia. Verifique la política de copia de seguridad. |
| 400 | InvalideStatus.Format | The instance status does not support this operation. | El estado de la instancia no admite esta operación. |
| 400 | InvalidReleasedKeepPolicy.Format | Specified Released Keep Policy is not valid. | La política de retención de los datos de copia de seguridad archivados después de la liberación de la instancia no es válida. |
| 400 | InvalidDBInstanceEngineType.Format | the DB instance engine type does not support this operation. | El tipo de motor de base de datos de la instancia no admite esta operación. |
| 400 | Pay.NoCreditCard | No credit cards. | La cuenta no está asociada con una tarjeta de crédito. |
| 400 | VpcNetworkTypeNotSupport | The vpc network type instance does not support this operation. | Esta operación no es compatible con las instancias que tienen el tipo de red VPC. |
| 400 | MirrorInsExists | Specified DB instance mirror ins already existed. | La imagen de la instancia de base de datos actual ya existe. |
| 400 | UnsupportedClassCode | The specified DB instance class stops selling. | El tipo de instancia ya no está disponible para su compra. |
| 400 | InvalidBackupSet | The specified database does not exist in the backup set. | La base de datos especificada no existe en el conjunto de copia de seguridad. |
| 400 | OrdTCommodityQueryError | Failed to query for product. | No se pudo consultar el producto. |
| 400 | ProductInstanceReleased | The instance has been released. Please check before placing the order. | La instancia ha sido liberada. Verifique el estado de la instancia antes de realizar un pedido. |
| 400 | RegionEndTimeDissolvedIndia | The region is no longer supported. | La región especificada se ha retirado. |
| 400 | StopService.Clone | The service has been discontinued and cloning operations on classic network instances are no longer permitted. | La red clásica ha quedado obsoleta y se ha superado el tiempo de finalización del servicio. No se permite clonar instancias del tipo de red clásica. |
| 400 | InvalidParam.UsedTime | The clone expiration date cannot exceed %s. | Cuando el parámetro PayType se establece en Prepaid, el parámetro usedTime debe ser válido. |
| 400 | MinorVersionTag.NotFound | Minor version tags cannot be parsed by the instance. | |
| 400 | InvalidBakset.Invalid | Specified bakset is not valid. | El conjunto de copia de seguridad especificado no admite esta operación. |
| 400 | InvalidParamForXfs | Xfs instance must be single tenant standard instance. | La instancia Xfs debe ser una instancia dedicada de alta disponibilidad. |
| 400 | AtLeastThreeVSwitchAvailableIp | The primary vswitch requires at least three available IP addresses. | El vSwitch principal debe tener al menos 3 direcciones IP disponibles. |
| 400 | AtLeastTwoVSwitchAvailableIp | The primary vswitch requires at least two available IP addresses. | El vSwitch principal debe tener al menos 2 direcciones IP disponibles. |
| 400 | DiskSize.NotEnough | The disk size is not enough to restore tables. | El espacio en disco restante es insuficiente. |
| 500 | ExternalFailure | The request processing has failed due to external service failure. | La solicitud falló. Vuelva a intentarlo más tarde. |
| 500 | RequestMetaDataFailed | The service request failed. Please try again later or contact service personnel. | La solicitud falló. Vuelva a intentarlo más tarde o comuníquese con el soporte técnico. |
| 500 | InvokeProxyFailure | The request processing has failed due to service failure of rds api. | El procesamiento de la solicitud falló debido a un error del servicio de API de ApsaraDB RDS. |
| 403 | IncorrectMinorVersion | Current engine minor version does not support operations. | La versión secundaria actual del motor no admite esta operación. |
| 403 | IncorrectCharacterType | Current DB instance character type does not support this operation. | Esta operación no se admite para el tipo de carácter de la instancia actual. |
| 403 | CloudDiskEncryptionNotSupport | The encryption key is not allowed for general-purpose instance. | Las instancias de uso general no admiten el cifrado de discos en la nube. |
| 403 | OrderStatus.UnPaid | The specified db instance has unpaid order. | La instancia tiene un pedido pendiente de pago. Pague el pedido y vuelva a intentarlo. |
| 403 | InvalidReduceDiskSize | The storage capacity after the scale-down must be larger than the used amount. | La capacidad de destino para la reducción de escala no puede ser inferior al uso de almacenamiento actual. |
| 403 | CloudSSDNotSupport | Cloud ssd does not support this operation, please upgrade to essd. | Esta operación no se admite para los discos en la nube SSD. Actualice a ESSD. |
| 403 | InvalidUserOperatorPermission | The user permission does not support this operation. | Los permisos del usuario no permiten esta operación. |
| 403 | InvalidVswitchId | Specified conn vswitch id is not valid. | El VSwitchId especificado tiene un formato no válido o está vacío. |
| 403 | OperationDenied.ZoneResource | There is no available zone for inventory. | No hay regiones de inventario disponibles. |
| 403 | NotInFlowController | Sorry,no permission. | Esta función no está disponible para los usuarios de la nube que no son empresariales. No tiene los permisos necesarios. |
| 403 | InvalidKmsKey | Kms key is disabled. | La clave KMS está deshabilitada. |
| 403 | InvalidInstanceLevel.Malformed | Current DB instance level does not support this operation. | La operación falló. El código de especificación especificado no admite el número de endpoints especificado. Verifique el número de shards y el número actual de endpoints. |
| 403 | InvalidMeta.TooLarge | Meta information is too large. | Los metadatos son demasiado grandes. Verifique si el número de tablas de la instancia supera los 50,000. |
| 404 | InvalidDBInstance.NotFound | The specified instance does not exist or is not supported. | La instancia especificada no existe o no admite esta operación. |
| 404 | InvalidClusterKms | The current instance does not authorized to access the Key Management Service. | La instancia actual no está autorizada para acceder a Key Management Service. |
| 404 | Request.NotFound | The requested resource is not available. | El recurso solicitado no está disponible. |
| 404 | HostInfo.NotFound | The specified host info is not found. | La información del host especificado no existe. |
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.