Menu
Amazon Relational Database Service
Command Line Interface Reference (API Version 2014-10-31)

rds-describe-db-log-files

The Amazon RDS Command Line Interface (RDS CLI) has been deprecated. Instead, use the AWS CLI for RDS. To learn how to download and use the AWS CLI, see AWS Command Line Interface User Guide. For RDS commands available in the AWS CLI, see AWS CLI Reference for Amazon RDS.

The AWS CLI does not currently support the DownloadCompleteDBLogFile REST API action. To download an entire log file at once, rather than in parts using the download-db-log-file-portion command, use the last published RDS CLI and the rds-download-db-logfile command.

Description

Displays a list of log files available for an DB instance; the list can be filtered by the optional parameters. The DescribeDBLogFiles API action ignores the MaxRecords parameter when listing Oracle log files and returns up to 1000 records.

Syntax

rds-describe-db-log-files db-instance-identifier

[--filename-contains value ]

[--file-last-written value ]

[--file-size value ]

[General Options]

Options

Name Description Required

--db-instance-identifier value

DB instance identifier. This is the unique key that identifies an DB instance. Stored as a lowercase string.

This parameter is the default parameter and can be passed as the first value in the command and without a parameter name, for example: rds-describe-db-log-files my-db-instance-identifier.

Type: String

Yes

--filename-contains

 Returns the available log files for log file names that contain the specified string.

Type: String

No

--file-last-written

Returns the available log files for files written since the specified date. The date must be specified as a number (Long) format using POSIX (Epoch) timestamp format, including milliseconds. Example: 1414974889000.

Type: Long

No

--file-size

Returns the available log files for files larger than the specified size (in bytes).

Type: Integer

No

Output

The command returns the following information:

Note

Output values list the possible values returned by CLI commands. Not all values are returned for every call to a command. If a value is null or empty, it will not be included in the command output. For example, CLI commands to create or restore a DB instance will not return the Endpoint Address value because that value is null until the DB instance has finished being created or restored.

  • FileName—The log file name available.

  • LastWritten—The date and time that the log file was last written.

  • Size—The size of the log file (in bytes).

Examples

Get a List of All Log Files for a DB instance

This example returns a list of all log files for a DB instance named mysql-prod-db1.

Copy
PROMPT> rds-describe-db-log-files mysql-prod-db1