本文へジャンプします。

ニフティクラウド APIリファレンス

クラウド トップ>API>RDB>DescribeDBLogFiles

RDB:DescribeDBLogFiles

処理概要

DBサーバー内のログファイルの一覧を取得します。

リクエストパラメーター

要素名 説明 必須 最大値 デフォルト値 備考
DBInstanceIdentifier ログファイル一覧を取得するDBサーバーの名前 文字列  
FileLastWritten

ログファイルの最終書き込み日時

  • ※このパラメーターに指定した日時以降に書き込みが行われたログファイルの情報が返却されます
形式:POSIX タイムスタンプ
  Long  
FileSize

ログファイルのサイズ(バイト)

  • ※このパラメーターに指定したよりもサイズの大きいログファイルの情報が返却されます
  Long  
FilenameContains

ログファイル名に含まれる文字列

  • ※このパラメーターに指定した文字列をファイル名に含むログファイルの情報が返却されます
  文字列  
Marker

マーカー

  • ※ページネート用にログファイル一覧の取得位置を表す文字列です
  • ※前回のDescribeDBLogFilesリクエストで返却された値を指定します
  • ※この値が指定された場合、取得位置より後のイベントが返却されます
  文字列  
MaxRecords レスポンスに含まれるレコードの最大値   数値  

レスポンス

XML

status

statusは共通の応答メッセージを返却します。

result
要素名 説明 備考
DescribeDBLogFilesResponse ルート  
DescribeDBLogFilesResult 結果  
DescribeDBLogFiles ログファイル詳細リスト リスト  
DescribeDBLogFilesDetails ログファイル詳細  
LastWritten 最後にログが書き込まれた日時
形式:POSIX タイムスタンプ
Long  
LogFileName ログファイル名 文字列  
Size ログファイルのサイズ(バイト) Long  
Marker マーカー 文字列  
ResponseMetadata 共通メタ情報  

エラー

コード メッセージ タイプ HTTP
ステータスコード
説明
DBInstanceNotFound DBInstance aaaa not found. Sender 404 DBInstanceIdentifierに存在しないIDを指定した場合
InvalidParameterValue The parameter DBInstanceIdentifier must be provided and must not be blank. Sender 400 必須のDBInstanceIdentifierを指定しなかった場合
Invalid database identifier: --aaa Sender 400
  • DBInstanceIdentifierに無効な値(ハイフンから始まるなど)を指定した場合
  • 63文字以上指定した場合
MalformedInput   Sender 400 FileLastWrittenに数値以外を設定した場合
  Sender 400 FileLastWrittenにLongの範囲を超える数値を設定した場合
  Sender 400 FileSizeに数値以外を設定した場合
  Sender 400 FileSizeにLongの範囲を超える数値を設定した場合
  Sender 400 MaxRecordsに数値以外を指定した場合
  Sender 400 MaxRecordsにintの範囲外(2147483647〜2147483648)の値を指定した場合

サンプル

リクエストサンプル
https://rdb.jp-east-1.api.cloud.nifty.com/
    ?Action=DescribeDBLogFiles
    &DBInstanceIdentifier=mydbinstance
    &SignatureVersion=2
    &SignatureMethod=HmacSHA256
    &Timestamp=2013-12-09T00%3A00%3A00.000Z
    &AWSAccessKeyId=<Nifty Cloud Access Key ID>
    &Signature=<Signature>
レスポンスサンプル
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<DescribeDBLogFilesResponse>
  <DescribeDBLogFilesResult>
  <DescribeDBLogFiles>
    <DescribeDBLogFilesDetails>
      <LastWritten>1385805620000</LastWritten>
      <LogFileName>mysql-error-running.log</LogFileName>
      <Size>0</Size>
    </DescribeDBLogFilesDetails>
    <DescribeDBLogFilesDetails>
      <LastWritten>1385805609000</LastWritten>
      <LogFileName>mysql-error-running.log.9</LogFileName>
      <Size>5731</Size>
    </DescribeDBLogFilesDetails>
    <DescribeDBLogFilesDetails>
      <LastWritten>1385805916000</LastWritten>
      <LogFileName>mysql-error.log</LogFileName>
      <Size>0</Size>
    </DescribeDBLogFilesDetails>
  </DescribeDBLogFiles>
</DescribeDBLogFilesResult>
  <ResponseMetadata>
  <RequestId>777a4cb7-e8cd-4e2b-aeec-5c7a5985f504</RequestId>
</ResponseMetadata>
</DescribeDBLogFilesResponse>

推奨画面サイズ 1024×768 以上