本文へジャンプします。

ニフティクラウド 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
ステータスコード
説明
Client.InvalidParameterIllegalInput.DBInstanceIdentifier Invalid database identifier: --sample-dbinstance Sender 400
  • DBInstanceIdentifierに無効な値
    (ハイフンから始まる 等)を指定した場合
  • DBInstanceIdentifierに63文字を超える値を指定した場合
Client.InvalidParameterIllegalInput.FileLastWritten - Sender 400
  • FileLastWrittenに数値でない値を指定した場合
  • FileLastWrittenにLong型の範囲を超える数値を設定した場合
Client.InvalidParameterIllegalInput.FileSize - Sender 400
  • FileSizeに数値でない値を指定した場合
  • FileSizeにLong型の範囲を超える数値を設定した場合
Client.InvalidParameterIllegalInput.MaxRecords - Sender 400
  • MaxRecordsに数値でない値を指定した場合
  • MaxRecordsにInteger型の範囲外
    (2147483647〜-2147483648)の値を指定した場合
Client.InvalidParameterNotFound.DBInstance DBInstance aaa not found. Sender 404 存在しないDBInstanceIdentifierを指定した場合
Client.InvalidParameterRequired.DBInstanceIdentifier The parameter DBInstanceIdentifier must be provided and must not be blank. Sender 400 必須のDBInstanceIdentifierを指定しなかった場合

サンプル

リクエストサンプル
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 以上