Obtenção de uma lista de logs de auditoria
Função
Esta API é usada para obter uma lista de logs de auditoria.
- Antes de chamar uma API, você precisa entender a API em Autenticação.
URI
- Formato de URI
GET /v3/{project_id}/instances/{instance_id}/auditlog?start_time={start_time}&end_time={end_time}&offset={offset}&limit={limit}
- Descrição do parâmetro
Tabela 1 Descrição do parâmetro Nome
Obrigatório
Descrição
project_id
Sim
Especifica o ID do projeto de um locatário em uma região.
Para obter detalhes sobre como obter o ID do projeto, consulte Obtenção de um ID de projeto.
instance_id
Sim
Especifica o ID da instância de banco de dados consultada.
start_time
Sim
Especifica a hora de início para obter a lista de backups. O formato da hora de início é "yyyy-mm-ddThh:mm:ssZ".
T é o separador entre o calendário e a notação horária do tempo. Z indica o deslocamento do fuso horário. Por exemplo, no fuso horário de Pequim, o deslocamento do fuso horário é mostrado como +0800.
end_time
Sim
Especifica a hora de término para obtenção da lista de backups. O formato da hora de término é "yyyy-mm-ddThh:mm:ssZ" e a hora de término deve ser posterior à hora de início. O intervalo de tempo não pode ser superior a 30 dias.
T é o separador entre o calendário e a notação horária do tempo. Z indica o deslocamento do fuso horário. Por exemplo, no fuso horário de Pequim, o deslocamento do fuso horário é mostrado como +0800.
offset
Sim
Especifica a posição do índice.
Se offset estiver definido como N, a consulta de recursos começará a partir do dado N+1. O valor é 0 por padrão, indicando que a consulta começa a partir da primeira parte dos dados. O valor não pode ser um número negativo.
limit
Sim
Especifica o número de registros a serem consultadas. O intervalo de valores é de 1 a 50.
Solicitação
Resposta
- Resposta normal
Tabela 2 Descrição do parâmetro Nome
Tipo
Descrição
auditlogs
Array of objects
Indica informações detalhadas.
Para mais detalhes, consulte Tabela 3.
total_record
Integer
Indica o número total de registros.
Tabela 3 Descrição da estrutura de dados do campo auditlogs Nome
Tipo
Descrição
id
String
Indica o ID do log de auditoria.
name
String
Indica o nome do arquivo de log de auditoria.
size
Long
Indica o tamanho em KB do log de auditoria.
begin_time
String
Indica a hora de início do log de auditoria. O formato é "yyyy-mm-ddThh:mm:ssZ".
T é o separador entre o calendário e a notação horária do tempo. Z indica o deslocamento do fuso horário. Por exemplo, no fuso horário de Pequim, o deslocamento do fuso horário é mostrado como +0800.
end_time
String
Indica a hora de término do log de auditoria. O formato é "yyyy-mm-ddThh:mm:ssZ".
T é o separador entre o calendário e a notação horária do tempo. Z indica o deslocamento do fuso horário. Por exemplo, no fuso horário de Pequim, o deslocamento do fuso horário é mostrado como +0800.
- Exemplo de resposta 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 }
- Resposta anormal
Para mais detalhes, consulte Resultados anormais da solicitação.
Código de status
- Normal
- Anormal
Para mais detalhes, consulte Códigos de status.
Código de erro
Para mais detalhes, consulte Códigos de erro.