Restaurar bancos de dados ou tabelas individuais de uma instância ApsaraDB RDS - : Central de Documentação do Alibaba Cloud

O ApsaraDB RDS for MySQL permite restaurar bancos de dados e tabelas individuais. Se você excluiu bancos de dados ou tabelas de uma instância, recupere-os usando um arquivo de backup. Para mais informações, consulte Restaurar bancos de dados e tabelas individuais de uma instância ApsaraDB RDS for MySQL.

Antes de chamar esta operação, verifique se os seguintes requisitos foram atendidos:

A instância RDS está no estado Running.
Não há tarefas de migração em andamento na instância.
Para restaurar dados até um ponto específico no tempo, ative o recurso de backup de log na instância. Para mais informações, consulte Fazer backup de uma instância ApsaraDB RDS for MySQL.
A restauração de bancos de dados ou tabelas individuais está habilitada e novos backups foram criados. Para mais detalhes, consulte Restaurar bancos de dados e tabelas individuais de uma instância ApsaraDB RDS for MySQL.
Os nomes desejados para as tabelas restauradas não existem na instância.

Nota

Esta operação é compatível apenas com instâncias que executam MySQL.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	RestoreTable	A operação a ser executada. Defina o valor como RestoreTable.
ClientToken	String	Não	ETnLKlblzczshOTUbOCzxxxxxxxxxx	Token do cliente usado para garantir a idempotência da solicitação. Gere esse valor com o cliente, mas garanta que seja único entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não deve exceder 64 caracteres.
DBInstanceId	String	Sim	rm-uf6wjk5xxxxxxxxxx	ID da instância.
BackupId	String	Não	9026262	ID do arquivo de backup de dados. Chame a operação DescribeBackups para obter o ID do arquivo de backup de dados. Nota Especifique pelo menos um dos parâmetros BackupId ou RestoreTime.
RestoreTime	String	Não	2011-06-11T16:00:00Z	Ponto no tempo até o qual restaurar os dados. Esse momento deve estar dentro do período de retenção de backup de log especificado. Especifique a hora no padrão ISO 8601, no formato aaaa-MM-ddTHH:mm:ssZ. A hora deve estar em UTC. Nota Especifique pelo menos um dos parâmetros BackupId ou RestoreTime. Ative o recurso de backup de log. Para mais informações, consulte Fazer backup de uma instância ApsaraDB RDS for MySQL.
TableMeta	String	Sim	[{"type":"db","name":"testdb1","newname":"testdb1_new","tables":[{"type":"table","name":"testdb1table1","newname":"testdb1table1_new"}]}]	Bancos de dados e tabelas a serem restaurados. Formato: [{"type":"db","name":"<The name of Database 1>","newname":"<The new name of Database 1>","tables":[{"type":"table","name":"<The name of Table 1 in Database 1>","newname":"<The new name of Table 1>"},{"type":"table","name":"<The name of Table 2 in Database 1>","newname":"<The new name of Table 2>"}]},{"type":"db","name":"<The name of Database 2>","newname":"<The new name of Database 2>","tables":[{"type":"table","name":"<The name of Table 3 in Database 2>","newname":"<The new name of Table 3>"},{"type":"table","name":"<The name of Table 4 in Database 2>","newname":"<The new name of Table 4>"}]}]
InstantRecovery	Boolean	Não	true	Define se o recurso de restauração rápida de bancos de dados e tabelas individuais será ativado. Valores válidos: true: ativa o recurso. false: desativa o recurso. Nota Para mais informações, consulte Restaurar bancos de dados e tabelas individuais de uma instância ApsaraDB RDS for MySQL.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	EA2D4F34-01A7-46EB-A339-D80882135206	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=RestoreTable
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&RestoreTime=2019-08-20T16:00:00Z
&TableMeta=[{"type":"db","name":"dtstestdata","newname":"dtstestdata","tables":[{"type":"table","name":"customer_old","newname":"customer_old123"},{"type":"table","name":"order","newname":"order123"}]}]
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<RestoreTableResponse>
<RequestId>EA2D4F34-01A7-46EB-A339-D80882135206</RequestId>
</RestoreTableResponse>

Formato JSON

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

{
  "RequestId" : "EA2D4F34-01A7-46EB-A339-D80882135206"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidRestoreType.Format	Specified restore type is not valid.	O tipo de restauração especificado é inválido. Especifique um tipo de restauração válido.
400	InvalidRestoreTime.Format	Specified restore time is not valid.	O valor do parâmetro RestoreTime é inválido. Especifique um valor válido para o parâmetro RestoreTime.
400	InvalidParamTableMeta	Invalid parameter TableMeta is null or not json format	O formato do parâmetro TableMeta é inválido. Especifique um valor válido para o parâmetro TableMeta.
400	InvalidBakHistoryDO	BakHistory is inbalid when check restore TableMeta	O arquivo de backup de dados especificado é inválido e nenhuma informação de banco de dados ou tabela está disponível.
400	InvalidParamTableMeta.Content	TableMeta missing old dbname or new dbname, please check	O valor do parâmetro TableMeta não especifica as tabelas nos bancos de dados original e novo.
400	InvalidParamTableMeta.Duplicate	TableMeta has duplicate db or table with other newname, commons or system	Bancos de dados e tabelas com os nomes especificados já existem na nova instância.
400	InvalidSourceRestoreDBName.NotFound	specific source restore dbname is not found in db list	Os bancos de dados especificados não foram encontrados no arquivo de backup de dados indicado.
400	InvalidDBName.Duplicate	Specified DB name already exists in the This instance.	O nome do banco de dados especificado já existe na instância. Altere o nome do banco de dados especificado.
400	InvalidParameters.Format	Specified parameters is not valid.	O valor de um parâmetro especificado é inválido.
400	InvalidAvZone.Format	Specified AvZone is not valid.	O valor do parâmetro AvZone é inválido.
400	InvalidRegion.Format	Specified Region is not valid.	A região especificada é inválida.
400	InvalidVpcParameter	Specified VPCId VSwitchId or IPAddress or TunnelId is not valid.	Os valores dos parâmetros VPCId e VSwitchId são inválidos.
400	MissingUserID	The request is missing a user_id parameter.	O ID de usuário especificado não existe.
400	MissingUID	The request is missing a uid parameter.	A conta utilizada não existe.
400	MissBackupSetAndRestoreTime.NotFound	Both BackupSet and RestoreTime are null.	Os parâmetros BackupId e RestoreTime estão vazios.
400	InvalidBakHistory.DbVersionMismatch	db version of bakhistory is mismatch with custins	A versão da instância original difere da nova instância.
403	InvalidBackupLogStatus	Current backup log enable status does not support this operation.	O recurso de backup de log está desativado e, consequentemente, os dados não podem ser restaurados até um ponto específico no tempo.
403	IncorrectDBInstanceType	Current DB instance type does not support this operation.	Esta operação não é compatível quando a instância está no estado atual.
403	IncorrectDBInstanceState	Current DB instance state does not support this operation.	Esta operação não é compatível quando a instância está no estado atual.
403	IncorrectBackupSetMethod	Current backup set method does not support operations.	O arquivo de backup de dados especificado não pode ser usado para restaurar bancos de dados e tabelas individuais.
403	IncorrectBackupSetState	Current backup set state does not support operations.	Esta operação não é compatível devido ao status do arquivo de backup de dados especificado.
403	ChildDBInstanceExists	Current DB instance had child instance.	Existem instâncias somente leitura anexadas à instância original.
404	InvalidBackup.NotFound	The available backup does not exist in recovery time.	Não há arquivos de backup de dados disponíveis.
404	InvalidBinlog.NotFound	The available binlog does not exist in recovery time.	Não há arquivos de backup de log binário válidos disponíveis no ponto no tempo especificado.
404	InvalidBackupSetID.NotFound	Specified backup set ID does not exist.	O arquivo de backup de dados especificado não existe. Especifique um arquivo de backup de dados válido.
404	InvalidDB.NotFound	Specified db does not exist or DB status does not support.	Os bancos de dados e tabelas especificados não foram encontrados no arquivo de backup de dados indicado.
404	InvalidDBInstance.NotFound	Specified instance does not exist or not support.	A instância não foi encontrada, foi excluída ou não é compatível com a operação.

Para obter uma lista de códigos de erro, visite o API Error Center.