Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ TaurusDB/ Referencia de la API/ Las API (recomendadas)/ Gestión de copias de respaldo/ Restauración de datos a la instancia original o a una instancia existente
Actualización más reciente 2025-03-21 GMT+08:00
Ver PDF
Compartir

Restauración de datos a la instancia original o a una instancia existente

Función

Esta API se utiliza para restaurar datos en la instancia original o una instancia existente. Antes de invocar a esta API:

Restricciones

Las instancias de base de datos no se mostrarán a menos que tengan el mismo tipo de motor de base de datos, versión y distinción entre mayúsculas y minúsculas que la instancia de base de datos original.

URI

POST /v3/{project_id}/instances/restore

Tabla 1 Parámetros de URI

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

ID de proyecto de un tenant en una región.

Para obtener este valor, consulte Obtención de un ID de proyecto.

Parámetros de solicitud

Tabla 2 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

Sí

String

Token de usuario.

Para obtener este valor, invoque a la API de IAM para obtener un token de usuario.

El valor de X-Subject-Token en el encabezado de respuesta es el valor del token.

X-Language

No

String

Tipo de idioma de solicitud. El valor predeterminado es en-us.

Valores:

  • en-us
  • zh-cn
Tabla 3 Parámetros del cuerpo de solicitud

Parámetro

Obligatorio

Tipo

Descripción

target_instance_id

Sí

String

ID de instancia de destino.

source_instance_id

Sí

String

ID de instancia de origen.

type

Sí

String

Tipo de restauración. Valores:

  • backup: indica la restauración de archivos de copia de respaldo. backup_id es obligatorio cuando type no lo es.
  • timestamp: indica la restauración de un punto en el tiempo. En este modo, restore_time es obligatorio cuando type es obligatorio.

backup_id

No

String

ID del copia de respaldo que se va a restaurar. Este parámetro debe especificarse cuando se utiliza el archivo de copia de respaldo para la restauración.

Para obtener este valor, consulte Consulta de copias de respaldo completas.

restore_time

No

Long

Punto de tiempo de restauración de datos en formato de marca de tiempo de UNIX. La unidad es de milisegundos y la zona horaria es UTC.

Parámetros de respuesta

Código de estado: 200

Tabla 4 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

job_id

String

ID de flujo de trabajo.

Código de estado: 400

Tabla 5 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Código de estado: 500

Tabla 6 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Ejemplo de la solicitud

  • Restauración de datos a la instancia original mediante un archivo de copia de respaldo 
    POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/restore
{
  "target_instance_id" : "7033e7c3cf93438797d44ad7ae0a7d95in07",
  "source_instance_id" : "690e08a7c3854c218df0e59de3b0c6cein07",
  "backup_id" : "7ffbf305376b4cbea0ae491257b6aaf9br07",
  "type" : "backup"
}
  • Restauración de datos a la instancia original con PITR 
    POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/restore
{
  "target_instance_id" : "7033e7c3cf93438797d44ad7ae0a7d95in07",
  "source_instance_id" : "690e08a7c3854c218df0e59de3b0c6cein07",
  "restore_time" : 1673852043000,
  "type" : "timestamp"
}
  • Restaurar datos en una instancia existente mediante un archivo de copia de respaldo 
    POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/restore
{
  "target_instance_id" : "7033e7c3cf93438797d44ad7ae0a7d95in07",
  "source_instance_id" : "690e08a7c3854c218df0e59de3b0c6cein07",
  "backup_id" : "be4ddfd7e2b94640b5e2cb44efb30b22br07",
  "type" : "backup"
}
  • Restaurar datos a una instancia existente con PITR 
    POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/restore
{
  "target_instance_id" : "7033e7c3cf93438797d44ad7ae0a7d95in07",
  "source_instance_id" : "690e08a7c3854c218df0e59de3b0c6cein07",
  "restore_time" : 1673852043000,
  "type" : "timestamp"
}

Ejemplo de la respuesta

Código de estado: 200

Operación exitosa.

{
  "job_id" : "dff1d289-4d03-4942-8b9f-463ea07c000d"
}

Código de estado

Para más detalles, véase Códigos de estado.

Código de error

Para más detalles, véase Códigos de error.