How to Use the AWS CLI
Let's dive into an introduction of how to quickly get you up and running with the AWS CLI to help make you more effective with your AWS interactions.
Join the DZone community and get the full member experience.Join For Free
The AWS Command Line Interface (CLI) is for managing your AWS services from a terminal session on your own client, allowing you to control and configure multiple AWS services.
So you’ve been using AWS for awhile and finally feel comfortable clicking your way through all the services. However, you may have noticed that there is more to AWS than the default eye-catching browser console.
Maybe it’s time you checked out the AWS CLI (Command Line Interface). The AWS CLI is a unified tool to manage your AWS services from a terminal session on your own client. With just one tool to download and configure, you can control multiple AWS services from the command line and automate them through scripts. In this blog, I will show you how to use AWS CLI and how to install it on your Windows, Linux, Mac, or Unix Operating System.
The more you use the AWS CLI, the more you’ll see how powerful it is. The Cloud Academy AWS Command Line Interface course can guide you through some of the interface’s many uses.
Here’s how you can download AWS CLI:
- Install the AWS CLI on Windows
- Download the appropriate MSI installer:
- Run the downloaded MSI installer
- Follow the instructions that appear
Note: The 64-bit version of the AWS CLI does not currently work with Windows Server 2008 (version 6.0.6002). Please use the 32-bit installer with this version of Windows.
Confirm the installation:
To confirm the installation, use the
aws –version command at a command prompt (open the START menu and search for “cmd” if you’re not sure how to find the command prompt).
The CLI installs to C:\Program Files\Amazon\AWSCLI
C:\Program Files\Amazon\AWSCLI>aws --version aws-cli/1.7.24 Python/2.7.9 Windows/8
The CLI installs to C:\Program Files (x86)\Amazon\AWSCLI
C:\Program Files (x86)\Amazon\AWSCLI>aws --version aws-cli/1.7.24 Python/2.7.9 Windows/7
Once you have installed AWS CLI on your PC, you’ll need one more step to be able to connect to your AWS account.
For Windows, in my opinion, the…
…command is the fastest way to set up your AWS CLI installation.
aws configure , the AWS CLI will prompt you for four pieces of information. The first two are required. These are your AWS Access Key ID and AWS Secret Access Key, which serve as your account credentials. (You can generate new credentials within AWS Identity and Access Management (IAM) if you do not already have them.) The other information you will need is region and output format, which you can leave as default for the time being.
aws configure AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY Default region name [None]: us-west-2 Default output format [None]: json
That should be it. One command you can execute from your command prompt is to list any S3 buckets you have. Try the following (provided you have permission to list S3 buckets):
aws s3 ls
Install the AWS CLI on Linux, Mac or Unix Operating System
- Linux, OS X, or Unix
- Python 2.6.3 or later
A full overview on prerequisites is outlined on the AWS CLi page.
Check your Python installation:
$ python --version
If Python is not installed on your computer or you would like to install a different version of Python, follow the procedures outlined in the Python user guide documentation.
This post offers a quick guide to installing the Python version of AWS CLI on Windows.
Follow these steps from the command line to install the AWS CLI:
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip" $ unzip awscli-bundle.zip $ sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
Add your Access Key ID and Secret Access Key to ~/
.aws/config using this format:
[default] aws_access_key_id = <access key id> aws_secret_access_key = <secret access key> region = us-east-1
Protect the config file:
chmod 600 ~/.aws/config
Optionally, you can set an environment variable pointing to the config file. This is especially important if you want to keep it in a non-standard location. For future convenience, also add this line to your ~/.bashrc file:
That should be it. Try out the following from your command prompt and if you have any S3 buckets you should see them listed (again, provided you have permission to list S3 buckets):
aws s3 ls
Here is the basic AWS CLI command structure. Keep in mind that any commands you enter in the CLI will have this standard format:
aws <command> <subcommand> [options and parameters*]
*Parameters can take various types of input values including numbers, strings, lists, maps, and JSON structures.
With the AWS CLI now installed on your client, you can take the next steps to scripting AWS services.
- Learn how to use AWS CLI to configure users and groups, manage EC2 instances, and more in our course How to Use the AWS Command-Line Interface
- Start using these 10 AWS CLI useful commands today
- Use AWS CLI to configure static website hosting on Amazon S3 in the Introduction to the AWS CLI Hands-on Lab
- For more commands, check out the official AWS CLI documentation
Published at DZone with permission of Stuart Scott, DZone MVB. See the original article here.
Opinions expressed by DZone contributors are their own.