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

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:

Aprender cómo autorizar y autenticarla.
Obtenga la región y el punto de conexión requeridos.

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"
    } ]
  } ]
}