View a markdown version of this page

Allgemeine Konfigurationseinstellungen - AWS SDKs und Tools

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 AWS config Dateien

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_versions Einstellung 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 config Datei 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-01 cloudfront = 2015-09-017
ca_bundle- Einstellung für gemeinsam genutzte AWS config Dateien
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 das Setzen dieses Werts in der config Datei:

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

Aufgrund 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 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- gemeinsame AWS config Dateieinstellung

Gibt an, wie Ergebnisse in den AWS CLI und anderen AWS SDKs und Tools formatiert werden.

Standardwert: json

Zulässige Werte:

  • json – Die Ausgabe erfolgt im JSON-Format.

  • yaml –Die Ausgabe erfolgt im YAML-Format.

  • 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 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- Einstellung für gemeinsam genutzte Dateien AWS config

Gibt an, ob das SDK oder Tool versucht, Befehlszeilenparameter zu überprüfen, bevor sie an den AWS Service-Endpunkt gesendet werden.

Standardwert: true

Zulä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