本文へジャンプします。

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

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

RDB:DownloadDBLogFilePortion

処理概要

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

リクエストパラメーター

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

マーカー

  • ※ページネート用にログ行の取得位置を表す文字列です
  • ※前回のDownloadDBLogFilePortionリクエストで返却された値を指定します
  • ※この値が指定された場合、取得位置より後のログ行が返却されます
  文字列  
NumberOfLines

取得される行数

  • ※0または指定されない場合、すべての行を取得します
  • ※1以上の値を指定した場合、最新から指定した行数までを取得します
  数値  

レスポンス

XML

status

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

result
要素名 説明 備考
DownloadDBLogFilePortionResponse ルート  
DownloadDBLogFilePortionResult 結果  
AdditionalDataPending さらにダウンロードされるデータがあるかどうか 真偽値  
LogFileData ログファイルの内容 文字列  
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 NumberOfLinesに数値以外を設定した場合
  Sender 400 NumberOfLinesにintの範囲外(2147483647〜-2147483648)の値を指定した場合

サンプル

リクエストサンプル
https://rdb.jp-east-1.api.cloud.nifty.com/
  ?Action=DownloadDBLogFilePortion
  &DBInstanceIdentifier=mydbinstance
  &LogFileName=mysql-general.log
  &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"?>
<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>

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