DescribeSQLLogFiles操作を呼び出して、ApsaraDB RDSインスタンスのSQL Explorerおよび監査機能によって生成される監査ログファイルを照会できます。

この操作を呼び出す前に、インスタンスが次のデータベースエンジンのいずれかを実行していることを確認してください。

  • MySQL
  • SQL Server 2008 R2
  • PostgreSQL
説明 DescribeSQLLogFiles操作を使用して、ApsaraDB RDS for MySQLインスタンスのSQL Explorer Trial Editionによって生成された監査ログファイルを照会することはできません。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須/任意 例: 説明 
操作 String 必須 DescribeSQLLogFiles

実行する操作です。 値をDescribeSQLLogFilesに設定します。

DBInstanceId String 必須 rm-uf6wjk5xxxxxx

インスタンスの ID です。

FileName String 任意 custinsxxxxx.csv

監査ログファイルの名前。

PageSize Integer いいえ 30

各ページで返されるエントリ数。 有効値: 30〜200 デフォルト値: 30

PageNumber Integer いいえ 1

返されるページ数。 有効な値: 1 ~ 100000

既定値:1

レスポンスパラメーター

項目 データ型 例: 説明 
RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

リクエストの ID です。

PageNumber Integer 1

返されたページ数。

PageRecordCount Integer 10

現在のページで返されたエントリの数。

TotalRecordCount Integer 10

返されたエントリの総数。

項目 LogFileの配列

返された監査ログファイルで構成される配列。

ログファイル
FileID String custinsxxxxx.csv

監査ログファイルの名前。

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

監査ログファイルに記録された最初のSQL文が実行された時刻。 日時は ISO 8601 規格 (yyyy-MM-ddTHH:mm:ssZ 形式) に準拠します。 時刻は UTC で表示されます。

LogSize String 3000

監査ログファイルのサイズ。 単位:バイト

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

監査ログファイルのダウンロードURL。 監査ログファイルをダウンロードできない場合、このパラメーターはnullです。

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

監査ログファイルに最後に記録されたSQL文が実行された時刻です。 日時は ISO 8601 規格 (yyyy-MM-ddTHH:mm:ssZ 形式) に準拠します。 時刻は UTC で表示されます。

ログステータス String 成功

監査ログファイルの状態。 有効な値:

  • 成功
  • 失敗しました
  • 生成中

リクエストの例

http(s):// rds.aliyuncs.com/?Action=DescribeSQLLogFiles
&DBInstanceId=rm-uf6wjk5xxxxxx
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

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

<?xml version="1.0" encoding="UTF-8" ?>
<DescribeSQLLogFilesResponse>
<items>
<FileID>ZUBaS964T3OYtxxxxxxxx</FileID>
<LogStatus> 成功 </LogStatus>
<LogStartTime>2015-05-23T07:00:00Z</LogStartTime>
<LogEndTime>2015-05-23T07:00:00Z</LogEndTime>
<LogDownloadUR L>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 形式

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

{
  "items" : [ {
    "FileID" : "ZUBaS964T3OYtxxxxxxxx" 、
    "LogStatus" : "成功" 、
    "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
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。