本文へジャンプします。

ニフクラ ユーザーガイド

クラウド トップ>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>

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

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