DBログファイルの参照(GET /v1.0/{tenantId}/logfiles/{instanceId}/{logFileName})

DBログファイルを参照する。

注意:
データベース仮想サーバの状態が、Active、Restart_Required、Switched、Degenerated、Backup、 Modifying、Resize、Error、Failedのいずれかある場合のみ参照できます。

ただし、Modifying、Resizeの場合、一時的に404、503、504で返却されるタイミングがあるため、時間をおいてリトライしてください。

Request URI

{tenantID}

インスタンスのオーナーとなるプロジェクトID

Data Type Cardinality
String 1..1

{instanceId}

データベース仮想サーバのID

Data Type Cardinality
String 1..1

{logFileName}

DBログファイルの名前

Data Type Cardinality
String 1..1

Request Parameter

limit

表示する行数

limitExtensionパラメーターが未指定、またはfalseの場合、20以上100以下を指定できる。

limitExtensionパラメーターがtrueの場合、20以上10000以下を指定できる。

Default:20

Data Type Cardinality Parent Element Child Element(s)
Integer 0..1 None None

marker

ページネーションのためにどの位置からリストを取得するか指定する文字列

前回のDescribeDBInstancesリクエストで返却された値を指定する。

markerが指定された場合markerの次の行から表示し、無指定の場合はログファイルの先頭から表示する。

Data Type Cardinality Parent Element Child Element(s)
String 0..1 None None

descending

Trueの場合、DBログを降順に参照

Default: false

このパラメーターがtrueの場合、DBログを降順に参照する。

instanceカテゴリのdownloadLogExtensionパラメーターがTrueのデータベース仮想サーバに対して実行可能となる。

Data Type Cardinality Parent Element Child Element(s)
Boolean 0..1 None None

limitExtension

Trueの場合、limitパラメーターの上限を拡張

Default: false

このパラメーターがtrueの場合、limitパラメーターの上限を100から10000に拡張する。

また、このパラメーターがtrueのときに、100より大きい行数で参照するDBログのサイズが5MBを超える場合、5MB以下となる行数のDBログを返却する。

Data Type Cardinality Parent Element Child Element(s)
Boolean 0..1 None None

Response Headers

ステータス

リクエストのステータスを返却する。

以下の値を返却する。
400:
badRequest
401:
unauthorized
403:
forbidden
404:
itemNotFound
500:
instanceFault
501:
notImplemented
503:
serviceUnavailable
504:
gatewayTimeout
Data Type Cardinality
Int 1..1

Response Elements

additionalDataPending

trueの場合、ダウンロードできるデータがまだ存在することを示す。

Data Type Cardinality Parent Element Child Element(s)
Boolean      

logFileData

指定されたログファイルのデータが格納されている。

Data Type Cardinality Parent Element Child Element(s)
String      

marker

DownloadDBLogFilePortionリクエストのサブシーケント中で使うことが可能なページネーショントークン

Data Type Cardinality Parent Element Child Element(s)
String      

Example of Response


{
   "downloadDBLogFilePortion":{
     "additionalDataPending":true,
     "logFileData":"xxxxxx"
     "marker":"20"
   }
 }