ニフクラAPI (RDB: DescribeDBLogFiles)

DescribeDBLogFiles

処理概要

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

指定するパラメーター

パラメーター	型	説明	必須
DBInstanceIdentifier	string	ログファイル一覧を取得するDBサーバーの名前	○
FileLastWritten	long	ログファイルの最終書き込み日時 ※このパラメーターに指定した日時以降に書き込みが行われたログファイルの情報が返却されます 形式：POSIX タイムスタンプ
FileSize	long	ログファイルのサイズ(バイト) ※このパラメーターに指定したよりもサイズの大きいログファイルの情報が返却されます
FilenameContains	string	ログファイル名に含まれる文字列 ※このパラメーターに指定した文字列をファイル名に含むログファイルの情報が返却されます
Marker	string	マーカー ※ページネート用にログファイル一覧の取得位置を表す文字列です ※前回のDescribeDBLogFilesリクエストで返却された値を指定します ※この値が指定された場合、取得位置より後のイベントが返却されます
MaxRecords	integer	レスポンスに含まれるレコードの最大値

応答フィールド

フィールド (項目)	型	説明
DescribeDBLogFilesResponse	structure	ルート
␣DescribeDBLogFilesResult	structure	結果
␣␣DescribeDBLogFiles	list	ログファイル詳細リスト
␣␣␣DescribeDBLogFilesDetails	structure	ログファイル詳細
␣␣␣␣LastWritten	long	最後にログが書き込まれた日時 形式：POSIX タイムスタンプ
␣␣␣␣LogFileName	string	ログファイル名
␣␣␣␣Size	long	ログファイルのサイズ(バイト)
␣␣Marker	string	前のリクエストで提供されるページを表す文字列（ページング用） この値が指定された場合、レスポンスでマーカーを超えたレコードが最大MaxRecord個返される
␣ResponseMetadata	structure	共通メタ情報
␣␣RequestId	string	リクエスト識別子

エラー

コード	メッセージ	タイプ	HTTPステータスコード	説明
Client.InvalidParameterFormat.DBInstanceIdentifier	The parameter DBInstanceIdentifier is not a valid identifier. Identifiers must begin with a letter; must contain only lowercase ASCII letters, digits, and hyphens; and must not end with a hyphen or contain two consecutive hyphens.	Sender	400	DBInstanceIdentifierに無効な値(ハイフンから始まる 等)を指定した場合
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を指定しなかった場合
Client.InvalidParameterTooLong.DBInstanceIdentifier	The parameter DBInstanceIdentifier is not a valid identifier because it is longer than 63 characters.	Sender	400	DBInstanceIdentifierに63文字を超える値を指定した場合

リクエストサンプル

    https://jp-east-1.rdb.api.nifcloud.com/
  ?Action=DescribeDBLogFiles
  &DBInstanceIdentifier=mydbinstance
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Timestamp=2013-12-09T00:00:00.000Z
  &AWSAccessKeyId=<NIFCLOUD Access Key ID>
  &Signature=<Signature>

  

応答サンプル

    <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>