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. # Utilisation de points de terminaison dans AWS CLI Pour vous connecter par programmation à un Service AWS, vous utilisez un point de terminaison. Un *point de terminaison* est l'URL du point d'entrée d'un service AWS Web. Le AWS Command Line Interface (AWS CLI) utilise automatiquement le point de terminaison par défaut pour chaque service d'un Région AWS, mais vous pouvez spécifier un point de terminaison alternatif pour vos demandes d'API. **Contents** + [Définition d’un point de terminaison pour une commande unique](#endpoints-command) + [Définir un point de terminaison global pour tous Services AWS](#endpoints-global) + [Paramétré pour utiliser les FIPs points de terminaison pour tous Services AWS](#endpoints-fips) + [Conçu pour utiliser des points de terminaison à double pile pour tous Services AWS](#endpoints-dual-stack) + [Définition de points de terminaison spécifiques aux services](#endpoints-service-specific) + [Variables d’environnement](#endpoints-service-specific-envvars) + [Fichier `config` partagé](#endpoints-service-specific-config) + [Liste des identifiants spécifiques aux services](#endpoints-service-specific-table) + [Points de terminaison basés sur un compte](#endpoints-accountid) + [Configuration du point de terminaison et priorité des paramètres](#endpoints-precedence) ## Définition d’un point de terminaison pour une commande unique Pour remplacer les paramètres du point de terminaison ou les variables d’environnement pour une commande unique, utilisez l’option de ligne de commande `--endpoint-url`. L’exemple de commande suivant utilise une URL de point de terminaison Amazon S3 personnalisée. ``` $ aws s3 ls --endpoint-url http://localhost:4567 ``` ## Définir un point de terminaison global pour tous Services AWS Pour acheminer les demandes de tous les services vers une URL de point de terminaison personnalisée, utilisez l’un des paramètres suivants : + Variables d’environnement : + `AWS\$1IGNORE\$1CONFIGURED\$1ENDPOINT\$1URLS`- Ignorez le point de terminaison configuré URLs. ------ #### [ Linux or macOS ] ``` $ export AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true ``` ------ #### [ Windows Command Prompt ] **Définition pour toutes les sessions** ``` C:\> setx AWS_IGNORE_CONFIGURED_ENDPOINT_URLS true ``` **Définition pour la session en cours uniquement** ``` C:\> set AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true ``` ------ #### [ PowerShell ] ``` PS C:\> $Env:AWS_IGNORE_CONFIGURED_ENDPOINT_URLS="true" ``` ------ + `AWS\$1ENDPOINT\$1URL` - Définir l’URL du point de terminaison global. ------ #### [ Linux or macOS ] ``` $ export AWS_ENDPOINT_URL=http://localhost:4567 ``` ------ #### [ Windows Command Prompt ] **Définition pour toutes les sessions** ``` C:\> setx AWS_ENDPOINT_URL http://localhost:4567 ``` **Définition pour la session en cours uniquement** ``` C:\> set AWS_ENDPOINT_URL=http://localhost:4567 ``` ------ #### [ PowerShell ] ``` PS C:\> $Env:AWS_ENDPOINT_URL="http://localhost:4567" ``` ------ + Fichier `config` : + `ignore\$1configure\$1endpoint\$1urls`- Ignorez le point de terminaison configuré URLs. ``` ignore_configure_endpoint_urls = true ``` + `endpoint\$1url` - Définir l’URL du point de terminaison global. ``` endpoint_url = http://localhost:4567 ``` Les points de terminaison spécifiques aux services et l’option de ligne de commande `--endpoint-url` remplacent les points de terminaison globaux. ## Paramétré pour utiliser les FIPs points de terminaison pour tous Services AWS Pour acheminer les demandes visant à ce que tous les services utilisent des FIPs points de terminaison, utilisez l'une des méthodes suivantes : + Variable d’environnement `AWS\$1USE\$1FIPS\$1ENDPOINT`. ------ #### [ Linux or macOS ] ``` $ export AWS_USE_FIPS_ENDPOINT=true ``` ------ #### [ Windows Command Prompt ] **Définition pour toutes les sessions** ``` C:\> setx AWS_USE_FIPS_ENDPOINT true ``` **Définition pour la session en cours uniquement** ``` C:\> set AWS_USE_FIPS_ENDPOINT=true ``` ------ #### [ PowerShell ] ``` PS C:\> $Env:AWS_USE_FIPS_ENDPOINT="true" ``` ------ + Paramètre de fichier `use\$1fips\$1endpoint`. ``` use_fips_endpoint = true ``` Certains AWS services proposent des terminaux compatibles avec la [norme fédérale de traitement de l'information (FIPS) 140-2](https://aws.amazon.com/compliance/fips/) dans certains cas. Régions AWS Lorsque le AWS service prend en charge le protocole FIPS, ce paramètre indique le point de terminaison FIPS à utiliser AWS CLI . Contrairement aux points de terminaison AWS standard, les points de terminaison FIPS utilisent une bibliothèque de logiciels TLS conforme à la norme FIPS 140-2. Ces points de terminaison peuvent être requis par les entreprises qui interagissent avec le gouvernement des États-Unis. Si ce paramètre est activé, mais qu'il n'existe pas de point de terminaison FIPS pour le service dans votre ordinateur Région AWS, la AWS commande risque d'échouer. Dans ce cas, indiquez manuellement le point de terminaison à utiliser dans la commande à l’aide de l’option `--endpoint-url` ou utilisez des [points de terminaison spécifiques aux services](#endpoints-service-specific). Pour plus d'informations sur la spécification des points de terminaison FIPS par Région AWS, consultez la section Points de [terminaison FIPS](https://aws.amazon.com/compliance/fips/) par service. ## Conçu pour utiliser des points de terminaison à double pile pour tous Services AWS Pour acheminer les demandes de tous les services permettant l’utilisation de points de terminaison à double pile, lorsqu’ils sont disponibles, utilisez l’un des paramètres suivants : + Variable d’environnement `AWS\$1USE\$1DUALSTACK\$1ENDPOINT`. ------ #### [ Linux or macOS ] ``` $ export AWS_USE_DUALSTACK_ENDPOINT=true ``` ------ #### [ Windows Command Prompt ] **Définition pour toutes les sessions** ``` C:\> setx AWS_USE_DUALSTACK_ENDPOINT true ``` **Définition pour la session en cours uniquement** ``` C:\> set AWS_USE_DUALSTACK_ENDPOINT=true ``` ------ #### [ PowerShell ] ``` PS C:\> $Env:AWS_USE_DUALSTACK_ENDPOINT="true" ``` ------ + Paramètre de fichier `use\$1dualstack\$1endpoint`. ``` use_dualstack_endpoint = true ``` Permet d'utiliser des points de terminaison à double pile pour envoyer AWS des demandes. Pour en savoir plus sur les points de terminaison à double pile, qui prennent en charge à la fois le IPv6 trafic IPv4 et le trafic, consultez la section [Utilisation des points de terminaison à double pile Amazon S3 dans le guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/dual-stack-endpoints.html) de l'utilisateur d'*Amazon Simple Storage Service*. Les points de terminaison à double pile sont disponibles pour certains services dans certaines régions. S'il n'existe pas de point de terminaison à double pile pour le service ou Région AWS si la demande échoue. Par défaut, l’option est désactivée. ## Définition de points de terminaison spécifiques aux services La configuration du point de terminaison spécifique au service offre la possibilité d'utiliser un point de terminaison persistant de votre choix pour les AWS CLI demandes. Ces paramètres offrent la flexibilité nécessaire pour prendre en charge les points de terminaison locaux, les points de terminaison VPC et les environnements de développement locaux tiers AWS . Différents points de terminaison peuvent être utilisés pour les environnements de test et de production. Vous pouvez indiquer une URL de point de terminaison pour des Services AWS individuels. Les points de terminaison spécifiques aux services peuvent être indiqués de plusieurs manières : + Option de ligne de commande `--endpoint-url` pour une commande unique. + Variables d’environnement : + `AWS\$1IGNORE\$1CONFIGURED\$1ENDPOINT\$1URLS`- Ignorez tous les points de terminaison configurés URLs, sauf indication contraire sur la ligne de commande. + `AWS\$1ENDPOINT\$1URL\$1` - Indique un point de terminaison personnalisé qui est utilisé pour un service spécifique, où `` est remplacé par l’identifiant du Service AWS . Pour voir toutes les variables spécifiques aux services, consultez [Points de terminaison spécifiques aux services : liste des identifiants spécifiques aux services](#endpoints-service-specific-table). + Fichier `config` : + `ignore\$1configure\$1endpoint\$1urls`- Ignorez tous les points de terminaison configurés URLs, sauf s'ils sont spécifiés à l'aide de variables d'environnement ou sur la ligne de commande. + Section [`services`](cli-configure-files.md#cli-configure-files-format-services) du fichier `config` combinée au paramètre de fichier `endpoint\$1url`. **Topics** + [Variables d’environnement](#endpoints-service-specific-envvars) + [Fichier `config` partagé](#endpoints-service-specific-config) + [Liste des identifiants spécifiques aux services](#endpoints-service-specific-table) ### Points de terminaison spécifiques aux services : variables d’environnement Les variables d’environnement remplacent les paramètres de votre fichier de configuration, mais ne remplacent pas les options indiquées sur la ligne de commande. Utilisez des variables d’environnement si vous souhaitez que tous les profils utilisent les mêmes points de terminaison sur votre appareil. Les variables d’environnement spécifiques aux services sont les suivantes : + `AWS\$1IGNORE\$1CONFIGURED\$1ENDPOINT\$1URLS`- Ignorez tous les points de terminaison configurés URLs, sauf indication contraire sur la ligne de commande. ------ #### [ Linux or macOS ] ``` $ export AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true ``` ------ #### [ Windows Command Prompt ] **Définition pour toutes les sessions** ``` C:\> setx AWS_IGNORE_CONFIGURED_ENDPOINT_URLS true ``` **Définition pour la session en cours uniquement** ``` C:\> set AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true ``` ------ #### [ PowerShell ] ``` PS C:\> $Env:AWS_IGNORE_CONFIGURED_ENDPOINT_URLS="true" ``` ------ + `AWS\$1ENDPOINT\$1URL\$1`- Spécifie un point de terminaison personnalisé utilisé pour un service spécifique, où `` il est remplacé par l' Service AWS identifiant. Pour voir toutes les variables spécifiques aux services, consultez [Points de terminaison spécifiques aux services : liste des identifiants spécifiques aux services](#endpoints-service-specific-table). Les exemples de variables d’environnement suivants définissent un point de terminaison pour AWS Elastic Beanstalk : ------ #### [ Linux or macOS ] ``` $ export AWS_ENDPOINT_URL_ELASTIC_BEANSTALK=http://localhost:4567 ``` ------ #### [ Windows Command Prompt ] **Définition pour toutes les sessions** ``` C:\> setx AWS_ENDPOINT_URL_ELASTIC_BEANSTALK http://localhost:4567 ``` **Définition pour la session en cours uniquement** ``` C:\> set AWS_ENDPOINT_URL_ELASTIC_BEANSTALK=http://localhost:4567 ``` ------ #### [ PowerShell ] ``` PS C:\> $Env:AWS_ENDPOINT_URL_ELASTIC_BEANSTALK="http://localhost:4567" ``` ------ Pour plus d’informations sur la définition de variables d’environnement, consultez [Configuration des variables d'environnement pour AWS CLI](cli-configure-envvars.md). ### Points de terminaison spécifiques aux services : fichier `config` partagé Dans le fichier `config` partagé, `endpoint_url` est utilisé dans plusieurs sections. Pour définir un point de terminaison spécifique aux services, utilisez le paramètre `endpoint_url` imbriqué sous une clé d’identification de service au sein d’une section `services`. Pour plus de détails sur la définition d’une section `services` dans votre fichier `config` partagé, consultez [Type de section : `services`](cli-configure-files.md#cli-configure-files-format-services). L’exemple suivant utilise une section `services` pour configurer une URL de point de terminaison spécifique aux services pour Amazon S3 et un point de terminaison global personnalisé utilisé pour tous les autres services : ``` [profile dev1] endpoint_url = http://localhost:1234 services = s3-specific [services testing-s3] s3 = endpoint_url = http://localhost:4567 ``` Un profil unique peut configurer des points de terminaison pour plusieurs services. L'exemple suivant définit le point de terminaison spécifique au service URLs pour Amazon S3 et AWS Elastic Beanstalk dans le même profil. Pour obtenir la liste de toutes les clés d’identification de service à utiliser dans la section `services`, consultez [Liste des identifiants spécifiques aux services](#endpoints-service-specific-table). ``` [profile dev1] services = testing-s3-and-eb [services testing-s3-and-eb] s3 = endpoint_url = http://localhost:4567 elastic_beanstalk = endpoint_url = http://localhost:8000 ``` La section de configuration du service peut être utilisée dans plusieurs profils. Dans l’exemple suivant, deux profils utilisent la même définition `services` : ``` [profile dev1] output = json services = testing-s3 [profile dev2] output = text services = testing-s3 [services testing-s3] s3 = endpoint_url = https://localhost:4567 ``` ### Points de terminaison spécifiques aux services : liste des identifiants spécifiques aux services L' Service AWS identifiant est basé sur le modèle d'API `serviceId` en remplaçant tous les espaces par des traits de soulignement et en minuscules toutes les lettres. Le tableau suivant répertorie tous les identifiants, clés de fichier `config` et variables d’environnement spécifiques aux services. ## Points de terminaison basés sur un compte Les points de terminaison basés sur un compte peuvent être indiqués de plusieurs manières : + Variables d’environnement + `AWS\$1ACCOUNT\$1ID` : indique l’ID du point de terminaison basé sur un compte AWS à utiliser pour les appels aux Services AWS pris en charge. ------ #### [ Linux or macOS ] ``` $ export AWS_ACCOUNT_ID= ``` ------ #### [ Windows Command Prompt ] **Définition pour toutes les sessions** ``` C:\> setx AWS_ACCOUNT_ID ``` **Définition pour la session en cours uniquement** ``` C:\> set AWS_ACCOUNT_ID= ``` ------ #### [ PowerShell ] ``` PS C:\> $Env:AWS_ACCOUNT_ID="" ``` ------ + `AWS\$1ACCOUNT\$1ID\$1ENDPOINT\$1MODE`- Spécifie s'il faut utiliser un point de terminaison AWS basé sur le compte IDs pour les appels vers le support. Services AWS Cette option peut être définie sur `preferred`, `disabled` ou `required`. La valeur par défaut est `preferred`. ------ #### [ Linux or macOS ] ``` $ export AWS_ACCOUNT_ID_ENDPOINT_MODE=preferred ``` ------ #### [ Windows Command Prompt ] **Définition pour toutes les sessions** ``` C:\> setx AWS_ACCOUNT_ID_ENDPOINT_MODE preferred ``` **Définition pour la session en cours uniquement** ``` C:\> set AWS_ACCOUNT_ID_ENDPOINT_MODE=preferred ``` ------ #### [ PowerShell ] ``` PS C:\> $Env:AWS_ACCOUNT_ID_ENDPOINT_MODE="preferred" ``` ------ + Fichier `config` : + `aws\$1account\$1id`- Spécifie l'ID du point de terminaison AWS basé sur le compte à utiliser pour les appels vers le service pris en charge. Services AWS ``` aws_account_id = ``` + `account\$1id\$1endpoint\$1mode`- Spécifie s'il faut utiliser un point de terminaison AWS basé sur le compte IDs pour les appels vers le support. Services AWS Cette option peut être définie sur `preferred`, `disabled` ou `required`. La valeur par défaut est preferred. ``` account_id_endpoint_mode = preferred ``` Les terminaux basés sur les comptes contribuent à garantir des performances et une évolutivité élevées en utilisant votre identifiant de AWS compte pour rationaliser le routage des Service AWS demandes de services prenant en charge cette fonctionnalité. Lorsque vous utilisez un fournisseur d'informations d'identification et un service qui prend en charge les points de terminaison basés sur des comptes, ils construisent et utilisent AWS CLI automatiquement un point de terminaison basé sur un compte plutôt qu'un point de terminaison régional. Les points de terminaison basés sur un compte utilisent le format suivant, où `` est remplacé par votre identifiant de AWS compte et `` par votre : Région AWS ``` https://.myservice..amazonaws.com ``` Par défaut AWS CLI, le mode de point de terminaison basé sur le compte est défini sur. `preferred` ## Configuration du point de terminaison et priorité des paramètres Les paramètres de configuration du point de terminaison se trouvent à plusieurs endroits, tels que les variables d'environnement système ou utilisateur, les fichiers de AWS configuration locaux, ou sont explicitement déclarés sur la ligne de commande en tant que paramètre. Les paramètres de configuration du point de AWS CLI terminaison sont prioritaires dans l'ordre suivant : 1. Option de ligne de commande `--endpoint-url`. 1. Si cette option est activée, la variable d’environnement du point de terminaison global `AWS\$1IGNORE\$1CONFIGURED\$1ENDPOINT\$1URLS` ou le paramètre de profil `ignore\$1configure\$1endpoint\$1urls` pour ignorer les points de terminaison personnalisés. 1. La valeur fournie par une variable d’environnement spécifique aux services `AWS\$1ENDPOINT\$1URL\$1`, telle que `AWS_ENDPOINT_URL_DYNAMODB`. 1. Les valeurs fournies par les variables d’environnement `AWS\$1USE\$1DUALSTACK\$1ENDPOINT`, `AWS\$1USE\$1FIPS\$1ENDPOINT` et `AWS\$1ENDPOINT\$1URL`. 1. La variable d’environnement `AWS\$1ACCOUNT\$1ID\$1ENDPOINT\$1MODE` est définie sur `preferred` ou `required` à l’aide de l’ID de compte dans la variable d’environnement `AWS\$1ACCOUNT\$1ID` ou le paramètre `aws\$1account\$1id`. 1. La valeur du point de terminaison spécifique aux services fournie par le paramètre `endpoint\$1url` dans une section `services` du fichier `config` partagé. 1. La valeur fournie par le paramètre `endpoint\$1url` dans un `profile` du fichier `config` partagé. 1. Paramètres `use\$1dualstack\$1endpoint`, `use\$1fips\$1endpoint` et `endpoint\$1url`. 1. Le paramètre `account\$1id\$1endpoint\$1mode` est défini sur `preferred` ou `required` à l’aide de l’ID de compte dans la variable d’environnement `AWS\$1ACCOUNT\$1ID` ou le paramètre `aws\$1account\$1id`. 1. Toute URL de point de terminaison par défaut pour le point de terminaison correspondant Service AWS est utilisée en dernier. Pour afficher la liste des points de terminaison de service standard disponibles dans chaque région, consultez [Régions et points de terminaison AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html) dans le *Référence générale d'Amazon Web Services*.