Consulta de archivos de copia de seguridad completa - - Centro de documentación de Alibaba Cloud

Puede llamar a la operación ListUserBackupFiles para consultar los detalles de uno o más archivos de copia de seguridad completa importados en instancias de ApsaraDB RDS for MySQL dentro de una región.

Nota

Un archivo de copia de seguridad completa contiene los datos de una base de datos MySQL autogestionada. Puede restaurar estos datos desde el archivo hacia una instancia de ApsaraDB RDS for MySQL. Para obtener más información, consulte Migración de datos de una instancia MySQL 5.7 autogestionada a la nube.
Antes de llamar a la operación CreateDBInstance para crear una instancia de ApsaraDB RDS for MySQL donde desea importar archivos de copia de seguridad completa, use la operación ListUserBackupFiles para consultar los ID de dichos archivos.
Para importar un archivo de copia de seguridad completa en una instancia de ApsaraDB RDS for MySQL, llame a la operación ImportUserBackupFile.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, le recomendamos llamar a esta operación directamente desde OpenAPI Explorer, ya que genera dinámicamente código de ejemplo para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	ListUserBackupFiles	La operación que desea ejecutar. Establezca el valor como ListUserBackupFiles.
Status	String	No	CheckSuccess	El estado de los archivos de copia de seguridad completa. Valores válidos: Importing: Los archivos se están importando. Failed: La importación de los archivos falló. CheckSucccess: Los archivos pasaron la validación. BackupSuccess: Los archivos se importaron correctamente. Deleted: Los archivos se eliminaron.
RegionId	String	Sí	cn-hangzhou	El ID de región de la instancia. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.
Comment	String	No	BackupTest	Parte de la descripción incluida en los archivos de copia de seguridad completa. Nota El sistema realiza una coincidencia aproximada basada en el valor de este parámetro.
BackupId	String	No	b-kwwvr7v8t7of********	El ID del archivo de copia de seguridad completa.
OssUrl	String	No	https://****.oss-ap-******.aliyuncs.com/backup_qp.xb	La URL desde la cual puede descargar el archivo de copia de seguridad completa almacenado como objeto en un bucket de Object Storage Service (OSS). Para más información sobre cómo obtener la URL, consulte Obtención de la URL de acceso tras cargar objetos.
Tags	String	No	key1:value1	La etiqueta asignada a los archivos de copia de seguridad completa.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	AD67C22F-64F3-4448-A9A8-D1606D242879	El ID de la solicitud.
Records	Array of Records		Matriz que contiene la información devuelta sobre los archivos de copia de seguridad completa.
Status	String	BackupSuccess	El estado del archivo de copia de seguridad completa. Valores válidos: Importing: El archivo se está importando. Failed: La importación del archivo falló. CheckSucccess: El archivo pasó la validación. BackupSuccess: El archivo se importó correctamente. Deleted: El archivo se eliminó.
CreationTime	String	1623231084000	Hora en que el sistema comenzó a importar el archivo de copia de seguridad completa. Este valor es una marca de tiempo UNIX. Unidad: milisegundos.
FinishTime	String	1623231750000	Hora en que el sistema finalizó la importación del archivo de copia de seguridad completa. Este valor es una marca de tiempo UNIX. Unidad: milisegundos.
Comment	String	BackupTest	La descripción del archivo de copia de seguridad completa.
OssFilePath	String	test/backup_qp.xb	La ruta del archivo de copia de seguridad completa almacenado como objeto en un bucket de OSS.
OssBucket	String	BackupTest	El nombre del bucket de OSS donde se almacena el archivo de copia de seguridad completa como objeto.
ModificationTime	String	1623231750000	Hora en que el sistema finalizó la importación del archivo de copia de seguridad completa. Este valor es una marca de tiempo UNIX. Unidad: milisegundos.
OssFileSize	Long	79115	El tamaño del archivo de copia de seguridad completa almacenado como objeto en un bucket de OSS. Unidad: KB.
OssFileName	String	backup_qp.xb	El nombre del archivo de copia de seguridad completa almacenado como objeto en un bucket de OSS.
EngineVersion	String	5.7	La versión del motor de base de datos que ejecuta la instancia.
BackupId	String	b-kwwvr7v8t7of********	El ID del archivo de copia de seguridad completa.
RestoreSize	String	20	La cantidad de almacenamiento necesaria para restaurar los datos del archivo de copia de seguridad completa. Unidad: GB.
ZoneId	String	cn-hangzhou-b	El ID de zona del archivo de copia de seguridad completa.
Retention	Integer	3	El periodo de retención del archivo de copia de seguridad completa. Unidad: días.
Engine	String	mysql	El motor de base de datos de la instancia.
OssUrl	String	https://****.oss-ap-******.aliyuncs.com/backup_qp.xb	La URL de descarga de OSS para el archivo de copia de seguridad completa.
OssFileMetaData	String	{\"Accept-Ranges\":\"bytes\",\"Connection\":\"keep-alive\",\"Content-Length\":81014337,\"Content-Type\":\"application/octet-stream\",\"Date\":1623309548000,\"ETag\":\"889FE9E5FCEBFE4781829488A352863B-1\",\"Last-Modified\":1622186844000,\"Server\":\"AliyunOSS\",\"x-oss-hash-crc64ecma\":\"5793608435727323129\",\"x-oss-object-type\":\"Multipart\",\"x-oss-request-id\":\"60C1BCEC92572F37318BD499\",\"x-oss-server-time\":\"166\",\"x-oss-storage-class\":\"Standard\"}	Los metadatos del archivo de copia de seguridad completa. Para más información, consulte Gestión de metadatos de objetos.
BinlogInfo	String	{\"binlogPosition\":\"154\",\"binlogFile\":\"0.000002\"}	Información sobre el archivo de registro binario que contiene datos incrementales. Este parámetro se devuelve si se generaron datos incrementales durante la copia de seguridad completa.
Reason	String	success	El motivo por el cual falló la importación del archivo de copia de seguridad completa.

Ejemplos

Solicitudes de ejemplo

http(s)://rds.aliyuncs.com/?Action=ListUserBackupFiles
&RegionId=cn-hangzhou
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<ListUserBackupFilesResponse>
<RequestId>9FB29A6E-C63A-4810-B71D-AFC65FD66309</RequestId>
<Records>
    <Status>BackupSuccess</Status>
    <Comment>b-c8677aw89jo7********</Comment>
    <EngineVersion>5.7</EngineVersion>
    <OssBucket>ghjtest</OssBucket>
    <BackupId>b-c8677aw89jo7********</BackupId>
    <ModificationTime>1623310685000</ModificationTime>
    <Retention>3</Retention>
    <OssFileMetaData>{"Accept-Ranges":"bytes","Connection":"keep-alive","Content-Length":81014337,"Content-MD5":"WBKyX0RbaSVjiwINUgEuTA==","Content-Type":"application/octet-stream","Date":1623310682000,"ETag":"5812B25F445B6925638B020D52012E4C","Last-Modified":1623310648000,"Server":"AliyunOSS","x-oss-hash-crc64ecma":"5793608435727323129","x-oss-object-type":"Normal","x-oss-request-id":"60C1C15AA846BB3737811ED8","x-oss-server-time":"17","x-oss-storage-class":"Standard"}</OssFileMetaData>
    <CreationTime>1623310685000</CreationTime>
    <OssUrl>https://******.oss-ap-********.aliyuncs.com/backup_qp.xb</OssUrl>
    <OssFileName>backup_qp.xb</OssFileName>
    <RestoreSize>20</RestoreSize>
    <OssFileSize>79115</OssFileSize>
    <Engine>mysql</Engine>
    <OssFilePath>test/backup_qp.xb</OssFilePath>
</Records>
</ListUserBackupFilesResponse>

Formato JSON

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

{
  "RequestId" : "9FB29A6E-C63A-4810-B71D-AFC65FD66309",
  "Records" : [ {
    "Status" : "BackupSuccess",
    "Comment" : "b-c8677aw89jo7********",
    "EngineVersion" : "5.7",
    "OssBucket" : "ghjtest",
    "BackupId" : "b-c8677aw89jo7********",
    "ModificationTime" : 1623310685000,
    "Retention" : 3,
    "OssFileMetaData" : "{\"Accept-Ranges\":\"bytes\",\"Connection\":\"keep-alive\",\"Content-Length\":81014337,\"Content-MD5\":\"WBKyX0RbaSVjiwINUgEuTA==\",\"Content-Type\":\"application/octet-stream\",\"Date\":1623310682000,\"ETag\":\"5812B25F445B6925638B020D52012E4C\",\"Last-Modified\":1623310648000,\"Server\":\"AliyunOSS\",\"x-oss-hash-crc64ecma\":\"5793608435727323129\",\"x-oss-object-type\":\"Normal\",\"x-oss-request-id\":\"60C1C15AA846BB3737811ED8\",\"x-oss-server-time\":\"17\",\"x-oss-storage-class\":\"Standard\"}",
    "CreationTime" : 1623310685000,
    "OssUrl" : "https://******.oss-ap-********.aliyuncs.com/backup_qp.xb",
    "OssFileName" : "backup_qp.xb",
    "RestoreSize" : 20,
    "OssFileSize" : 79115,
    "Engine" : "mysql",
    "OssFilePath" : "test/backup_qp.xb"
  } ]
}

Códigos de error

Para consultar la lista de códigos de error, visite el Centro de errores de API.