Importar um arquivo de backup completo - : Central de Documentação do Alibaba Cloud

Nota

Um arquivo de backup completo contém os dados de um banco de dados MySQL autogerenciado. É possível restaurar esses dados para uma instância do ApsaraDB RDS for MySQL a partir de um arquivo de backup completo.

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

O banco de dados MySQL autogerenciado deve executar o MySQL 5,7, e os dados do banco de dados devem ter sido copiados com XtraBackup e salvos como um arquivo de backup completo cujo nome termina com _qp.xb. Para mais informações, consulte Migrate the full backup data of a self-managed MySQL 5.7 database to an ApsaraDB RDS for MySQL instance.
O arquivo de backup completo do banco de dados MySQL autogerenciado deve ser carregado para um bucket do Object Storage Service (oss) na região da instância do ApsaraDB RDS for MySQL. Para mais informações, consulte Migrate the full backup data of a self-managed MySQL 5.7 database to an ApsaraDB RDS for MySQL instance.

Nota

Esta operação é compatível somente com o MySQL 5,7.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua comodidade, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de requisição

Parameter	Type	Required	Example	Description
Action	String	Yes	ImportUserBackupFile	A operação a ser executada. Defina o valor como ImportUserBackupFile.
BackupFile	String	Yes	{"Bucket":"test", "Object":"test/test_db_employees.xb","Location":"ap-southeast-1"}	Um array JSON com as informações sobre o arquivo de backup completo armazenado como objeto em um bucket oss. Exemplo: `{"Bucket":"test", "Object":"test/test_db_employees.xb","Location":"ap-southeast-1"}` Os seguintes parâmetros são usados no array: Bucket: O nome do bucket oss no qual o arquivo de backup completo está armazenado como objeto. Chame a operação GetBucket para consultar as informações sobre todos os objetos armazenados em um bucket oss. Object: O caminho do arquivo de backup completo armazenado como objeto em um bucket oss. Chame a operação GetObject para consultar as informações sobre todos os caminhos em um bucket oss. Location: O ID da região onde o bucket oss está localizado. Chame a operação GetBucketLocation para consultar a região de um bucket oss.
BucketRegion	String	Yes	cn-hangzhou	O ID da região do bucket oss onde o arquivo de backup completo está localizado. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
EngineVersion	String	Yes	5.7	A versão do mecanismo de banco de dados executado no banco de dados MySQL autogerenciado e na instância do ApsaraDB RDS for MySQL. Defina o valor como 5.7.
RegionId	String	Yes	cn-hangzhou	O ID da região da instância do ApsaraDB RDS for MySQL. Chame a operação DescribeRegions para consultar a lista de regiões mais recente. Nota O valor deste parâmetro é o ID da região onde você deseja criar uma instância do ApsaraDB RDS for MySQL. O valor deste parâmetro deve ser consistente com o valor do parâmetro BucketRegion.
Comment	String	No	BackupTest	A descrição do arquivo de backup completo.
RestoreSize	Integer	No	20	O tamanho do espaço de armazenamento necessário para restaurar os dados do arquivo de backup completo. Unidade: GB. Nota O valor padrão deste parâmetro corresponde a 5 vezes o tamanho do arquivo de backup completo. O valor mínimo deste parâmetro é 20.
Retention	Integer	No	30	O período de retenção do arquivo de backup completo. Unidade: dias. Valores válidos: qualquer inteiro positivo diferente de zero.
ZoneId	String	No	cn-hangzhou-b	O ID da zona da instância do ApsaraDB RDS for MySQL. Chame a operação DescribeRegions para consultar os IDs das zonas. Nota Se este parâmetro for especificado, o sistema cria um snapshot em segundos de um dígito, reduzindo significativamente o tempo necessário para importar o arquivo de backup completo. Ao chamar a operação CreateDBInstance para criar uma instância do ApsaraDB RDS for MySQL usando o arquivo de backup completo, a nova instância é criada na zona especificada neste parâmetro.

Parâmetros de resposta

Parameter	Type	Example	Description
BackupId	String	b-n8tpg24c6i0v****	O ID do arquivo de backup completo.
RequestId	String	A140DD14-DCC9-4548-9C72-52A49A58A310	O ID da solicitação.
Status	Boolean	true	Indica se o arquivo de backup completo foi importado para a instância do ApsaraDB RDS for MySQL. Se a importação for bem-sucedida, o valor true é retornado. Caso contrário, uma mensagem de erro é retornada.

Exemplos

Exemplos de requisições

http(s)://rds.aliyuncs.com/?Action=ImportUserBackupFile
&BackupFile={"Bucket":"test", "Object":"test/test_db_employees.xb","Location":"ap-southeast-1"}
&BucketRegion=cn-hangzhou
&EngineVersion=5.7
&RegionId=cn-hangzhou
&<Common request parameters>

Exemplos de respostas bem-sucedidas

Formato XML

<ImportUserBackupFileResponse>
      <RequestId>A140DD14-DCC9-4548-9C72-52A49A58A310</RequestId>
      <BackupId>b-n8tpg24c6i0v********</BackupId>
      <Status>true</Status>
</ImportUserBackupFileResponse>

Formato JSON

{
    "RequestId":"A140DD14-DCC9-4548-9C72-52A49A58A310",
    "BackupId":"b-n8tpg24c6i0v********",
    "Status":"true"
}

Códigos de erro

HTTP status code	Error code	Error message	Description
400	InvalidOssBackupFile.InvalidFile	The specified OSS backup file is invalid.	O erro indica que o arquivo de backup completo especificado não foi encontrado no bucket oss indicado.
400	OperationDenied.Product	The product code is not supported.	O erro indica que o código do produto não é compatível.

Para ver a lista de códigos de erro, acesse o API Error Center.