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 registros/ Obtención del enlace temporal para descargar SQL completo
Actualización más reciente 2025-03-21 GMT+08:00
Ver PDF
Compartir

Obtención del enlace temporal para descargar SQL completo

Función

Esta API se utiliza para obtener el enlace temporal para descargar SQL completo. Antes de invocar a esta API:

URI

GET /v3/{project_id}/instance/{instance_id}/auditlog/download-link

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

start_time

Sí

String

Hora de inicio, que no puede ser anterior a la hora de creación de la instancia. El formato es aaaa-mm-ddThh:mm:ssZ.

T es el separador entre el calendario y la notación horaria del tiempo. Z indica el desplazamiento de la zona horaria. Por ejemplo, si el desplazamiento de la zona horaria es de una hora, el valor de Z es de +0100.

end_time

Sí

String

La fecha y la hora de fin no pueden ser posteriores a las actuales. El formato es aaaa-mm-ddThh:mm:ssZ.

T es el separador entre el calendario y la notación horaria del tiempo. Z indica el desplazamiento de la zona horaria. Por ejemplo, si el desplazamiento de la zona horaria es de una hora, el valor de Z es de +0100.

node_id

No

String

ID del nodo.

  • Si se especifica este parámetro, el enlace solo se utiliza para descargar SQL completo del nodo.
  • Si no se especifica este parámetro, el enlace se utiliza para descargar SQL completo de todos los nodos de la instancia.

last_file_name

No

String

Nombre del último archivo consultado la última vez.

  • Si se especifica este parámetro, la consulta comienza a partir del nombre de archivo en orden alfabético.
  • Si no se especifica este parámetro, la consulta comienza desde el primer archivo.

limit

No

Integer

Número de archivos devueltos en una consulta.

Valor por defecto: 10. Valor: un número entero comprendido entre 1 y 50.

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ámetro del cuerpo de respuesta

Parámetro

Tipo

Descripción

files

Array of FileInfo objects

Se obtuvo información completa del archivo SQL.
Tabla 5 FileInfo

Parámetro

Tipo

Descripción

name

String

Nombre de archivo.

size

Long

Tamaño del archivo, en KB.

updated_time

String

Hora de la última modificación del archivo SQL. El formato es aaaa-mm-ddThh:mm:ssZ.

T es el separador entre el calendario y la notación horaria del tiempo. Z indica el desplazamiento de la zona horaria. Por ejemplo, si el desplazamiento de la zona horaria es de una hora, el valor de Z es de +0100.

download_link

String

Enlace para descargar el archivo.

link_expired_time

String

Hora de expiración del enlace. El formato es aaaa-mm-ddThh:mm:ssZ.

T es el separador entre el calendario y la notación horaria del tiempo. Z indica el desplazamiento de la zona horaria. Por ejemplo, si el desplazamiento de la zona horaria es de una hora, el valor de Z es de +0100.

Código de estado: 400

Tabla 6 Parámetros de 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 7 Parámetros de 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

Obtención del enlace temporal para descargar SQL completo

GET https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instance/669a94abef9f4979b2dfba92f48f4042in07/auditlog/download-link?node_id=2e723b45786148fc94c8737f5980786cno07&last_file_name=20230724160316_99b1d48896bb44178b715d64b68603f9in07_6a21d5df9bb24f5db83121c5fec0b1d2no07_SQLAudit_8b4b53d2-29f8-11ee-92aa-fa163ef00f0d&limit=10&start_time=2023-07-24T09:27:00+0800&end_time=2023-07-25T15:00:14+0800

Ejemplo de la respuesta

Código de estado: 200

Operación exitosa.

{
  "files" : [ {
    "name" : "20230706023359_669a94abef9f4979b2dfba92f48f4042in07_b051c8f7b98f4deeaf88ba97c8daba9dno07_SQLAudit_903bdbb6-1ba5-11ee-8b97-fa163ef0f8c2",
    "size" : 928,
    "updated_time" : "2023-07-06T02:43:57+0800",
    "download_link" : "https://obs.obs.domainname.com/bucketname/userid_instanceid/20230706/SQLAudit/xxxxxx",
    "link_expired_time" : "2023-07-13T012:30:36+0800"
  } ]
}

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 obtener más información, véase Códigos de error.

Tema principal: Gestión de registros