DescribeAuditLogRecords - AnalyticDB: Central de Documentação do Alibaba Cloud

Consulta os logs de auditoria SQL de um cluster da Data Warehouse Edition.

Descrição da operação

Antes de chamar esta operação para visualizar os logs de auditoria SQL de um cluster do AnalyticDB for MySQL, ative a Auditoria SQL. Chame a operação DescribeAuditLogConfig para consultar o status da Auditoria SQL. Se a Auditoria SQL estiver desativada, chame a operação ModifyAuditLogConfig para ativá-la.

Você pode consultar os logs de auditoria SQL apenas quando a Auditoria SQL estiver ativada. Você pode consultar apenas os logs de auditoria SQL dos últimos 30 dias. Se você desativar a Auditoria SQL e depois reativá-la, poderá consultar apenas os logs de auditoria SQL gerados após a reativação. Os logs de auditoria SQL não registram operações INSERT INTO VALUES, REPLACE INTO VALUES ou UPSERT INTO VALUES.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

adb:DescribeAuditLogRecords

get

DBCluster

acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DBClusterId	string	Sim	O ID do cluster da Data Warehouse Edition. Nota Chame a operação DescribeDBClusters para visualizar os IDs de todos os clusters da Data Warehouse Edition na região de destino.	am-t4nj8619bz2w3****
RegionId	string	Sim	O ID da região. Nota Chame a operação DescribeRegions para visualizar as regiões e zonas, incluindo os IDs das regiões, que são suportadas pelo AnalyticDB for MySQL.	cn-hangzhou
StartTime	string	Não	O início do intervalo de tempo a ser consultado. Especifique a hora no formato yyyy-MM-ddTHH:mmZ. A hora deve estar em UTC. Nota Você pode consultar os logs de auditoria SQL apenas quando a Auditoria SQL estiver ativada. Você pode consultar apenas os logs de auditoria SQL dos últimos 30 dias. Se você desativar e depois reativar a Auditoria SQL, poderá consultar apenas os logs gerados após a reativação.	2022-01-23T02:18Z
EndTime	string	Não	O fim do intervalo de tempo a ser consultado. Especifique a hora no formato yyyy-MM-ddTHH:mmZ. A hora deve estar em UTC. Nota A hora de término deve ser posterior à hora de início. O intervalo de tempo a ser consultado não pode exceder 24 horas.	2022-01-23T22:18Z
DBName	string	Não	O nome do banco de dados no qual a instrução SQL foi executada.	adb_demo
QueryKeyword	string	Não	A palavra-chave para a consulta. Esta palavra-chave é usada para filtrar instruções SQL.	adb
SqlType	string	Não	O tipo da instrução SQL. Valores válidos: DELETE SELECT UPDATE INSERT_INTO_SELECT ALTER DROP CREATE Nota Você pode consultar apenas um tipo de instrução SQL por vez. Se você deixar este parâmetro vazio, todos os tipos de instruções SQL serão consultados.	SELECT
Succeed	string	Não	Especifica se a instrução SQL foi executada com sucesso. Valores válidos: true: A instrução SQL foi executada com sucesso. false: A execução da instrução SQL falhou.	true
HostAddress	string	Não	O endereço IP e o número da porta do cliente que foi usado para executar a instrução SQL.	100.104.XX.XX:43908
OrderType	string	Não	A ordem pela qual classificar os resultados da consulta com base no tempo de execução da instrução SQL. Valores válidos: asc: ascendente. desc: descendente.	asc
User	string	Não	O nome de usuário que foi usado para executar a instrução SQL.	test_user
Order	string	Não	A ordem de classificação dos resultados da consulta. Especifique o valor como uma matriz JSON ordenada. Os resultados são classificados com base na ordem dos campos na matriz. Cada objeto na matriz contém os campos `Field` e `Type`. Field especifica o campo pelo qual classificar os resultados da consulta. Valores válidos: HostAddress: o endereço IP do cliente que se conecta ao banco de dados. Succeed: especifica se a instrução SQL foi executada com sucesso. TotalTime: o tempo total consumido para executar a instrução SQL. DBName: o nome do banco de dados no qual a instrução SQL foi executada. SQLType: o tipo da instrução SQL. User: o nome de usuário que foi usado para executar a instrução SQL. ExecuteTime: a hora de início da execução da instrução SQL. Type especifica o método de classificação. Valores válidos: Desc: descendente. Asc: ascendente.	[{"Field":"ExecuteTime","Type":"Desc"},{"Field":"HostAddress","Type":"Asc"}]
PageSize	integer	Não	O número de entradas a serem retornadas em cada página. Valores válidos: 10 30 50 100 Nota Se você não especificar este parâmetro, o valor padrão é 10.	10
PageNumber	integer	Não	O número da página. O valor deve ser um número inteiro maior que 0 e que não exceda o valor máximo do tipo de dados inteiro. Valor padrão: 1.	1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os detalhes.
TotalCount	string	O número total de entradas.	1
PageSize	string	O número de entradas retornadas por página.	10
RequestId	string	O ID da solicitação.	8A564B7F-8C00-43C0-8EC5-919FBB70573
PageNumber	string	O número da página.	1
DBClusterId	string	O ID do cluster.	am-t4nj8619bz2w3****
Items	array<object>	Os detalhes dos logs de auditoria SQL.
	object	A lista.
HostAddress	string	O endereço IP e o número da porta do cliente que foi usado para executar a instrução SQL.	100.104.XX.XX:43908
Succeed	string	Indica se a instrução SQL foi executada com sucesso. Valores válidos: true: A instrução SQL foi executada com sucesso. false: A execução da instrução SQL falhou.	true
SQLText	string	Os detalhes da instrução SQL.	SELECT * FROM tb_courses
TotalTime	string	A duração da execução da instrução SQL. Unidade: milissegundos (ms).	216
ConnId	string	Este parâmetro é inválido.	无
DBName	string	O nome do banco de dados no qual a instrução SQL foi executada.	adb_test
SQLType	string	O tipo da instrução SQL.	SELECT
ProcessID	string	O ID da tarefa.	202106081752021720161662490345362390
User	string	O nome de usuário que foi usado para executar a instrução SQL.	test_user
ExecuteTime	string	A hora de início da execução da instrução SQL. A hora está no formato yyyy-MM-dd HH:mm:ss e é a sua hora local.	2022-01-23 16:05:08
ExecuteTimestamp	integer

Exemplos

Resposta de sucesso

JSON formato

{
  "TotalCount": "1",
  "PageSize": "10",
  "RequestId": "8A564B7F-8C00-43C0-8EC5-919FBB70573",
  "PageNumber": "1",
  "DBClusterId": "am-t4nj8619bz2w3****",
  "Items": [
    {
      "HostAddress": "100.104.XX.XX:43908",
      "Succeed": "true",
      "SQLText": "SELECT * FROM tb_courses",
      "TotalTime": "216",
      "ConnId": "无",
      "DBName": "adb_test",
      "SQLType": "SELECT",
      "ProcessID": "202106081752021720161662490345362390",
      "User": "test_user",
      "ExecuteTime": "2022-01-23 16:05:08",
      "ExecuteTimestamp": 0
    }
  ]
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
404	InvalidDBCluster.NotFound	The DBClusterId provided does not exist in our records.	The specified DBClusterId parameter does not exist. Make sure that the DBClusterId value is valid.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.