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

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

注意:

データベース仮想サーバの状態が、Active、Restart_Required、Switched、Degenerated、Backup、

Modifying、Resize、Error、Failedのいずれかある場合のみ参照できます。

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

Request URI

{tenantID}

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

Data Type Cardinality
String 1..1

{instanceId}

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

Data Type Cardinality
String 1..1

Request Parameter

filelastwritten

ログファイルの最終書き込み日時

※このパラメーターに指定した日時以降に書き込みが行われたログファイルの情報が返却されます

POSIX time stamp

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

filesize

ログファイルのサイズ(バイト)

※このパラメーターに指定したよりもサイズの大きいログファイルの情報が返却されます

Default: 0

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

filenamecontains

ログファイル名に含まれる文字列

※このパラメーターに指定した文字列をファイル名に含むログファイルの情報が返却されます

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

limit

表示する要素数

20以上100以下

Default: 20

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

本APIにて取得するログファイル名は100件以上表示できません。

72時間の間に出力されるログファイル数が100件以下になるようにログローテーションを設定してください。

Response Headers

ステータス

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

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

Response Elements

describeDBLogFiles

DB log ファイルのリスト

Data Type Cardinality Parent Element Child Element(s)
DescribeDBLogFilesDetails list      

lastWritten

最後のログエントリが書き込まれた時間(POSIXタイムスタンプ)

Data Type Cardinality Parent Element Child Element(s)
Long      

logFileName

指定されたデータベース仮想サーバのログファイル名

Data Type Cardinality Parent Element Child Element(s)
String      

size

指定されたデータベース仮想サーバのログファイルのサイズ(バイト単位)

Data Type Cardinality Parent Element Child Element(s)
Long      

Example of Response


{
    "describeDBLogFilesResult": [
       "descriveDBLogFileDetails" :[
 	{ 
	    "lastWritten" : "1414330786",
	    "logFileName" : "logfile1",
	    "size" : 10000000
          },
{ 
	    "lastWritten" : "1449109892",
	    "logFileName" : "logfile2",
	    "size" : 330000000
          },

       ]
}