Paramètres de configuration généraux

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

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

api_versions- partagé AWS configréglage du fichier

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

Valeur par défaut : Aucune. (APILa dernière version est utilisée par leSDK.)

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

L'exemple définit une API version spécifique pour deux AWS services contenus dans le config fichier. Ces API versions ne sont utilisées que pour les commandes exécutées sous le profil contenant ces paramètres. Les commandes de tout autre service utilisent la dernière version de ce serviceAPI.

api_versions =
    ec2 = 2015-03-01
    cloudfront = 2015-09-017

ca_bundle- partagé AWS configréglage du fichier

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 TLS connexions SSL /.

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'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'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- partagé AWS configréglage du fichier

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

Valeur par défaut : json

Valeurs valides:

• json— La sortie est formatée sous forme de JSONchaîne.

• yaml— La sortie est formatée sous forme de YAMLchaîne.

• 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, comme grepsed, 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- partagé AWS configréglage du fichier

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

Valeur par défaut : true

Valeurs valides:

• true – Valeur par défaut L'outil SDK or effectue une validation côté client des paramètres de ligne de commande. Cela permet à l'outil SDK or de confirmer que les paramètres sont valides et de détecter certaines erreurs. L'outil SDK or peut rejeter les demandes non valides avant d'envoyer des demandes au AWS point de terminaison de service.

• false— L'outil SDK or ne valide pas les paramètres de ligne de commande avant de les envoyer au AWS point de terminaison de service. Le AWS le point de terminaison de service est chargé de valider toutes les demandes et de rejeter les demandes non valides.

Compatibilité avec AWS SDKs

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 des propriétés du JVM système sont pris en charge par AWS SDK for Java et le Kit AWS SDK pour Kotlin uniquement.

SDK	Pris en charge	Remarques ou informations supplémentaires
AWS CLI v2	Partielle	api_versionsnon pris en charge.
SDKpour C++	Oui
SDKpour Go V2 (1.x)	Partielle	api_versionset parameter_validation non pris en charge.
SDKpour 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.
SDKpour Java 2.x	Non
SDKpour Java 1.x	Non
SDKpour JavaScript 3.x	Oui
SDKpour JavaScript 2.x	Oui
SDKpour Kotlin	Non
SDKpour. NET3. x	Non
SDKpour PHP 3.x	Oui
SDKpour Python (Boto3)	Oui
SDKpour Ruby 3.x	Oui
SDKpour Rust	Non
SDKpour Swift	Non
Outils pour PowerShell	Non