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 AWSconfigfichiers 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_versionsparamè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
configfichier. 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-01cloudfront =2015-09-017 ca_bundle- réglage des AWSconfigfichiers partagésAWS_CA_BUNDLE- variable d'environnement-
Spécifie le chemin d'accès à un ensemble de certificats personnalisé (un fichier avec une
.pemextension) à 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
configfichier :[default] ca_bundle =dev/apps/ca-certs/cabundle-2019mar05.pemEn 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
configfichier sous Windows :[default] ca_bundle =C:\\Users\\username\\.aws\\aws-custom-bundle.pemLinux/macOS exemple de définition de variables d'environnement via la ligne de commande :
export AWS_CA_BUNDLE=/dev/apps/ca-certs/cabundle-2019mar05.pemExemple Windows de définition de variables d'environnement via la ligne de commande :
setx AWS_CA_BUNDLEC:\dev\apps\ca-certs\cabundle-2019mar05.pem output- réglage des AWSconfigfichiers 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 :
jsonValeurs valides:
-
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, commegrep,sedouawk. -
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 AWSconfigfichiers 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 :
trueValeurs 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 |