aws cli
1.0.0
Ce package fournit une interface de ligne de commande unifiée à Amazon Web Services.
Aller à :
Ce README concerne l'AWS CLI version 1. Si vous recherchez des informations sur l'AWS CLI version 2, veuillez visiter la branche v2.
Le package aws-cli fonctionne sur les versions Python :
Le 30/05/2022, la prise en charge de Python 3.6 a pris fin. Cela fait suite à la fin du support du runtime par Python Software Foundation qui a eu lieu le 23/12/2021.
Le 13/12/2023, la prise en charge de Python 3.7 a pris fin. Cela fait suite à la fin du support du runtime par Python Software Foundation qui a eu lieu le 2023-06-27. Pour plus d’informations, consultez cet article de blog.
Attention!
Nous recommandons à tous les clients de surveiller régulièrement le site Web des bulletins de sécurité d'Amazon Web Services pour détecter tout bulletin de sécurité important lié à aws-cli.
La version 1 de l'AWS CLI a été mise à la disposition générale le 02/09/2013 et se trouve actuellement dans la phase de support complet du cycle de vie de disponibilité.
Pour plus d'informations sur la maintenance et la prise en charge des versions majeures du SDK et de leurs dépendances sous-jacentes, consultez la section Politique de maintenance dans le Guide de référence de la configuration et des informations d'identification partagées des kits SDK et outils AWS .
L'installation de l'AWS CLI et de ses dépendances utilise une gamme de fonctionnalités d'empaquetage fournies par pip et setuptools . Pour garantir une installation fluide, il est recommandé d'utiliser :
pip : 9.0.2 ou supérieursetuptools : 36.2.0 ou supérieur Le moyen le plus sûr d'installer l'AWS CLI est d'utiliser pip dans un virtualenv :
$ python -m pip installer awscli
ou, si vous n'installez pas dans un virtualenv , pour installer globalement :
$ sudo python -m pip installer awscli
ou pour votre utilisateur :
$ python -m pip install --user awscli
Si le package aws-cli est installé et que vous souhaitez effectuer une mise à niveau vers la dernière version, vous pouvez exécuter :
$ python -m pip install --upgrade awscli
Cela installera le package aws-cli ainsi que toutes les dépendances.
Note
Sur macOS, si vous voyez une erreur concernant la version six fournie avec distutils dans El Capitan, utilisez l'option --ignore-installed :
$ sudo python -m pip install awscli --ignore-installed six
Sous Linux et Mac OS, l'AWS CLI peut être installée à l'aide d'un programme d'installation fourni. L'AWS CLI peut également être installée sur Windows via un programme d'installation MSI.
Si vous souhaitez exécuter la branche develop de l'AWS CLI, consultez la section Version de développement du guide de contribution.
Consultez la section d'installation du Guide de l'utilisateur AWS CLI pour plus d'informations.
Avant d'utiliser l'AWS CLI, vous devez configurer vos informations d'identification AWS. Vous pouvez le faire de plusieurs manières :
Le moyen le plus rapide de commencer est d'exécuter la commande aws configure :
$aws configurer ID de clé d'accès AWS : MYACCESSKEY Clé d'accès secrète AWS : MYSECRETKEY Nom de région par défaut [us-west-2] : us-west-2 Format de sortie par défaut [Aucun] : json
Pour utiliser des variables d'environnement, procédez comme suit :
$ export AWS_ACCESS_KEY_ID=$ export AWS_SECRET_ACCESS_KEY=
Pour utiliser le fichier d'informations d'identification partagé, créez un fichier au format INI comme celui-ci :
[défaut] aws_access_key_id=MYACCESSKEY aws_secret_access_key=MYSECRETKEY [essai] aws_access_key_id=MYACCESSKEY aws_secret_access_key=MYSECRETKEY
et placez-le dans ~/.aws/credentials (ou dans %UserProfile%.aws/credentials sous Windows). Si vous souhaitez placer le fichier d'informations d'identification partagé dans un emplacement différent de celui spécifié ci-dessus, vous devez indiquer à aws-cli où le trouver. Pour ce faire, définissez la variable d'environnement appropriée :
$ export AWS_SHARED_CREDENTIALS_FILE=/path/to/shared_credentials_file
Pour utiliser un fichier de configuration, créez un fichier au format INI comme celui-ci :
[défaut] aws_access_key_id=aws_secret_access_key= # Facultatif, pour définir la région par défaut pour ce profil. région = us-west-1 [test de profil] aws_access_key_id= aws_secret_access_key= région = us-west-2
et placez-le dans ~/.aws/config (ou dans %UserProfile%.awsconfig sous Windows). Si vous souhaitez placer le fichier de configuration dans un emplacement différent de celui spécifié ci-dessus, vous devez indiquer à l'AWS CLI où le trouver. Pour ce faire, définissez la variable d'environnement appropriée :
$ export AWS_CONFIG_FILE=/path/to/config_file
Comme vous pouvez le constater, vous pouvez définir plusieurs profiles à la fois dans le fichier d'informations d'identification partagé et dans le fichier de configuration. Vous pouvez ensuite spécifier le profil à utiliser en utilisant l'option --profile . Si aucun profil n'est spécifié, le profil default est utilisé.
Dans le fichier de configuration, à l'exception du profil par défaut, vous devez préfixer chaque section de configuration d'un groupe de profils avec profile . Par exemple, si vous avez un profil nommé "testing", l'en-tête de section serait [profile testing] .
La dernière option pour les informations d'identification est fortement recommandée si vous utilisez l'AWS CLI sur une instance EC2. Les rôles IAM constituent un excellent moyen d'installer automatiquement les informations d'identification sur votre instance. Si vous utilisez des rôles IAM, l'AWS CLI les trouvera et les utilisera automatiquement.
En plus des informations d'identification, un certain nombre d'autres variables peuvent être configurées soit avec des variables d'environnement, des entrées de fichier de configuration, ou les deux. Consultez le Guide de référence de la configuration partagée et des informations d'identification des outils et SDK AWS pour plus d'informations.
Pour plus d'informations sur les options de configuration, veuillez consulter la rubrique Variables de configuration AWS CLI. Vous pouvez également accéder à cette rubrique à partir de l'AWS CLI en exécutant aws help config-vars .
Une commande AWS CLI a la structure suivante :
$ aws[options et paramètres]
Par exemple, pour lister les compartiments S3, la commande serait :
$aws s3ls
Pour afficher la documentation d'aide, utilisez l'une des méthodes suivantes :
$ aide aws $ awsaide $ aws aide
Pour obtenir la version de l'AWS CLI :
$aws --version
Pour activer la sortie de débogage :
$ aws --debug
Vous pouvez lire plus d'informations dans le chapitre Utilisation de l'AWS CLI du Guide de l'utilisateur de l'AWS CLI.
Le package aws-cli inclut une fonctionnalité d'achèvement de commandes pour les systèmes de type Unix. Cette fonctionnalité n'est pas installée automatiquement, vous devez donc la configurer manuellement. Pour en savoir plus, lisez la rubrique Achèvement des commandes AWS CLI.
La meilleure façon d'interagir avec notre équipe est via GitHub. Vous pouvez ouvrir un ticket et choisir parmi l'un de nos modèles pour obtenir des conseils, des rapports de bogues ou des demandes de fonctionnalités.
Vous pouvez trouver de l'aide auprès de la communauté sur Stack Overflow avec la balise aws-cli ou sur le forum de discussion AWS pour CLI. Si vous disposez d'un plan de support avec AWS Support, vous pouvez également créer un nouveau dossier de support.
Veuillez vérifier les problèmes similaires ouverts avant d’en ouvrir un autre.
L'AWS CLI implémente les API du service AWS. Pour les questions générales concernant les services ou leurs limitations, les forums de discussion Amazon Web Services peuvent vous être utiles.
