Todos os produtos
Search
Central de documentação

:Consultar arquivos de log de auditoria gerados pelo SQL Explorer and Audit

Última atualização: Jun 26, 2026

Chame a operação DescribeSQLLogFiles para consultar os arquivos de log de auditoria gerados pelo recurso SQL Explorer and Audit de uma instância do ApsaraDB RDS.

Antes de chamar esta operação, verifique se a instância utiliza um dos seguintes mecanismos de banco de dados:

  • MySQL

  • SQL Server 2008 R2

  • PostgreSQL

Nota

A operação DescribeSQLLogFiles não pode ser usada para consultar os arquivos de log de auditoria gerados pelo SQL Explorer Trial Edition para uma instância do ApsaraDB RDS for MySQL.

Debugging

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para facilitar o uso, recomendamos chamar esta operação no OpenAPI Explorer, que gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Request parameters

Parameter

Type

Required

Example

Description

Action

String

Yes

DescribeSQLLogFiles

A operação a ser executada. Defina o valor como DescribeSQLLogFiles.

DBInstanceId

String

Yes

rm-uf6wjk5xxxxxx

O ID da instância.

FileName

String

No

custinsxxxxx.csv

O nome do arquivo de log de auditoria.

PageSize

Integer

No

30

O número de entradas a retornar por página. Valor válido: 30 a 200. Valor padrão: 30.

PageNumber

Integer

No

1

O número da página a retornar. Valores válidos: 1 a 100000.

Valor padrão: 1.

Response parameters

Parameter Type Example Description
RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

O ID da requisição.

PageNumber Integer 1

O número da página retornada.

PageRecordCount Integer 10

O número de entradas retornadas na página atual.

TotalRecordCount Integer 10

O número total de entradas retornadas.

Items Array of LogFile

Um array composto pelos arquivos de log de auditoria retornados.

LogFile
FileID String custinsxxxxx.csv

O nome do arquivo de log de auditoria.

LogStartTime String 2015-05-23T07:00:00Z

O horário em que a primeira instrução SQL registrada no arquivo de log de auditoria foi executada. O horário segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ e é exibido em UTC.

LogSize String 3000

O tamanho do arquivo de log de auditoria. Unidade: bytes.

LogDownloadURL String http://rdslog-hz-v3.oss-cn-hangzhou.aliyuncs.com/xxxxx

A URL para baixe o arquivo de log de auditoria. Se o arquivo não puder ser baixado, este parâmetro será nulo.

LogEndTime String 2015-05-24T07:00:00Z

O horário em que a última instrução SQL registrada no arquivo de log de auditoria foi executada. O horário segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ e é exibido em UTC.

LogStatus String Success

O status do arquivo de log de auditoria. Valores válidos:

  • Success
  • Failed
  • Generating

Examples

Exemplos de requisição

http(s)://rds.aliyuncs.com/?Action=DescribeSQLLogFiles
&DBInstanceId=rm-uf6wjk5xxxxxx
&<Common request parameters>

Exemplos de resposta bem-sucedida

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<DescribeSQLLogFilesResponse>
	<items>
		<FileID>ZUBaS964T3OYtxxxxxxxx</FileID>
		<LogStatus>Success</LogStatus>
		<LogStartTime>2015-05-23T07:00:00Z</LogStartTime>
		<LogEndTime>2015-05-23T07:00:00Z</LogEndTime>
		<LogDownloadURL>xxxxxx.cn-hangzhou.oss.aliyun-inc.com/xxxxx</LogDownloadURL>
		<LogSize>257</LogSize>
	</items>
	<pageRecordCount>1</pageRecordCount>
	<requestId> 1AD222E9-E606-4A42-BF6D-8A4442913CEF</requestId>
	<totalRecordCount>1</totalRecordCount>
</DescribeSQLLogFilesResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "items" : [ {
    "FileID" : "ZUBaS964T3OYtxxxxxxxx",
    "LogStatus" : "Success",
    "LogStartTime" : "2015-05-23T07:00:00Z",
    "LogEndTime" : "2015-05-23T07:00:00Z",
    "LogDownloadURL" : "xxxxxx.cn-hangzhou.oss.aliyun-inc.com/xxxxx",
    "LogSize" : "257"
  } ],
  "pageRecordCount" : 1,
  "requestId" : " 1AD222E9-E606-4A42-BF6D-8A4442913CEF",
  "totalRecordCount" : 1
}

Error codes

Para obter a lista de códigos de erro, acesse o API Error Center.