aws cli

Другой исходный код

1.0.0

Скачать

aws-cli

Этот пакет предоставляет унифицированный интерфейс командной строки для Amazon Web Services.

Перейти к:

Начиная
Получение помощи
Дополнительные ресурсы

Начиная

Этот README предназначен для AWS CLI версии 1. Если вы ищете информацию о AWS CLI версии 2, посетите ветку v2.

Требования

Пакет aws-cli работает с версиями Python:

3.8.x и выше
3.9.x и выше
3.10.x и выше
3.11.x и выше
3.12.x и выше

Уведомления

30 мая 2022 г. поддержка Python 3.6 была прекращена. Это следует за прекращением поддержки среды выполнения Python Software Foundation, которое произошло 23 декабря 2021 г.

13 декабря 2023 г. поддержка Python 3.7 была прекращена. Это следует за прекращением поддержки среды выполнения Python Software Foundation, которое произошло 27 июня 2023 г. Для получения дополнительной информации см. эту публикацию в блоге.

Внимание!

Мы рекомендуем всем клиентам регулярно проверять веб-сайт «Бюллетени по безопасности Amazon Web Services» на наличие важных бюллетеней по безопасности, связанных с aws-cli.

Обслуживание и поддержка основных версий CLI

Версия AWS CLI 1 стала общедоступной 02.09.2013 и в настоящее время находится на этапе полной поддержки жизненного цикла доступности.

Информацию об обслуживании и поддержке основных версий SDK и их базовых зависимостей см. в разделе «Политика обслуживания» в Справочном руководстве по общей конфигурации и учетным данным AWS SDK и инструментов .

Установка

При установке AWS CLI и его зависимостей используется ряд функций упаковки, предоставляемых pip и setuptools . Для обеспечения беспрепятственной установки рекомендуется использовать:

pip : 9.0.2 или выше
setuptools : 36.2.0 или выше

Самый безопасный способ установить AWS CLI — использовать pip в virtualenv :

 $ python -m pip установить awscli

или, если вы не устанавливаете в virtualenv , установите глобально:

 $ sudo python -m pip установить awscli

или для вашего пользователя:

 $ python -m pip install --user awscli

Если у вас установлен пакет aws-cli и вы хотите выполнить обновление до последней версии, вы можете запустить:

 $ python -m pip install --upgrade awscli

Это установит пакет aws-cli, а также все зависимости.

Примечание

Если в macOS вы видите ошибку, связанную с six версией, поставляемой с distutils в El Capitan, используйте опцию --ignore-installed :

 $ sudo python -m pip install awscli --ignore-installed Six

В Linux и Mac OS интерфейс командной строки AWS можно установить с помощью прилагаемого установщика. AWS CLI также можно установить в Windows с помощью установщика MSI.

Если вы хотите запустить ветку develop AWS CLI, см. раздел «Версия для разработки» руководства по участию.

Дополнительную информацию см. в разделе установки Руководства пользователя AWS CLI.

Конфигурация

Прежде чем использовать интерфейс командной строки AWS, вам необходимо настроить свои учетные данные AWS. Вы можете сделать это несколькими способами:

Команда конфигурации
Переменные среды
Общий файл учетных данных
Конфигурационный файл
Роль IAM

Самый быстрый способ начать — запустить команду aws configure :

 $ aws настроить
Идентификатор ключа доступа AWS: MYACCESSKEY
Секретный ключ доступа AWS: MYSECRETKEY
Имя региона по умолчанию [us-west-2]: us-west-2
Формат вывода по умолчанию [Нет]: json

Чтобы использовать переменные среды, выполните следующие действия:

 $ экспорт AWS_ACCESS_KEY_ID=<ключ_доступа>
$ экспорт AWS_SECRET_ACCESS_KEY=<секретный_ключ>

Чтобы использовать общий файл учетных данных, создайте файл в формате INI следующим образом:

 [по умолчанию]
aws_access_key_id=MYACCESSKEY
aws_secret_access_key=МОЙСЕКРЕТНЫЙ КЛЮЧ

[тестирование]
aws_access_key_id=MYACCESSKEY
aws_secret_access_key=МОЙСЕКРЕТНЫЙ КЛЮЧ

и поместите его в ~/.aws/credentials (или в %UserProfile%.aws/credentials в Windows). Если вы хотите разместить общий файл учетных данных в другом месте, отличном от указанного выше, вам необходимо указать aws-cli, где его найти. Сделайте это, установив соответствующую переменную среды:

 $ экспорт AWS_SHARED_CREDENTIALS_FILE=/путь/к/shared_credentials_file

Чтобы использовать файл конфигурации, создайте файл в формате INI следующим образом:

 [по умолчанию]
aws_access_key_id=<ключ доступа по умолчанию>
aws_secret_access_key=<секретный ключ по умолчанию>
# Необязательно, чтобы определить регион по умолчанию для этого профиля.
регион = США-Запад-1

[тестирование профиля]
aws_access_key_id=<ключ доступа к тестированию>
aws_secret_access_key=<секретный ключ тестирования>
регион = США-Запад-2

и поместите его в ~/.aws/config (или в %UserProfile%.awsconfig в Windows). Если вы хотите разместить файл конфигурации в другом месте, отличном от указанного выше, вам необходимо сообщить интерфейсу командной строки AWS, где его найти. Сделайте это, установив соответствующую переменную среды:

 $ экспорт AWS_CONFIG_FILE=/путь/к/конфигурационному_файлу

Как видите, вы можете определить несколько profiles как в общем файле учетных данных, так и в файле конфигурации. Затем вы можете указать, какой профиль использовать, используя опцию --profile . Если профиль не указан, используется профиль default .

В файле конфигурации, за исключением профиля по умолчанию, вы должны префикс каждого раздела конфигурации группы профилей с помощью profile . Например, если у вас есть профиль с именем «тестирование», заголовок раздела будет выглядеть так: [profile testing] .

Последний вариант учетных данных настоятельно рекомендуется, если вы используете интерфейс командной строки AWS на экземпляре EC2. Роли IAM — отличный способ автоматически устанавливать учетные данные на вашем экземпляре. Если вы используете роли IAM, интерфейс командной строки AWS найдет и использует их автоматически.

Помимо учетных данных, можно настроить ряд других переменных либо с помощью переменных среды, записей файла конфигурации, либо с помощью того и другого. Дополнительную информацию см. в Справочном руководстве по общей конфигурации и учетным данным инструментов и SDK AWS.

Дополнительную информацию о параметрах конфигурации см. в разделе «Переменные конфигурации AWS CLI». Вы также можете получить доступ к этой теме из интерфейса командной строки AWS, запустив aws help config-vars .

Основные команды

Команда AWS CLI имеет следующую структуру:

 $ aws <команда> <подкоманда> [опции и параметры]

Например, чтобы просмотреть сегменты S3, команда будет такой:

 $ aws s3 лс

Чтобы просмотреть справочную документацию, воспользуйтесь одним из следующих способов:

 $ оу помогите
$ aws <команда> помощь
$ aws <команда> <подкоманда> help

Чтобы получить версию AWS CLI:

 $ aws --версия

Чтобы включить вывод отладки:

 $ aws --debug <команда> <подкоманда>

Дополнительную информацию можно прочитать в главе «Использование AWS CLI» Руководства пользователя AWS CLI.

Завершение команды

Пакет aws-cli включает функцию завершения команд для Unix-подобных систем. Эта функция не устанавливается автоматически, поэтому ее необходимо настроить вручную. Дополнительную информацию см. в разделе о завершении команд AWS CLI.

Получение помощи

Лучший способ взаимодействия с нашей командой — через GitHub. Вы можете открыть проблему и выбрать один из наших шаблонов для руководства, отчетов об ошибках или запросов на добавление функций.

Вы можете найти помощь в сообществе Stack Overflow с тегом aws-cli или на дискуссионном форуме AWS по CLI. Если у вас есть план поддержки AWS Support, вы также можете создать новый запрос на поддержку.

Пожалуйста, проверьте наличие открытых подобных проблем, прежде чем открывать еще одну.

Интерфейс командной строки AWS реализует API-интерфейсы сервисов AWS. По общим вопросам, касающимся сервисов или их ограничений, вам могут оказаться полезны дискуссионные форумы Amazon Web Services.