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
表示する行数
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 |
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"
}
}