awsdocs/amazon-rds-user-guide

Unknown options: --headers

anupsom opened this issue · 2 comments

On OSX
aws rds describe-db-instances --db-instance-identifier AcmeRDS --headers

returns
Unknown options: --headers

I ran a quick check to see if --headers was valid in some specific context, such as in combination with '--output text'. It doesn't appear to be valid in any circumstances. The example as it is would return output in JSON format, so the header info would be shown in the form of JSON keys. If '--output text' was added to the example, then the header info would be shown in a tabular format, but AFAIK there's no way to suppress the header line, there's no special option to display it or not.

Suggestion: take out --headers from the example and the reference to it in the description. Replace with --output text which will show the output in a format where the column headings make sense.