Allgemeine Konfigurationseinstellungen

SDKsunterstützt einige allgemeine Einstellungen, die das allgemeine SDK Verhalten konfigurieren.

Konfigurieren Sie diese Funktionalität wie folgt:

api_versions- geteilt AWS configDateieinstellung

Etwas AWS Dienste verwalten mehrere API Versionen, um die Abwärtskompatibilität zu unterstützen. Standardmäßig und SDK AWS CLI Operationen verwenden die neueste verfügbare API Version. Wenn Sie eine bestimmte API Version für Ihre Anfragen benötigen möchten, nehmen Sie die api_versions Einstellung in Ihr Profil auf.

Standardwert: Keiner. (Die neueste API Version wird von der verwendetSDK.)

Gültige Werte: Dies ist eine verschachtelte Einstellung, auf die eine oder mehrere eingerückte Zeilen folgen, die jeweils eine Zeile kennzeichnen AWS Dienst und die zu API verwendende Version. Weitere Informationen finden Sie in der Dokumentation für AWS Service, um zu erfahren, welche API Versionen verfügbar sind.

Das Beispiel legt eine bestimmte API Version für zwei fest AWS Dienste in der config Datei. Diese API Versionen werden nur für Befehle verwendet, die unter dem Profil ausgeführt werden, das diese Einstellungen enthält. Befehle für jeden anderen Dienst verwenden die neueste Version dieses DienstesAPI.

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

ca_bundle- geteilt AWS configDateieinstellung

AWS_CA_BUNDLE- Umgebungsvariable

Gibt den Pfad zu einem benutzerdefinierten Zertifikatspaket (einer Datei mit einer .pem Erweiterung) an, das beim Herstellen von SSL TLS /-Verbindungen verwendet werden soll.

Standardwert: keiner

Gültige Werte: Geben Sie entweder den vollständigen Pfad oder einen Basisdateinamen an. Wenn es einen Basisdateinamen gibt, versucht das System, das Programm in den durch die PATH Umgebungsvariable angegebenen Ordnern zu finden.

Beispiel für die Einstellung dieses Werts in der config Datei:

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

Aufgrund von Unterschieden in der Art und Weise, wie Betriebssysteme Pfade behandeln und Pfadzeichen maskieren, finden Sie im Folgenden ein Beispiel für die Einstellung dieses Werts in der config Datei unter Windows:

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

Linux/macOS-Beispiel für das Setzen von Umgebungsvariablen über die Befehlszeile:

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

Windows-Beispiel für das Setzen von Umgebungsvariablen über die Befehlszeile:

setx AWS_CA_BUNDLE C:\dev\apps\ca-certs\cabundle-2019mar05.pem

output- gemeinsam genutzt AWS configDateieinstellung

Gibt an, wie Ergebnisse formatiert werden in AWS CLI und andere AWS SDKsund Werkzeuge.

Standardwert: json

Zulässige Werte:

• json— Die Ausgabe ist als JSONZeichenfolge formatiert.

• yaml— Die Ausgabe ist als Zeichenfolge formatiert. YAML

• yaml-stream— Die Ausgabe wird gestreamt und als Zeichenfolge formatiert. YAML Streaming ermöglicht eine schnellere Handhabung großer Datentypen.

• text – Die Ausgabe wird als mehrere Zeilen mit tabulatorgetrennten Zeichenfolgenwerten formatiert. Dies kann nützlich sein, um die Ausgabe an einen Textprozessor wie grep, sed oder awk zu übergeben.

• table – Die Ausgabe erfolgt in Form einer Tabelle mit den Zeichen +|-, um die Zellenrahmen zu bilden. Normalerweise wird die Information in einem benutzerfreundlichen Format wiedergegeben, das viel einfacher zu lesen ist als die anderen, jedoch programmatisch nicht so nützlich ist.

parameter_validation- geteilt AWS configDateieinstellung

Gibt an, ob das Tool SDK oder versucht, Befehlszeilenparameter zu überprüfen, bevor es sie an die AWS Dienstendpunkt.

Standardwert: true

Zulässige Werte:

• true – Der Standardwert. Das Tool SDK oder führt eine clientseitige Überprüfung von Befehlszeilenparametern durch. Auf diese Weise kann das Tool SDK oder überprüfen, ob die Parameter gültig sind, und es werden einige Fehler erkannt. Das Tool SDK oder kann Anfragen zurückweisen, die nicht gültig sind, bevor es Anfragen an das AWS Dienstendpunkt.

• false— Das Tool SDK oder validiert Befehlszeilenparameter nicht, bevor es sie an die AWS Dienstendpunkt. Das Tool AWS Der Service-Endpunkt ist dafür verantwortlich, alle Anfragen zu validieren und Anfragen abzulehnen, die nicht gültig sind.

Kompatibilität mit AWS SDKs

Im Folgenden werden die in diesem Thema beschriebenen Funktionen und Einstellungen SDKs unterstützt. Alle teilweisen Ausnahmen werden vermerkt. Alle Einstellungen für JVM Systemeigenschaften werden unterstützt von AWS SDK for Java und die AWS SDK for Kotlin nur.

SDK	Unterstützt	Notizen oder weitere Informationen
AWS CLI v2	Teilweise	api_versionsnicht unterstützt.
SDKfür C++	Ja
SDKfür Go V2 (1.x)	Teilweise	api_versionsund wird parameter_validation nicht unterstützt.
SDKfür Go 1.x (V1)	Teilweise	api_versionsund wird parameter_validation nicht unterstützt. Um die Einstellungen für gemeinsam genutzte config Dateien zu verwenden, müssen Sie das Laden aus der Konfigurationsdatei aktivieren. Weitere Informationen finden Sie unter Sitzungen.
SDKfür Java 2.x	Nein
SDKfür Java 1.x	Nein
SDKfür 3.x JavaScript	Ja
SDKfür 2.x JavaScript	Ja
SDKfür Kotlin	Nein
SDKfür. NET3.x	Nein
SDKfür 3.x PHP	Ja
SDKfür Python (Boto3)	Ja
SDKfür Ruby 3.x	Ja
SDKfür Rust	Nein
SDKfür Swift	Nein
Tools für PowerShell	Nein