Specifying parameter values in the Amazon CLI - Amazon Command Line Interface
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

This documentation is for Version 1 of the Amazon CLI only. For documentation related to Version 2 of the Amazon CLI, see the Version 2 User Guide.

Specifying parameter values in the Amazon CLI

Many parameters used in the Amazon Command Line Interface (Amazon CLI) are simple string or numeric values, such as the key-pair name my-key-pair in the following aws ec2 create-key-pair command example.

$ aws ec2 create-key-pair --key-name my-key-pair

Formatting for command can vary between terminals. For example, most terminals are case sensitive but Powershell is case insensitive. This means the two following command examples would yield different results for case sensitive terminals as they view MyFile*.txt and myfile*.txt as different parameters.

However, PowerShell would process these requests as the same as it sees MyFile*.txt and myfile*.txt as the same parameters. The following command example demonstrates these paramaters using the aws s3 cp command:

$ aws s3 cp . s3://amzn-s3-demo-bucket/path --include "MyFile*.txt" $ aws s3 cp . s3://amzn-s3-demo-bucket/path --include "myfile*.txt"

For more information on PowerShell's case insensitivy, see about_Case-Sensitivity in the PowerShell documentation.

Sometimes you need to use quotation marks or literals around strings that include special or space characters. The rules around this formatting can also vary between terminals. For more information about using quotation marks around complex parameters, see Using quotation marks and literals with strings in the Amazon CLI.

These topics cover the most common terminal formatting rules. If you are having issues with your terminal recognizing your parameter values, be sure to review the topics in this section and also to check your terminal's documentation for their specific syntax rules.