ニフクラAPI (RDB: DownloadDBLogFilePortion)

DownloadDBLogFilePortion

処理概要

特定のログファイルの最新行を取得します。

指定するパラメーター

パラメーター	型	説明	必須
DBInstanceIdentifier	string	取得するログファイルを含むDBサーバーの名前	○
LogFileName	string	取得するログファイル名
Marker	string	マーカー ※ページネート用にログ行の取得位置を表す文字列です ※前回のDownloadDBLogFilePortionリクエストで返却された値を指定します ※この値が指定された場合、取得位置より後のログ行が返却されます
NumberOfLines	integer	取得される行数 ※0または指定されない場合、すべての行を取得します ※1以上の値を指定した場合、最新から指定した行数までを取得します

応答フィールド

フィールド (項目)	型	説明
DownloadDBLogFilePortionResponse	structure	ルート
␣DownloadDBLogFilePortionResult	structure	結果
␣␣Marker	string	前のリクエストで提供されるページを表す文字列（ページング用） この値が指定された場合、レスポンスでマーカーを超えたレコードが最大MaxRecord個返される
␣␣AdditionalDataPending	boolean	さらにダウンロードされるデータがあるかどうか
␣␣LogFileData	string	ログファイルの内容
␣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.NumberOfLines		Sender	400	NumberOfLinesに数値でない値を指定した場合 NumberOfLinesに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=DownloadDBLogFilePortion
  &DBInstanceIdentifier=mydbinstance
  &LogFileName=mysql-general.log
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Timestamp=2013-12-09T00:00:00.000Z
  &AWSAccessKeyId=<NIFCLOUD Access Key ID>
  &Signature=<Signature>

  

応答サンプル

    <DownloadDBLogFilePortionResponse>
  <DownloadDBLogFilePortionResult>
    <AdditionalDataPending>false</AdditionalDataPending>
    <LogFileData>/rdbdbbin/mysql/bin/mysqld, Version: 5.6.12-log (MySQL Community Server (GPL)). started with:
Tcp port: 3306 Unix socket: /tmp/mysql.sock
Time         Id Command  Argument</LogFileData>
  </DownloadDBLogFilePortionResult>
  <ResponseMetadata>
    <RequestId>bad8c743-86c4-49fa-a890-8ef401652e59</RequestId>
  </ResponseMetadata>
</DownloadDBLogFilePortionResponse>