List DB log files (GET /v1.0/{tenantId}/logfiles/{instanceId})

Lists information for all DB log files for a virtual database server.

CAUTION:

This can only be referenced if the virtual database server status is one of Active, Restart_Required, Switched, Degenerated, Backup,

Modifying, Resize, Error, and Failed.

However, in a Modifying or Resize status, there is a temporary point where this returns 503 or 504. In that event, please retry after a while.

Request URI

{tenantID}

Project ID of the owner of the instance

Data Type Cardinality
String 1..1

{instanceId}

ID of the virtual database server

Data Type Cardinality
String 1..1

Request Parameters

filelastwritten

Date and time when the log file was last written

Note: Information on log files written to on or after the date and time specified in this parameter will be returned.

POSIX time stamp

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

filesize

Log file size (bytes)

Note: Information on log files larger than the size specified in this parameter will be returned.

Default: 0

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

filenamecontains

String contained in the log file name

Note: Information on log files with file names that contain the string specified in this parameter will be returned.

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

marker

Marker

Pagination token used to establish the starting point for retrieving the list.

The value is returned by the previous DescribeDBInstances request.

If this value is specified, only records beyond the marker are returned by the DB server.

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

limit

Number of elements to display

20 to 100

Default: 20

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

Response Headers

Status

Returns the status of the request.

One of the following values will be returned.
401:
unauthorized
403:
forbidden
404:
itemNotFound
500:
instanceFault
501:
notImplemented
503:
serviceUnavailable
504:
gatewayTimeout
Data Type Cardinality
Int 1..1

Response Elements

describeDBLogFiles

List of DB log files

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

lastWritten

Time at which the last log entry was written (POSIX time stamp)

Data Type Cardinality Parent Element Child Element(s)
Long      

logFileName

Name of the specified virtual database server log file

Data Type Cardinality Parent Element Child Element(s)
String      

size

Size of the specified virtual database server log file (bytes)

Data Type Cardinality Parent Element Child Element(s)
Long      

Example of response


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

       ]
}