本文へジャンプします。

ニフクラ ユーザーガイド

クラウド トップ>API> RDB> DescribeDBLogFiles
本ページは2023/9/5をもって、新ページhttps://docs.nifcloud.com/rdb/api/DescribeDBLogFiles.htmへ移行しました。 今後は新ページをご参照ください。

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>

  
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2023年9月05日時点の情報です。

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