Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Allgemeine Konfigurationseinstellungen
Anmerkung
Hilfe zum Verständnis des Layouts von Einstellungsseiten oder zur Interpretation der folgenden Tabelle „Unterstützung durch AWS SDKs und Tools“ finden Sie unterDie Einstellungsseiten dieses Handbuchs verstehen.
SDKs unterstützen einige allgemeine Einstellungen, die das allgemeine SDK-Verhalten konfigurieren.
Konfigurieren Sie diese Funktion mithilfe der folgenden Optionen:
api_versions- Einstellung für gemeinsam genutzte AWSconfigDateien-
Einige AWS Dienste verfügen über mehrere API-Versionen, um die Abwärtskompatibilität zu unterstützen. Standardmäßig verwenden SDK und AWS CLI Operations die neueste verfügbare API-Version. Wenn Sie eine bestimmte API-Version für Ihre Anfragen benötigen, nehmen Sie die
api_versionsEinstellung in Ihr Profil auf.Standardwert: Keiner. (Die neueste API-Version wird vom SDK verwendet.)
Gültige Werte: Dies ist eine verschachtelte Einstellung, auf die eine oder mehrere eingerückte Zeilen folgen, die jeweils einen AWS Dienst und die zu verwendende API-Version identifizieren. In der Dokumentation zum AWS Dienst erfahren Sie, welche API-Versionen verfügbar sind.
Das Beispiel legt eine bestimmte API-Version für zwei AWS Dienste in der
configDatei fest. Diese API-Versionen werden nur für Befehle verwendet, die unter dem Profil mit diesen Einstellungen ausgeführt werden. Befehle für jeden anderen Dienst verwenden die neueste Version der API dieses Dienstes.api_versions = ec2 =2015-03-01cloudfront =2015-09-017 ca_bundle- Einstellung für gemeinsam genutzte AWSconfigDateienAWS_CA_BUNDLE- Umgebungsvariable-
Gibt den Pfad zu einem benutzerdefinierten Zertifikatspaket (einer Datei mit einer
.pemErweiterung) 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
PATHUmgebungsvariable angegebenen Ordnern zu finden.Beispiel für das Setzen dieses Werts in der
configDatei:[default] ca_bundle =dev/apps/ca-certs/cabundle-2019mar05.pemAufgrund der Unterschiede in der Art und Weise, wie Betriebssysteme Pfade und das Escapen von Pfadzeichen behandeln, finden Sie im Folgenden ein Beispiel für die Einstellung dieses Werts in der
configDatei unter Windows:[default] ca_bundle =C:\\Users\\username\\.aws\\aws-custom-bundle.pemLinux/macOS Beispiel für das Setzen von Umgebungsvariablen über die Befehlszeile:
export AWS_CA_BUNDLE=/dev/apps/ca-certs/cabundle-2019mar05.pemWindows-Beispiel für das Setzen von Umgebungsvariablen über die Befehlszeile:
setx AWS_CA_BUNDLEC:\dev\apps\ca-certs\cabundle-2019mar05.pem output- gemeinsame AWSconfigDateieinstellung-
Gibt an, wie Ergebnisse in den AWS CLI und anderen AWS SDKs und Tools formatiert werden.
Standardwert:
jsonZulässige Werte:
-
yaml-stream– Die Ausgabe erfolgt im YAML-Format und wird so auch gestreamt. 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 wiegrep,sedoderawkzu ü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- Einstellung für gemeinsam genutzte Dateien AWSconfig-
Gibt an, ob das SDK oder Tool versucht, Befehlszeilenparameter zu überprüfen, bevor sie an den AWS Service-Endpunkt gesendet werden.
Standardwert:
trueZulässige Werte:
-
true– Der Standardwert. Das SDK oder Tool führt eine clientseitige Validierung der Befehlszeilenparameter durch. Auf diese Weise kann das SDK oder Tool überprüfen, ob die Parameter gültig sind, und es werden einige Fehler erkannt. Das SDK oder Tool kann Anfragen ablehnen, die nicht gültig sind, bevor Anfragen an den AWS Dienstendpunkt gesendet werden. -
false— Das SDK oder Tool validiert Befehlszeilenparameter nicht, bevor sie an den AWS Service-Endpunkt gesendet werden. Der AWS Service-Endpunkt ist dafür verantwortlich, alle Anfragen zu validieren und ungültige Anfragen abzulehnen.
-
Unterstützung von AWS SDKs und Tools
Die folgenden SDKs unterstützen die in diesem Thema beschriebenen Funktionen und Einstellungen. Alle teilweisen Ausnahmen werden vermerkt. Alle JVM-Systemeigenschaftseinstellungen werden von AWS SDK für Java and the AWS SDK für Kotlin only unterstützt.
| SDK | Unterstützt | Hinweise oder weitere Informationen |
|---|---|---|
| AWS CLI v2 | Teilweise | api_versionswird nicht unterstützt. |
| SDK für C++ | Ja | |
| SDK für Go V2 (1.x) | Teilweise | api_versionsund parameter_validation nicht unterstützt. |
| SDK für Go 1.x (V1) | Teilweise | api_versionsund 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; siehe Sitzungen. |
| SDK für Java 2.x | Nein | |
| SDK für Java 1.x | Nein | |
| SDK für 3.x JavaScript | Ja | |
| SDK für 2.x JavaScript | Ja | |
| SDK für Kotlin | Nein | |
| SDK für.NET 4.x | Nein | |
| SDK für.NET 3.x | Nein | |
| SDK für PHP 3.x | Ja | |
| SDK für Python (Boto3) | Ja | |
| SDK für Ruby 3.x | Ja | |
| SDK für Rust | Nein | |
| SDK für Swift | Nein | |
| Tools für PowerShell V5 | Nein | |
| Tools für V4 PowerShell | Nein |