Utilisation de points de terminaison dans AWS CLI - AWS Command Line Interface
Définition d’un point de terminaison pour une commande uniqueDéfinir un point de terminaison global pour tous Services AWSParamétré pour utiliser les FIPs points de terminaison pour tous Services AWSConçu pour utiliser des points de terminaison à double pile pour tous Services AWSDéfinition de points de terminaison spécifiques aux servicesPoints de terminaison basés sur un compteConfiguration du point de terminaison et priorité des paramètres

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.

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_IGNORE_CONFIGURED_ENDPOINT_URLS- 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_ENDPOINT_URL - 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_configure_endpoint_urls- Ignorez le point de terminaison configuré URLs.

      ignore_configure_endpoint_urls = true

    • endpoint_url - 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_USE_FIPS_ENDPOINT.

    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_fips_endpoint.

    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 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.

Pour plus d'informations sur la spécification des points de terminaison FIPS par Région AWS, consultez la section Points de terminaison 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_USE_DUALSTACK_ENDPOINT.

    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_dualstack_endpoint.

    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 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 :

Rubriques relatives aux points de terminaison spécifiques aux services :

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_IGNORE_CONFIGURED_ENDPOINT_URLS- 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_ENDPOINT_URL_<SERVICE>- Spécifie un point de terminaison personnalisé utilisé pour un service spécifique, où <SERVICE> 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.

    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.

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.

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. 

[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_ACCOUNT_ID : 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=<account-id>
      Windows Command Prompt

      Définition pour toutes les sessions

      C:\> setx AWS_ACCOUNT_ID <account-id>

      Définition pour la session en cours uniquement

      C:\> set AWS_ACCOUNT_ID=<account-id>
      PowerShell
      PS C:\> $Env:AWS_ACCOUNT_ID="<account-id>"

    • AWS_ACCOUNT_ID_ENDPOINT_MODE- 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_account_id- 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-id>

    • account_id_endpoint_mode- 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ù <account-id> est remplacé par votre identifiant de AWS compte et <region> par votre : Région AWS

https://<account-id>.myservice.<region>.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.

  2. Si cette option est activée, la variable d’environnement du point de terminaison global AWS_IGNORE_CONFIGURED_ENDPOINT_URLS ou le paramètre de profil ignore_configure_endpoint_urls pour ignorer les points de terminaison personnalisés.

  3. La valeur fournie par une variable d’environnement spécifique aux services AWS_ENDPOINT_URL_<SERVICE>, telle que AWS_ENDPOINT_URL_DYNAMODB.

  4. Les valeurs fournies par les variables d’environnement AWS_USE_DUALSTACK_ENDPOINT, AWS_USE_FIPS_ENDPOINT et AWS_ENDPOINT_URL.

  5. La variable d’environnement AWS_ACCOUNT_ID_ENDPOINT_MODE est définie sur preferred ou required à l’aide de l’ID de compte dans la variable d’environnement AWS_ACCOUNT_ID ou le paramètre aws_account_id.

  6. La valeur du point de terminaison spécifique aux services fournie par le paramètre endpoint_url dans une section services du fichier config partagé.

  7. La valeur fournie par le paramètre endpoint_url dans un profile du fichier config partagé.

  8. Paramètres use_dualstack_endpoint, use_fips_endpoint et endpoint_url.

  9. Le paramètre account_id_endpoint_mode est défini sur preferred ou required à l’aide de l’ID de compte dans la variable d’environnement AWS_ACCOUNT_ID ou le paramètre aws_account_id.

  10. 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 dans le Référence générale d'Amazon Web Services.