本文へジャンプします。

ニフティクラウド 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
ステータスコード
説明
Client.InvalidParameterIllegalInput.DBInstanceIdentifier Invalid database identifier: --sample-dbinstance Sender 400
  • DBInstanceIdentifierに無効な値
    (ハイフンから始まる 等)を指定した場合
  • DBInstanceIdentifierに63文字を超える値を指定した場合
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を指定しなかった場合

サンプル

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