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 by AWS SDKs et outils ci-dessous, voirComprendre les pages de paramètres de ce guide.
SDKs prend en charge certains paramètres généraux qui configurent les comportements généraux du SDK.
Configurez cette fonctionnalité à l'aide des méthodes suivantes :
api_versions
- réglage AWSconfig
du fichier partagé-
Certains AWS services gèrent plusieurs versions d'API afin de garantir la rétrocompatibilité. Par défaut, le SDK et les AWS CLI opérations utilisent la dernière version d'API disponible. Pour exiger 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 d'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 AWSconfig
du fichier partagé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 connexions SSL/TLS.Valeur par défaut : aucune
Valeurs valides : Spécifiez le chemin complet ou le nom du 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'
PATH
environnement.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'absence de 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
Exemple Linux/macOS 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 AWSconfig
du fichier partagé-
Spécifie la manière dont les résultats sont formatés dans les outils AWS CLI et dans les autres AWS SDKs outils.
Valeur par défaut :
json
Valeurs valides:
-
yaml-stream
— La sortie est diffusée et formatée sous forme de chaîne YAML. Le streaming permet de traiter plus rapidement de gros types de données. -
text
— La sortie est formatée sous la forme de plusieurs lignes de valeurs de chaîne séparées par des tabulations. Cela peut être utile pour transmettre le résultat à un processeur de texte, commegrep
sed
, ouawk
. -
table
— La sortie est formatée sous forme de tableau en utilisant les caractères +|- pour former 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 AWSconfig
du fichier partagé-
Spécifie si le SDK ou l'outil tente de valider les paramètres de 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 que les paramètres sont valides et de détecter certaines erreurs. Le SDK ou l'outil peut rejeter les demandes non valides avant de les envoyer 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 non valides.
-
Support par AWS SDKs et outils
Les éléments suivants SDKs prennent en charge les fonctionnalités et les paramètres décrits dans cette rubrique. Toute exception partielle est notée. Tous les paramètres de propriété du système JVM sont pris en charge par le AWS SDK pour Java et le Kit AWS SDK pour Kotlin seul.
SDK | Pris en charge | Remarques ou informations supplémentaires |
---|---|---|
AWS CLI v2 | Partielle | api_versions non pris en charge. |
SDK pour C++ | Oui | |
SDK pour Go V2 (1.x) |
Partielle | api_versions et parameter_validation non pris en charge. |
SDK pour Go 1.x (V1) | Partielle | api_versions et 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 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 | Non |