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> Relational Database Service> Referencia de la API> API v3 (recomendado)> Consultas de información de registro> Obtención de una lista de registro de auditoría

Actualización más reciente 2024-06-06 GMT+08:00

Ver PDF

Obtención de una lista de registro de auditoría

Función

Esta API se utiliza para obtener una lista de registros de auditoría.

Antes de invocar a una API, debe entender la API de Autenticación.

URI

Formato de URI
GET /v3/{project_id}/instances/{instance_id}/auditlog?start_time={start_time}&end_time={end_time}&offset={offset}&limit={limit}

Descripción de parámetro

**Tabla 1** Descripción de parámetro
Nombre	Obligatorio	Descripción
project_id	Sí	Especifica el ID de proyecto de un tenant en una región. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.
instance_id	Sí	Especifica el ID de la instancia de base de datos consultada.
start_time	Sí	Especifica la hora de inicio para obtener la lista de copia de respaldo. El formato de la hora de inicio 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, en la zona horaria de Beijing, el desplazamiento de zona horaria se muestra como +0800.
end_time	Sí	Especifica la hora de finalización para obtener la lista de copia de respaldo. El formato de la hora de finalización es "aaaa-mm-ddThh:mm:ssZ" y la hora de finalización debe ser posterior a la hora de inicio. El lapso de tiempo no puede ser superior a 30 días. T es el separador entre el calendario y la notación horaria del tiempo. Z indica el desplazamiento de la zona horaria. Por ejemplo, en la zona horaria de Beijing, el desplazamiento de zona horaria se muestra como +0800.
offset	Sí	Especifica la posición del índice. Si offset se establece en N, la consulta de recursos comienza desde el dato N+1. El valor es 0 de forma predeterminada, lo que indica que la consulta comienza desde el primer dato. El valor no puede ser un número negativo.
limit	Sí	Especifica el número de registros que se van a consultar. El intervalo de valores es de 1 a 50.

Solicitud

Parámetros de solicitud
Ninguna
Ejemplo de URI
GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/cee5265e1e5845649e354841234567dfin01/auditlog?start_time=2019-11-06T09:00:00+0800&end_time=2019-11-07T10:40:15+0800&offset=0&limit=10

Respuesta

Respuesta normal

**Tabla 2** Descripción de parámetro
Nombre	Tipo	Descripción
auditlogs	Array of objects	Indica información detallada. Para obtener más información, consulte Tabla 3.
total_record	Integer	Indica el número total de registros.

**Tabla 3** descripción de la estructura de datos de campo de registros de auditoría
Nombre	Tipo	Descripción
id	String	Indica el ID del registro de auditoría.
name	String	Indica el nombre del archivo de registro de auditoría.
size	Long	Indica el tamaño en KB del registro de auditoría.
begin_time	String	Indica la hora de inicio del registro de auditoría. 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, en la zona horaria de Beijing, el desplazamiento de zona horaria se muestra como +0800.
end_time	String	Indica la hora de finalización del registro de auditoría. 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, en la zona horaria de Beijing, el desplazamiento de zona horaria se muestra como +0800.

Ejemplo de respuesta normal

{
	"auditlogs": [{
		"id": "fa163ea0e2bet11e9d832166a2cf894c5br01",
		"name": "2943db4292ee4d4abb1ae2df4870fedf_528f6b03c71c4d559ca4f60b6e20795fin01/39779175_20220825/Audit/317156_20190916032844_eb8fe5d181ec44a2850302691541f760in01_Audit_166a2cf8-d832-11e9-94c5-fa163ea0e2be",
		"size": 20481.835938,
		"begin_time": "2019-11-06T09:03:34+0800",
		"end_time": "2019-11-06T10:39:15+0800"
	}, {
		"id": "fa163ea0e2bet11e9d832136a668094c5br01",
		"name": "2943db4292ee4d4abb1ae2df4870fedf_528f6b03c71c4d559ca4f60b6e20795fin01/39779175_20220825/Audit/317162_20190916032838_eb8fe5d181ec44a2850302691541f760in01_Audit_136a6680-d832-11e9-94c5-fa163ea0e2be",
		"size": 20481.835938,
		"begin_time": "2019-11-07T09:04:35+0800",
		"end_time":"2019-11-07T10:38:16+0800"
	}],
	"total_record": 2
}