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.
Référence des paramètres
SDKsfournir des informations spécifiques à la langue APIs pour. Services AWS Ils prennent en charge certaines des tâches les plus lourdes nécessaires à la réussite des API appels, notamment l'authentification, le comportement des nouvelles tentatives, etc. Pour ce faire, SDKs ils disposent de stratégies flexibles pour obtenir des informations d'identification à utiliser pour vos demandes, pour maintenir les paramètres à utiliser avec chaque service et pour obtenir des valeurs à utiliser pour les paramètres globaux.
Vous trouverez des informations détaillées sur les paramètres de configuration dans les sections suivantes :
-
AWS SDKset outils : fournisseurs d'accréditations standardisés— Fournisseurs d'informations d'identification communs normalisés sur plusieursSDKs.
-
AWS SDKset fonctionnalités standardisées des outils— Fonctionnalités communes standardisées sur plusieursSDKs.
Création de clients de service
Pour y accéder par programmation Services AWS, SDKs utilisez une classe/un objet client pour chacun. Service AWS Par exemple, si votre application doit accéder à AmazonEC2, elle crée un objet EC2 client Amazon pour interagir avec ce service. Vous utilisez ensuite le client du service pour y faire des demandes Service AWS. Dans la plupart des casSDKs, un objet client de service est immuable. Vous devez donc créer un nouveau client pour chaque service auquel vous faites des demandes et pour envoyer des demandes au même service en utilisant une configuration différente.
Priorité des paramètres
Les paramètres globaux configurent les fonctionnalités, les fournisseurs d'informations d'identification et les autres fonctionnalités prises en charge par la plupart des SDKs utilisateurs et ayant un large impact sur tous Services AWS. Tous SDKs ont une série de lieux (ou de sources) qu'ils vérifient afin de trouver une valeur pour les paramètres globaux. La définition de la priorité de recherche est la suivante :
-
Tout paramètre explicite défini dans le code ou sur un client de service lui-même a priorité sur tout autre paramètre.
-
Certains paramètres peuvent être définis pour chaque opération et peuvent être modifiés selon les besoins pour chaque opération que vous invoquez. Pour le AWS CLI ou AWS Tools for PowerShell, ils prennent la forme de paramètres par opération que vous entrez sur la ligne de commande. Par exempleSDK, les assignations explicites peuvent prendre la forme d'un paramètre que vous définissez lorsque vous instanciez un Service AWS client ou un objet de configuration, ou parfois lorsque vous appelez une personne. API
-
-
Java/Kotlin uniquement : la propriété JVM système du paramètre est vérifiée. Si elle est définie, cette valeur est utilisée pour configurer le client.
-
La variable d'environnement est contrôlée. Si elle est définie, cette valeur est utilisée pour configurer le client.
-
SDKVérifie le paramètre dans le
credentials
fichier partagé. S'il est défini, le client l'utilise. -
Le
config
fichier partagé pour le paramètre. Si le paramètre est présent, il l'SDKutilise.-
La variable d'
AWS_PROFILE
environnement ou la propriétéaws.profile
JVM système peuvent être utilisées pour spécifier le profil à SDK charger.
-
-
Toute valeur par défaut fournie par le code SDK source lui-même est utilisée en dernier.
Note
Certains SDKs outils peuvent être enregistrés dans un ordre différent. En outre, certains SDKs outils prennent en charge d'autres méthodes de stockage et de récupération des paramètres. Par exemple, il AWS SDK for .NET prend en charge une source supplémentaire appelée SDKStore. Pour plus d'informations sur les fournisseurs spécifiques à un outil SDK ou, consultez le guide spécifique à l'outil SDK ou que vous utilisez.
L'ordre détermine quelles méthodes ont priorité et remplacent les autres. Par exemple, si vous configurez un profil dans le config
fichier partagé, il n'est trouvé et utilisé qu'une fois que l'outil SDK ou a d'abord vérifié les autres emplacements. Cela signifie que si vous insérez un paramètre dans le credentials
fichier, il est utilisé à la place de celui qui se trouve dans le config
fichier. Si vous configurez une variable d'environnement avec un paramètre et une valeur, elle remplacera ce paramètre dans les config
fichiers credentials
et. Enfin, un réglage sur l'opération individuelle (paramètre de AWS CLI
ligne de commande ou API paramètre) ou dans le code remplacerait toutes les autres valeurs de cette commande.
Pages de paramètres
Les pages de la section de référence des paramètres de ce guide détaillent les paramètres disponibles qui peuvent être définis par le biais de différents mécanismes. Les tableaux suivants répertorient les paramètres des fichiers de configuration et d'identification, les variables d'environnement et (pour Java et KotlinSDKs) les JVM paramètres qui peuvent être utilisés en dehors de votre code pour configurer la fonctionnalité. Chaque rubrique liée dans chaque liste vous amène à la page de paramètres correspondante.
Chaque fournisseur d'informations d'identification ou fonctionnalité possède une page répertoriant les paramètres utilisés pour configurer cette fonctionnalité. Pour chaque paramètre, vous pouvez souvent définir la valeur soit en ajoutant le paramètre à un fichier de configuration, soit en définissant une variable d'environnement, soit (pour Java et Kotlin uniquement) en définissant une propriété JVM système. Chaque paramètre répertorie toutes les méthodes prises en charge pour définir la valeur dans un bloc situé au-dessus des détails de la description. Bien que la priorité varie, la fonctionnalité qui en résulte est la même, quelle que soit la manière dont vous la définissez.
La description inclura la valeur par défaut, le cas échéant, qui prend effet si vous ne faites rien. Il définit également la valeur valide pour ce paramètre.
Par exemple, examinons un paramètre de la page des Compression des demandes fonctionnalités.
Les informations du paramètre d'disable_request_compression
exemple indiquent ce qui suit :
-
Il existe trois méthodes équivalentes pour contrôler la compression des demandes en dehors de votre base de code. Vous avez le choix entre les options suivantes :
-
Définissez-le dans votre fichier de configuration en utilisant
disable_request_compression
-
Définissez-la comme variable d'environnement en utilisant
AWS_DISABLE_REQUEST_COMPRESSION
-
Ou, si vous utilisez Java ou KotlinSDK, définissez-le comme propriété JVM système en utilisant
aws.disableRequestCompression
Note
Il existe peut-être également un moyen de configurer la même fonctionnalité directement dans votre code, mais cette référence ne couvre pas ce point car il est unique à chacunSDK. Si vous souhaitez définir votre configuration dans le code lui-même, consultez votre SDK guide ou API référence spécifique.
-
-
Si vous ne faites rien, la valeur par défaut sera
false
. -
Les seules valeurs valides pour ce paramètre booléen sont
true
et.false
Au bas de chaque page de fonctionnalité se trouve un AWS SDKs tableau de compatibilité avec.
Ce tableau indique si SDK vous acceptez les paramètres répertoriés sur la page. La Supported
colonne indique le niveau de support avec les valeurs suivantes :
-
Yes
— Les paramètres sont entièrement pris en charge par le SDK tel qu'il est écrit. -
Partial
— Certains paramètres sont pris en charge ou le comportement s'écarte de la description. EnPartial
effet, une note supplémentaire indique l'écart. -
No
— Aucun des paramètres n'est pris en charge. Cela ne prétend pas que les mêmes fonctionnalités peuvent être obtenues dans le code ; cela indique simplement que les paramètres de configuration externes répertoriés ne sont pas pris en charge.
Config
liste des paramètres de fichier
Les paramètres répertoriés dans le tableau suivant peuvent être attribués dans le AWS config
fichier partagé. Elles sont mondiales et concernent tout le monde Services AWS. SDKset les outils peuvent également prendre en charge des paramètres et des variables d'environnement uniques. Pour voir les paramètres et les variables d'environnement pris en charge uniquement par un individu SDK ou un outil, consultez le guide spécifique SDK ou le guide de l'outil.
Credentials
liste des paramètres de fichier
Les paramètres répertoriés dans le tableau suivant peuvent être attribués dans le AWS credentials
fichier partagé. Elles sont mondiales et concernent tout le monde Services AWS. SDKset les outils peuvent également prendre en charge des paramètres et des variables d'environnement uniques. Pour voir les paramètres et les variables d'environnement pris en charge uniquement par un individu SDK ou un outil, consultez le guide spécifique SDK ou le guide de l'outil.
Nom du paramètre | Détails |
---|---|
aws_access_key_id
|
AWS clés d'accès |
aws_secret_access_key
|
AWS clés d'accès |
aws_session_token
|
AWS clés d'accès |
Liste des variables d'environnement
Les variables d'environnement prises en charge par la plupart SDKs sont répertoriées dans le tableau suivant. Elles sont mondiales et concernent tout le monde Services AWS. SDKset les outils peuvent également prendre en charge des paramètres et des variables d'environnement uniques. Pour voir les paramètres et les variables d'environnement pris en charge uniquement par un individu SDK ou un outil, consultez le guide spécifique SDK ou le guide de l'outil.
JVMliste des propriétés du système
Vous pouvez utiliser les propriétés JVM système suivantes pour le AWS SDK for Java et Kit AWS SDK pour Kotlin (en ciblant leJVM). Consultez Comment définir les propriétés du système JVM les instructions sur la façon de définir les propriétés JVM du système.