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
},
]
}