View a markdown version of this page

Paramètres de configuration généraux - AWS SDK et outils

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.

Paramètres de configuration généraux

Note

Pour vous aider à comprendre la mise en page des pages de paramètres ou à interpréter le tableau Support par AWS les SDK et les outils qui suit, consultezComprendre les pages de paramètres de ce guide.

Les SDK prennent en charge certains paramètres généraux qui configurent les comportements généraux des SDK.

Configurez cette fonctionnalité à l'aide des méthodes suivantes :

api_versions- réglage des AWS config fichiers partagés

Certains AWS services proposent plusieurs versions d'API pour assurer la rétrocompatibilité. Par défaut, le SDK et les AWS CLI opérations utilisent la dernière version d'API disponible. Pour demander l'utilisation d'une version d'API spécifique pour vos demandes, incluez le api_versions paramètre dans votre profil.

Valeur par défaut : Aucune. (La dernière version de l'API est utilisée par le SDK.)

Valeurs valides : il s'agit d'un paramètre imbriqué suivi d'une ou de plusieurs lignes en retrait identifiant chacune un AWS service et la version de l'API à utiliser. Consultez la documentation du AWS service pour savoir quelles versions d'API sont disponibles.

L'exemple définit une version d'API spécifique pour deux AWS services du config fichier. Ces versions de l’API ne sont utilisées que pour les commandes qui s’exécutent sous le profil qui contient ces paramètres. Les commandes de tout autre service utilisent la dernière version de l'API de ce service.

api_versions = ec2 = 2015-03-01 cloudfront = 2015-09-017
ca_bundle- réglage des AWS config fichiers partagés
AWS_CA_BUNDLE- variable d'environnement

Spécifie le chemin d'accès à un ensemble de certificats personnalisé (un fichier avec une .pem extension) à utiliser lors de l'établissement de SSL/TLS connexions.

Valeur par défaut : aucune

Valeurs valides : Spécifiez le chemin complet ou un nom de fichier de base. S'il existe un nom de fichier de base, le système tente de trouver le programme dans les dossiers spécifiés par la variable d'PATHenvironnement.

Exemple de définition de cette valeur dans le config fichier :

[default] ca_bundle = dev/apps/ca-certs/cabundle-2019mar05.pem

En raison des différences dans la façon dont les systèmes d'exploitation gèrent les chemins et l'échappement des caractères de chemin, voici un exemple de définition de cette valeur dans le config fichier sous Windows :

[default] ca_bundle = C:\\Users\\username\\.aws\\aws-custom-bundle.pem

Linux/macOS exemple de définition de variables d'environnement via la ligne de commande :

export AWS_CA_BUNDLE=/dev/apps/ca-certs/cabundle-2019mar05.pem

Exemple Windows de définition de variables d'environnement via la ligne de commande :

setx AWS_CA_BUNDLE C:\dev\apps\ca-certs\cabundle-2019mar05.pem
output- réglage des AWS config fichiers partagés

Spécifie la façon dont les résultats sont mis en forme dans le AWS SDK AWS CLI et les autres outils.

Valeur par défaut : json

Valeurs valides:

  • json : la sortie est au format d’une chaîne JSON.

  • yaml : la sortie est au format d’une chaîne YAML.

  • yaml-stream : la sortie est diffusée et au format d’une chaîne YAML. La diffusion permet de traiter plus rapidement de gros types de données.

  • text : la sortie a le format de plusieurs lignes de valeurs de chaîne séparées par des tabulations. Cela peut être utile pour transmettre la sortie à un processeur de texte, comme grep, sed ou awk.

  • table : la sortie est au format d’un tableau utilisant les caractères +|- pour délimiter les bordures des cellules. La présentation des informations est dans un format beaucoup plus lisible par l’utilisateur que les autres, mais peu pratique du point de vue programmation.

parameter_validation- réglage des AWS config fichiers partagés

Spécifie si le SDK ou l'outil tente de valider les paramètres de la ligne de commande avant de les envoyer au point de terminaison du AWS service.

Valeur par défaut : true

Valeurs valides:

  • true – Valeur par défaut Le SDK ou l'outil effectue la validation côté client des paramètres de ligne de commande. Cela permet au SDK ou à l'outil de confirmer la validité des paramètres et de détecter certaines erreurs. Le SDK ou l'outil peut rejeter les demandes qui ne sont pas valides avant d'envoyer des demandes au point de terminaison du AWS service.

  • false— Le SDK ou l'outil ne valide pas les paramètres de ligne de commande avant de les envoyer au point de terminaison du AWS service. Le point AWS de terminaison du service est chargé de valider toutes les demandes et de rejeter les demandes qui ne sont pas valides.

Soutenu par AWS Kits SDK et outils

Les kits SDK suivants prennent en charge les fonctionnalités et les paramètres décrits dans cette rubrique. Toutes les exceptions partielles sont notées. Tous les paramètres de propriété du système JVM sont pris en charge par le AWS SDK pour Java et le AWS SDK pour Kotlin seul.

Kit SDK Pris en charge Remarques ou informations supplémentaires
AWS CLI   v2 Partielle api_versionsnon pris en charge.
SDK pour C++ Oui
SDK pour Go V2 (1.x) Partielle api_versionset parameter_validation non pris en charge.
SDK pour Go 1.x (V1) Partielle api_versionset parameter_validation non pris en charge. Pour utiliser les paramètres des config fichiers partagés, vous devez activer le chargement à partir du fichier de configuration ; voir Sessions.
SDK pour Java 2.x Non
SDK pour Java 1.x Non
SDK pour 3.x JavaScript Oui
SDK pour 2.x JavaScript Oui
SDK pour Kotlin Non
SDK pour .NET 4.x Non
SDK pour .NET 3.x Non
SDK pour PHP 3.x Oui
SDK pour Python (Boto3) Oui
SDK pour Ruby 3.x Oui
SDK pour Rust Non
SDK pour Swift Non
Outils pour PowerShell V5 Non
Outils pour PowerShell V4 Non