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/ Consulta de tablas para recuperación puntual a nivel de tabla
Actualización más reciente 2025-03-21 GMT+08:00
Ver PDF
Compartir

Consulta de tablas para recuperación puntual a nivel de tabla

Función

Esta API se utiliza para consultar las tablas disponibles para la recuperación puntual a nivel de tabla (PITR). Antes de invocar a esta API:

URI

GET /v3/{project_id}/instances/{instance_id}/backups/restore/tables

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.

instance_id

Sí

String

ID de instancia, que es compatible con el formato UUID.
Tabla 2 Parámetros de consulta

Parámetro

Obligatorio

Tipo

Descripción

restore_time

Sí

String

Hora de copia de respaldo, en formato de marca de tiempo.

Para obtener este valor, véase Consulta del intervalo de tiempo de restauración.

last_table_info

Sí

String

Si los datos se restauran en la tabla más reciente.

  • true: tabla más reciente
  • false: tabla de tiempo específico

database_name

No

String

Nombre de la base de datos, que se utiliza para la coincidencia parcial.

table_name

No

String

Nombre de la tabla, que se utiliza para la coincidencia difusa.

Parámetros de solicitud

Tabla 3 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

Parámetros de respuesta

Código de estado: 200

Tabla 4 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

total_databases

Integer

Número total de bases de datos.

databases

Array of RestoreDatabaseInfos objects

Información de la base de datos.
Tabla 5 RestoreDatabaseInfos

Parámetro

Tipo

Descripción

name

String

Nombre de la base de datos.

total_tables

Integer

Cantidad total de tablas.

tables

Array of RestoreDatabaseTableInfo objects

Información de la tabla.
Tabla 6 RestoreDatabaseTableInfo

Parámetro

Tipo

Descripción

name

String

Nombre de tabla.

Código de estado: 400

Tabla 7 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 8 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

Consulta de tablas para recuperación puntual a nivel de tabla

GET https://{endpoint}/v3/97b026aa9cc4417888c14c84a1ad9860/instances/61a4ea66210545909d74a05c27a7179ein07/backups/restore/tables?database_name=test&last_table_info=true&restore_time=1690890940000&table_name=t

Ejemplo de la respuesta

Código de estado: 200

Operación exitosa.

{
  "total_databases" : 1,
  "databases" : [ {
    "name" : "test_db_1",
    "total_tables" : 1,
    "tables" : [ {
      "name" : "t3"
    } ]
  } ]
}

Código de estado

Código de estado

Descripción

200

Operación exitosa.

400

Error de cliente.

500

Error de servidor.

Código de error

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