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"
   }
 }