A operação CopyDatabaseBetweenInstances permite replicar bancos de dados de uma instância para outra.
Também é possível usar essa operação para restaurar bancos de dados específicos em uma instância existente com base em um ponto no tempo ou conjunto de backup. Para obter mais informações, consulte Restaurar os dados de uma instância do ApsaraDB RDS for SQL Server.
Antes de chamar esta operação, certifique-se de atender aos seguintes requisitos:
As instâncias source e de destino pertencem à mesma conta.
As instâncias de origem e de destino executam a mesma versão do mecanismo de banco de dados.
As instâncias de origem e de destino residem na mesma região e usam o mesmo tipo de rede. As zonas podem ser diferentes.
As instâncias de origem e de destino não têm bancos de dados com o mesmo nome.
-
O armazenamento disponível da instância de destino deve ser maior que o tamanho total dos bancos de dados a serem replicados da instância de origem.
NotaEsta operação aplica-se apenas a instâncias que executam o SQL Server 2012 ou versões posteriores.
Depuração
Parâmetros da requisição
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| Action | String | Sim | CopyDatabaseBetweenInstances | A operação a ser executada. defina o valor como CopyDatabaseBetweenInstances. |
| DBInstanceId | String | Sim | rm-uf6wjk5xxxxxxx | O id da instância source. |
| TargetDBInstanceId | String | Sim | rm-ut5ajk3xxxxxxx | O id da instância de destino. Esse id deve ser diferente do id da instância source. |
| DbNames | String | Sim | {"test1":"newtest1","test2":"newtest2"} | Os nomes dos bancos de dados. Formato: |
| BackupId | String | Não | 106523874**** | O id do conjunto de backup usado para restaurar os bancos de dados da instância de origem. Ao replicar bancos de dados por conjunto de backup, chame a operação DescribeBackups para obter o id do conjunto de backup. Nota especifique apenas um dos parâmetros: BackupId ou RestoreTime. |
| RestoreTime | String | Não | 2011-06-11T16:00:00Z | O ponto no tempo em que o sistema replica os bancos de dados. Selecione um ponto no tempo dentro do período de retenção de backup. especifique a hora no padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC. Nota especifique apenas um dos parâmetros: BackupId ou RestoreTime. |
| SyncUserPrivilege | String | Não | NO | Define se os usuários e as permissões devem ser copiados.
Valor padrão: NO. |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
RequestId |
String |
803D11AF-C370-465B-AB46-CB3A642DC303 |
O id da requisição. |
Exemplos
Exemplos de requisição
http(s)://rds.aliyuncs.com/?Action=CopyDatabaseBetweenInstances
&DBInstanceId=rm-uf6wjk5xxxxxxx
&TargetDBInstanceId=rm-ut5ajk3xxxxxxx
&DbNames={"test1":"newtest1","test2":"newtest2"}
&BackupId=106523874****
&RestoreTime=2011-06-11T16:00:00Z
&SyncUserPrivilege=NO
&Common request parametersExemplos de resposta de sucesso
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<CopyDatabaseBetweenInstancesResponse>
<RequestId>803D11AF-C370-465B-AB46-CB3A642DC303</RequestId>
</CopyDatabaseBetweenInstancesResponse>Formato JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "803D11AF-C370-465B-AB46-CB3A642DC303"
}Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|
400 |
InvalidBackupSetID |
Invalid backup set id. |
Mensagem de erro retornada porque o conjunto de backup não existe. Chame a operação DescribeBackups para consultar os conjuntos de backup existentes de uma instância. |
|
400 |
DBCountLimitExceeded |
Db count limit exceeded. |
Mensagem de erro retornada porque o número de bancos de dados excede o limite máximo. |
|
400 |
BackupRestoreNotSupported.BasicHA |
Basic instances cannot be restored to high availability instances, and high availability instances cannot be restored to basic instances. |
Mensagem de erro retornada porque os dados não podem ser restaurados de uma instância do RDS Basic Edition para uma instância do RDS High-availability Edition e vice-versa. |
|
400 |
BackupRestoreNotSupported.HADedicatedAlwaysOn |
High availability instances cannot be restored to dedicated cluster instances or AlwaysOn instances. |
Mensagem de erro retornada porque os dados de uma instância do RDS High-availability Edition não podem ser restaurados para uma instância implantada em um cluster dedicado ou que executa o RDS Enterprise Edition. |
|
400 |
BackupRestoreNotSupported.ShareDedicatedAlwaysOn |
Shared instances cannot be restored to dedicated cluster instances, AlwaysOn instances, or high availability instances. |
Mensagem de erro retornada porque os dados de uma instância compartilhada não podem ser restaurados para uma instância implantada em um cluster dedicado ou para uma instância do RDS que executa o RDS Enterprise Edition ou o RDS High-availability Edition. |
|
400 |
OperationDenied.RestoreTime |
The instance with snapshot backup enabled can only be restored to the instance with snapshot backup enabled. |
Mensagem de erro retornada porque os dados de uma instância com o recurso de backup de snapshot ativado só podem ser restaurados em outra instância com esse mesmo recurso ativado. |
|
400 |
OperationDenied.SnapshotBackupSet |
Snapshot backup set can only be restored to the instance with snapshot backup enabled. |
Ao restaurar dados de uma instância com o recurso de backup de snapshot ativado para outra instância com o mesmo recurso, certifique-se de que o tipo do conjunto de backup da instância seja snapshot. |
|
400 |
CanNotCopyDBHasTDEEnabled |
The source database has enabled the TDE feature. You cannot copy it to another instance. |
Mensagem de erro retornada porque os dados da instância source não podem ser replicados para outra instância quando a Transparent Data Encryption (TDE) está ativada na instância source. |
|
400 |
InvalidBackupDBNames.NotFound |
The specified BackupDBNames is not found. |
Mensagem de erro retornada porque o nome da instância não foi especificado. |
|
400 |
InvalidBackupDBNames.Malformed |
The specified backup database is not valid. |
Mensagem de erro retornada porque o banco de dados especificado para backup é inválido. |
|
400 |
InvalidDBName.Format |
Specified DB name is not valid. |
Mensagem de erro retornada porque o nome do banco de dados é inválido. especifique um nome de banco de dados válido. O nome pode ter até 16 caracteres e conter letras minúsculas, dígitos e sublinhados (_). Deve começar com uma letra minúscula e terminar com uma letra minúscula ou dígito. |
|
400 |
InvalidDBInstanceName.NotFound |
Invalid DBInstanceId NotFound. |
Mensagem de erro retornada porque o id da instância não pôde ser encontrado. |
|
400 |
EngineNotSupported |
The engine does not support the operation. |
Mensagem de erro retornada porque a operação não é suportada pelo mecanismo de banco de dados executado na instância. |
|
400 |
InvalidTargetDBInstanceName.Format |
Specified Target DB instance name is not valid. |
Mensagem de erro retornada porque o nome da instância de destino está incorreto. |
|
400 |
MasterDBInstanceState.NotSupport |
The Master instance state does not support this operation. |
Mensagem de erro retornada porque a operação não é suportada quando a instância está no estado atual. |
|
400 |
TargetInstanceEngineNotSupported |
The specified Engine cannot be supported the operation. |
Mensagem de erro retornada porque a operação não é suportada pelo mecanismo de banco de dados. |
|
400 |
InvalidInstancesRegion.Malformed |
The instance region is not the same as the target instance region. |
Mensagem de erro retornada porque a região da instância de destino é diferente da região da instância de origem. |
|
400 |
InvalidStartTime.Format |
The specified parameter "StartTime" is not valid. |
Mensagem de erro retornada porque o formato da hora de início está incorreto. especifique a hora em GMT no formato YYYY-MM-DDThh:mmZ. Exemplos: DescribeDBInstancePerformance: 2012-06-11T15:00Z. DescribeErrorLogs: 2011-06-11T16:00Z. |
|
400 |
InvalidEndTime.Format |
The specified parameter "EndTime" is not valid. |
Mensagem de erro retornada porque o formato da hora de término é inválido. especifique a hora em GMT no formato YYYY-MM-DDThh:mmZ. Exemplo: 2012-06-11T15:00Z. |
|
400 |
InvalidParameterCombination |
The end time must be greater than the start time |
Mensagem de erro retornada porque a hora de término deve ser posterior à hora de início. |
|
400 |
InvalidBackupSetLocation.Format |
Specified backup set location is not valid. |
Mensagem de erro retornada porque o diretório especificado do conjunto de backup é inválido. |
|
400 |
InvalidCrossRegionTrans |
Cross region instance trans is not supported |
Mensagem de erro retornada porque a instância de origem e a instância de destino residem em regiões diferentes. |
|
400 |
ErrorParametersConflict |
Parameter BackupsetID and restoretime can only exist one. |
Mensagem de erro retornada porque apenas um dos parâmetros, BackupID ou Restoretime, pode ser especificado. |
|
400 |
InvalidDBName.NotFound |
Specified DB name does not exist. |
Mensagem de erro retornada porque o nome de usuário especificado para a conta do banco de dados não existe. Insira um nome de usuário correto. |
|
400 |
InvalidDBName.Duplicate |
Specified DB name already exists in the This instance. |
Mensagem de erro retornada porque o nome do banco de dados especificado já existe na instância. Altere o nome do banco de dados especificado. |
|
400 |
ReadDBInstanceNotSupport |
The operation is not permitted due to type of the instance. |
Mensagem de erro retornada porque a operação não é suportada por instâncias somente leitura. |
|
400 |
InvalidRecoveryDbInstance.StorageSize |
The disk space of the new instance cannot be less than that of the current instance |
Mensagem de erro retornada porque o armazenamento disponível da instância de destino deve ser maior ou igual ao tamanho total dos dados armazenados na instância de origem. |
|
400 |
InvalidRecoveryDBNames.Format |
The specified parameter DBNames is not valid. |
Mensagem de erro retornada porque o nome da instância é inválido. Verifique o nome da instância. |
|
400 |
InvalidBackupIdOrRestoreTime.NotFound |
The specified parameter BackupId or RestoreTime is not valid. |
Mensagem de erro retornada porque o valor do parâmetro BackupId ou do parâmetro RestoreTime é inválido. |
|
400 |
Forbidden.RegionNotFound |
The provided RegionId does not exist in our record. |
Mensagem de erro retornada porque o id da região especificada não pôde ser encontrado. |
|
400 |
ImageNotFound |
The specified Image is disabled or is deleted. |
Mensagem de erro retornada porque a imagem especificada está desativada ou excluída. |
|
400 |
InvalidZone.NotSupportedForStorageType |
The specified zone is closed or invalid for Specified DBInstanceStorageType. |
Mensagem de erro retornada porque a zona especificada não está mais disponível ou o valor especificado para o parâmetro DBInstanceStorageType é inválido. |
|
400 |
InvalidEngineOrEngineVersion |
The specified params engine or engineVersion should not be null. |
Mensagem de erro retornada porque o parâmetro Engine ou o parâmetro EngineVersion está definido como nulo. |
|
400 |
InvalidGeneralGroupNameOrGdnInstanceName |
The specified params generalGroupName or gdnInstanceName should not be null. |
Mensagem de erro retornada porque o parâmetro generalGroupName ou o parâmetro gdInsttanceName está vazio. |
|
400 |
InvalidVSwitchId.NotFound |
Specified virtual switch is not found in specified VPC. |
Mensagem de erro retornada porque não há vSwitches disponíveis na VPC. |
|
400 |
CDDC.TargetHostIDNotAvailable |
The target host ID is not available. |
Mensagem de erro retornada porque o host está indisponível. especifique um host diferente. |
|
400 |
CDDC.AvailableHostsNotEnoughInZone |
Not enough available hosts are in the target zone. |
Mensagem de erro retornada porque não há hosts disponíveis na zona especificada. Crie um host na zona e tente novamente. |
|
400 |
ReadOnlyInstanceNotSupport |
Specified ReadOnly Instance not support this operation. |
Mensagem de erro retornada porque a operação não é suportada por instâncias somente leitura. |
|
400 |
InvalidShareDbInstanceClassNotSupport |
The current instance classType is not support operation. |
Mensagem de erro retornada porque a operação não é suportada para o tipo de instância especificado. |
|
400 |
InvalidQuantity.NotSupported |
The specified instance quantity is not supported. |
Mensagem de erro retornada porque o número de instâncias excede o limite máximo. Verifique o número de instâncias. |
|
400 |
IncorrectMasterDBInstanceState |
Master instance state does not support this operation. |
Mensagem de erro retornada porque a operação não é suportada quando a instância primária está no estado atual. |
|
400 |
InvalidDBInstance.ReadDBInstanceExceeded |
Current DB Instance exceeding the allowed amount of read instance. |
Mensagem de erro retornada porque o número de instâncias somente leitura excede o limite máximo. Reduza o número de instâncias somente leitura. Se a capacidade de memória de uma instância que executa MySQL for maior que 64 GB, poderão ser criadas até 10 instâncias somente leitura para essa instância. Se a capacidade de memória for menor ou igual a 64 GB, poderão ser criadas até cinco instâncias somente leitura. |
|
400 |
InvalidEngineVersion.Malformed |
Specified engine version is not valid. |
Mensagem de erro retornada porque a versão especificada do mecanismo de banco de dados é inválida. Verifique a versão do mecanismo de banco de dados e tente novamente. |
|
400 |
InvalidEssdStorageSize |
The cloud ESSD storage size is invalid. |
Mensagem de erro retornada porque a capacidade de armazenamento especificada para a instância com SSDs padrão ou SSDs aprimorados (ESSDs) é inválida. Selecione uma capacidade de armazenamento válida e tente novamente. |
|
400 |
IncorrectInstanceNetworkType |
The specified parameter InstanceNetworkType is not valid. |
Mensagem de erro retornada porque o valor do parâmetro InstanceNetworkType é inválido. |
|
400 |
AtLeastTwoVSwitchParamExists |
The specified params(Vswitchs) at least two. |
especifique pelo menos dois valores para o parâmetro Vswitchs. Certifique-se de que o número de vSwitches seja igual ao número de zonas. |
|
403 |
StorageLimitExceeded |
Exceeding the allowed Storage of DB instance. |
Mensagem de erro retornada porque a nova capacidade de armazenamento excede o limite máximo. Libere espaço em disco. |
|
403 |
InvalidTempInstance.NotSupport |
The temp db Instance is not support. |
Mensagem de erro retornada porque a instância está bloqueada. |
|
403 |
IncorrectDBInstanceState |
The current database instance state does not support the operation. |
Mensagem de erro retornada porque a operação não é suportada quando a instância está no estado atual. Verifique se a instância está no estado Running. |
|
403 |
IncorrectDBInstanceType |
Current DB instance engine and type does not support operations. |
Mensagem de erro retornada porque a operação não é suportada para o motor de banco de dados e o tipo da instância. |
|
403 |
Forbidden.SnapshotRecovery |
Snapshot backup does not support partial restore |
Mensagem de erro retornada porque os backups de snapshot não podem ser usados para restaurar apenas uma parte específica dos dados. |
|
403 |
OperationDenied.Resource |
Specified DB instance class or storage is not available in all Availability Zones. |
Mensagem de erro retornada porque o inventário de recursos é insuficiente. Altere o tipo e a capacidade de armazenamento da instância e tente novamente. |
|
403 |
ReadonlyDBInstanceStorageExceeded |
You can not create the order with the db instance because The masterInstance storage value exceeding the readonlyInstance storage value. |
Mensagem de erro retornada porque a capacidade de armazenamento da instância primária é maior que a capacidade de armazenamento da sua instância somente leitura, impedindo a criação de um pedido com essa instância. |
|
403 |
MasterDBInstanceClassNotSupport |
You can not create the readonly instance with the db instance class does not support. |
Mensagem de erro retornada porque a instância somente leitura não pode ser criada com um parâmetro não suportado pela instância primária. |
|
403 |
ReadonlyDBInstanceClassNotSupport |
You can not create the readonly instance with the master instance class does not support. |
Mensagem de erro retornada porque a instância somente leitura não pode ser criada com uma opção não suportada pela instância. |
|
403 |
ReadonlyDBInstanceClassLowerThanMasterInstance |
The readonly instance db instance class are lower than master instance db instance class. |
Mensagem de erro retornada porque as especificações da instância somente leitura são inferiores às especificações da instância primária. |
|
403 |
InvalidSwitchType.Malformed |
The specified parameter InvalidSwitchType is not valid. |
Mensagem de erro retornada porque o valor do parâmetro InvalidSwitchType é inválido. |
|
403 |
UnsupportedCopyDbHighAvailabilityToBasic |
Replicate Database from RDS Category:HighAvailability to RDS Category:Basic is not supported. |
Mensagem de erro retornada porque o banco de dados não pode ser replicado de uma instância que executa o RDS High-availability Edition para uma instância que executa o RDS Basic Edition. |
|
403 |
InvalidInstanceVersion |
Source instance version is greater than the target instance version. |
Mensagem de erro retornada porque a versão do mecanismo de banco de dados da instância de origem é mais recente que a da instância de destino. |
|
403 |
UnsupportedCopyDbShareToHighAvailability |
Replicate Database from RDS Category:Share to RDS Category:HighAvailability is not supported. |
Mensagem de erro retornada porque o banco de dados não pode ser replicado de uma instância compartilhada para uma instância que executa o RDS High-availability Edition. |
|
403 |
UnsupportedCopyDbAlwaysOnToBasic |
Replicate Database from RDS Category:AlwaysOn to RDS Category:Basic is not supported. |
Mensagem de erro retornada porque o banco de dados não pode ser replicado de uma instância que executa o RDS Cluster Edition para uma instância que executa o RDS Basic Edition. |
|
403 |
UnsupportedCopyDbBasicToShare |
Replicate Database from RDS Category:Basic to RDS Category:Share is not supported. |
Mensagem de erro retornada porque o banco de dados não pode ser replicado de uma instância que executa o RDS Basic Edition para uma instância compartilhada. |
|
403 |
UnsupportedCopyDbAlwaysOnToHighAvailability |
Replicate Database from RDS Category:AlwaysOn to RDS Category:HighAvailability is not supported. |
Mensagem de erro retornada porque o banco de dados não pode ser replicado de uma instância que executa o RDS Cluster Edition para uma instância que executa o RDS High-availability Edition. |
|
403 |
UnsupportedCopyDbShareToBasic |
Replicate Database from RDS Category:Share to RDS Category:Basic is not supported. |
Mensagem de erro retornada porque o banco de dados não pode ser replicado de uma instância compartilhada para uma instância que executa o RDS Basic Edition. |
|
403 |
UnsupportedCopyDbHighAvailabilityToShare |
Replicate Database from RDS Category:HighAvailability to RDS Category:Share is not supported. |
Mensagem de erro retornada porque o banco de dados não pode ser replicado de uma instância que executa o RDS High-availability Edition para uma instância compartilhada. |
|
403 |
UnsupportedCopyDbShareToAlwaysOn |
Replicate Database from RDS Category:Share to RDS Category:AlwaysOn is not supported. |
Mensagem de erro retornada porque o banco de dados não pode ser replicado de uma instância compartilhada para uma instância que executa o RDS Cluster Edition. |
|
403 |
UnsupportedCopyDbAlwaysOnToShare |
Replicate Database from RDS Category:AlwaysOn to RDS Category:Share is not supported. |
Mensagem de erro retornada porque o banco de dados não pode ser replicado de uma instância que executa o RDS Cluster Edition para uma instância compartilhada. |
|
403 |
InvalidParamTableMeta.RestoreTime |
There are databases created later than the last full backup at the instance level, point-in-time restore is not possible, try to restore using a backup set or pick another database restore time. |
Mensagem de erro retornada porque o banco de dados a ser restaurado foi criado na instância após a conclusão do último backup completo, impedindo a restauração dos dados para o ponto no tempo especificado. Recomendamos restaurar os dados por conjunto de backup ou especificar um banco de dados que atenda aos requisitos para restauração no ponto no tempo desejado. |
|
404 |
InvalidDBInstance.NotFound |
The specified instance does not exist or is not supported. |
Mensagem de erro retornada porque a instância especificada não pôde ser encontrada. Verifique o id da instância. |
|
404 |
InvalidInstanceStorageType.NotFound |
The specified DBInstanceStorageType is not found. |
Mensagem de erro retornada porque o parâmetro InstanceStorageType não foi especificado. especifique o parâmetro. |
|
404 |
InvalidRegion.NotFound |
Specified Region does not exist in the RDS |
Mensagem de erro retornada porque o id da região é inválido. |
|
404 |
IncorrectVswitchId |
The specified parameter VSwitchId is not valid. |
Mensagem de erro retornada porque o valor do parâmetro VSwitchId é inválido. |
|
404 |
InsufficientResourceCapacity |
Current cluster resources are insufficient. Try again later. |
Mensagem de erro retornada porque o inventário de recursos no cluster é insuficiente. Tente novamente mais tarde. |
Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.