À l'aide d'un HTTP proxy pour AWS CLI - AWS Command Line Interface

Cette documentation concerne AWS CLI uniquement la version 1. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

À l'aide d'un HTTP proxy pour AWS CLI

Pour accéder AWS via des serveurs proxy, vous pouvez configurer les variables d'HTTPS_PROXYenvironnement HTTP_PROXY et avec les noms de DNS domaine ou les adresses IP et les numéros de port utilisés par vos serveurs proxy.

Utilisation des exemples

Note

Les exemples suivants montrent le nom de la variable d'environnement en majuscules. Toutefois, si vous spécifiez une variable deux fois en utilisant des majuscules différentes, les lettres minuscules ont priorité. Nous vous recommandons de ne définir chaque variable qu'une seule fois afin d'éviter toute confusion dans le système et tout comportement inattendu.

Les exemples suivants montrent comment vous pouvez utiliser l'adresse IP explicite de votre proxy ou un DNS nom correspondant à l'adresse IP de votre proxy. Chacun peut être suivi d'un signe deux-points et du numéro de port auquel les requêtes doivent être envoyées.

Linux or macOS
$ export HTTP_PROXY=http://10.15.20.25:1234 $ export HTTP_PROXY=http://proxy.example.com:1234 $ export HTTPS_PROXY=http://10.15.20.25:5678 $ export HTTPS_PROXY=http://proxy.example.com:5678
Windows Command Prompt

À configurer pour toutes les sessions

C:\> setx HTTP_PROXY http://10.15.20.25:1234 C:\> setx HTTP_PROXY http://proxy.example.com:1234 C:\> setx HTTPS_PROXY http://10.15.20.25:5678 C:\> setx HTTPS_PROXY http://proxy.example.com:5678

L'utilisation de setx pour définir une variable d'environnement modifie la valeur utilisée dans la session d'invite de commande en cours et toutes les sessions d'invite de commande que vous créez après l'exécution de la commande. Cela n'affecte pas les autres shells de commande qui sont déjà en cours d'exécution lorsque vous exécutez la commande.

À configurer pour la session en cours uniquement

L'utilisation de set pour définir une variable d'environnement modifie la valeur utilisée jusqu'à la fin de la session d'invite de commande en cours, ou jusqu'à ce que vous définissiez la variable sur une autre valeur.

C:\> set HTTP_PROXY=http://10.15.20.25:1234 C:\> set HTTP_PROXY=http://proxy.example.com:1234 C:\> set HTTPS_PROXY=http://10.15.20.25:5678 C:\> set HTTPS_PROXY=http://proxy.example.com:5678

Authentification auprès d'un proxy

AWS CLI Supporte l'authentification HTTP de base. Spécifiez le nom d'utilisateur et le mot de passe dans le proxyURL, comme suit.

Linux or macOS
$ export HTTP_PROXY=http://username:password@proxy.example.com:1234 $ export HTTPS_PROXY=http://username:password@proxy.example.com:5678
Windows Command Prompt

À configurer pour toutes les sessions

C:\> setx HTTP_PROXY http://username:password@proxy.example.com:1234 C:\> setx HTTPS_PROXY http://username:password@proxy.example.com:5678

À configurer pour la session en cours uniquement

C:\> set HTTP_PROXY=http://username:password@proxy.example.com:1234 C:\> set HTTPS_PROXY=http://username:password@proxy.example.com:5678

Utilisation d'un proxy sur les EC2 instances Amazon

Si vous configurez un proxy sur une EC2 instance Amazon lancée avec un IAM rôle attaché, assurez-vous d'exempter l'adresse utilisée pour accéder aux métadonnées de l'instance. Pour ce faire, définissez la variable d'NO_PROXYenvironnement sur l'adresse IP du service de métadonnées d'instance, 169.254.169.254. Cette adresse ne varie pas.

Linux or macOS
$ export NO_PROXY=169.254.169.254
Windows Command Prompt

À configurer pour toutes les sessions

C:\> setx NO_PROXY 169.254.169.254

À configurer pour la session en cours uniquement

C:\> set NO_PROXY=169.254.169.254

Résolution des problèmes

Si vous rencontrez des problèmes avec le AWS CLI, consultez les étapes Résolution des erreurs liées au AWS CLI de résolution des problèmes. Pour connaître les étapes de résolution des problèmes les plus pertinentes, consultezSSLerreurs de certificat.