Verificar a possibilidade de restauração de dados de uma instância com um conjunto de backup entre regiões - : Central de Documentação do Alibaba Cloud

Antes de usar esta operação, confirme que a instância de origem executa um dos seguintes mecanismos de banco de dados:

MySQL. Para mais informações, consulte Fazer backup de uma instância do ApsaraDB RDS for MySQL entre regiões.
SQL Server. Para mais informações, consulte Fazer backup de uma instância do ApsaraDB RDS for SQL Server entre regiões.
PostgreSQL. Para mais informações, consulte

Fazer backup de uma instância do ApsaraDB RDS for PostgreSQL entre regiões

.

Nota
Se a instância do ApsaraDB RDS for PostgreSQL utilizar a nova arquitetura e tiver sido criada após 10 de outubro de 2022, esse recurso não será compatível. Para mais detalhes, consulte

[[Aviso] Autorização SLR necessária para criar instância do ApsaraDB RDS for PostgreSQL a partir de 10 de outubro de 2022](~~452313~~)

.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta operação no OpenAPI Explorer, que também gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CheckCreateDdrDBInstance	Operação a ser executada. Defina o valor como CheckCreateDdrDBInstance.
RegionId	String	Sim	cn-hangzhou	ID da região da instância de destino. Use a operação DescribeRegions para consultar a lista de regiões mais recente.
Engine	String	Sim	MySQL	Mecanismo de banco de dados da instância de destino. Valores válidos: MySQL SQLServer PostgreSQL
EngineVersion	String	Sim	5.6	Versão principal do mecanismo da instância de destino. O valor varia conforme o parâmetro Engine. Para Engine definido como MySQL: 5.5, 5.6, 5.7 e 8.0 Para Engine definido como 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 e 2019_ent Para Engine definido como PostgreSQL: 10.0, 11.0, 12.0, 13.0, 14.0 e 15.0
DBInstanceClass	String	Sim	rds.mysql.s1.small	Tipo da instância de destino. Para mais informações, consulte Tipos de instância primária do ApsaraDB RDS.
DBInstanceStorage	Integer	Sim	20	Capacidade de armazenamento da instância de destino. Valores válidos: 5 a 2000. Unidade: GB. O valor deve ser múltiplo de 5 GB. Para mais informações, consulte Tipos de instância primária do ApsaraDB RDS.
RestoreType	String	Sim	0	Método de restauração. Valores válidos: 0: restaura dados de um conjunto de backup. Ao definir como 0, especifique também o parâmetro BackupSetId. 1: restaura dados para um ponto no tempo. Ao definir como 1, especifique também os parâmetros RestoreTime, SourceRegion e SourceDBInstanceName. Valor padrão: 0.
BackupSetId	String	Não	14358	ID do conjunto de backup usado na restauração. Use a operação DescribeCrossRegionBackups para consultar o ID do conjunto de backup. Nota Se RestoreType for definido como 0, este parâmetro é obrigatório.
RestoreTime	String	Não	2019-05-30T03:29:10Z	Ponto no tempo para restauração dos dados. O momento especificado deve ser anterior à hora atual. Use o formato ISO 8601 aaaa-MM-ddTHH:mm:ssZ, em UTC. Nota Se RestoreType for definido como 1, este parâmetro é obrigatório.
SourceRegion	String	Não	cn-hangzhou	ID da região da instância de origem para restauração baseada em ponto no tempo. Nota Se RestoreType for definido como 1, este parâmetro é obrigatório.
SourceDBInstanceName	String	Não	rm-uf6wjk5xxxxxxx	ID da instância de origem para restauração baseada em ponto no tempo. Nota Se RestoreType for definido como 1, este parâmetro é obrigatório.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
IsValid	String	true	Indica se os dados da instância de origem podem ser restaurados entre regiões. Valores válidos: true e false.
RequestId	String	1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=CheckCreateDdrDBInstance
&RegionId=cn-hangzhou
&Engine=MySQL
&DBInstanceClass=rds.mysql.s1.small
&DBInstanceStorage=20
&EngineVersion=5.6
&RestoreType=0
&BackupSetId=14358
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<CheckCreateDdrDBInstanceResponse>
  <IsValid>true</IsValid>
  <RequestId>346C62D7-8BB9-4516-93E7-25A469EAABCB</RequestId>
</CheckCreateDdrDBInstanceResponse>

Formato JSON

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

{
  "IsValid" : "true",
  "RequestId" : "346C62D7-8BB9-4516-93E7-25A469EAABCB"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IncorrectDBInstanceType	Current DB instance engine and type does not support operations.	A operação não é compatível com o mecanismo de banco de dados e o tipo da instância.
400	InvalidRestoreType.Format	Specified restore type is not valid.	Tipo de restauração inválido. Especifique um tipo válido.
400	NoBackupSetRegion	BackupSetRegion is absence.	A região do backup não existe.
400	IncorrectBackupSetType	Backup set type should be ddr.	O tipo do conjunto de backup não é DDR.
400	NoSourceInstanceName	No SourceDBInstanceName.	Nome da instância de origem não encontrado.
400	NoAvailableDisasterRestoreBakset	No available disaster restore bakset.	Nenhum conjunto de backup disponível encontrado.
400	IncorrectBackupSetMethod	Current backup set method does not support operations.	O conjunto de backup especificado não permite restaurar bancos de dados e tabelas individuais.
400	InvalidBackupType.Format	Specified backup type is not valid.	Tipo de backup inválido.
400	IncorrectEngineVersion	Current engine version does not support operations.	Operação incompatível com a versão do mecanismo de banco de dados da instância.
400	IncorrectBaksetVersion	Current bakset version does not support operations.	Operação incompatível com a versão do conjunto de backup.
400	CrossRegionUnsupportTDE	Cross-region disaster restore not support TDE bakset.	Conjuntos de backup com TDE não permitem restauração entre regiões.
400	DisasterRestoreRegionNotMatched	Disaster restore should be operated in the ddr region or source region.	A recuperação de desastres deve ocorrer na região de origem ou de destino.
400	InvalidMinorVersion.NotFound	Specified minor version does not exists.	A versão secundária do mecanismo especificada não existe.
400	InvalidDBInstanceId.MalFormed	The specified parameter DBInstanceId is not valid.	ID da instância inválido. Verifique o ID.
400	InvalidEngine.Malformed	Specified engine is not valid.	Mecanismo de banco de dados inválido. Especifique um mecanismo válido.
400	InvalidEngineVersion.Malformed	Specified engine version is not valid.	Versão do mecanismo de banco de dados inválida. Verifique a versão e tente novamente.
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	UserPermissionFailure	The request processing has failed due to user permission.	Permissões insuficientes para executar a operação.
400	InvalidServiceType.Format	Specified service type is not valid.	Tipo de serviço inválido. Defina como 0 (serviço Alibaba Cloud) ou 1 (serviço JST).
400	InvalidStorage.Format	Specified Storage is not valid.	Valor do parâmetro Storage inválido. Especifique um valor válido.
403	IncorrectDBType	The current DB type does not support this operation.	O mecanismo de banco de dados da instância não oferece suporte a esta operação. Selecione outro mecanismo.
403	IncorrectDBInstance	The current DB instance does not support this operation.	A instância não oferece suporte a esta operação.
403	ResourceConfigError	The request processing has failed due to resource config error.	Erro de configuração de recurso.
404	RestoreType.NotFound	RestoreType is not found.	O método de restauração especificado não existe.
404	InvalidBackupSetID.NotFound	Specified backup set ID does not exist.	Conjunto de backup especificado não encontrado. Informe um conjunto válido.
404	InvalidDBInstance.NotFound	The specified instance does not exist or is not supported.	Instância especificada não encontrada. Verifique o ID.
404	InvalidDBInstanceClass.NotFound	Specified DB instance class is not found.	Tipo de instância não encontrado ou indisponível para compra. Selecione um tipo disponível.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.