Externes Konfigurieren des AWS SDK for Ruby Ruby-Serviceclients - AWS SDK for Ruby
AWS SDK for Ruby Ruby-Umgebungsvariablen

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.

Externes Konfigurieren des AWS SDK for Ruby Ruby-Serviceclients

Viele Konfigurationseinstellungen können außerhalb Ihres Codes bearbeitet werden. Wenn die Konfiguration extern vorgenommen wird, wird die Konfiguration auf alle Ihre Anwendungen angewendet. Die meisten Konfigurationseinstellungen können entweder als Umgebungsvariablen oder in einer separaten gemeinsam genutzten AWS config Datei festgelegt werden. Die gemeinsam genutzte config Datei kann separate Einstellungssätze, sogenannte Profile, enthalten, um unterschiedliche Konfigurationen für verschiedene Umgebungen oder Tests bereitzustellen.

Umgebungsvariablen und gemeinsam genutzte config Dateieinstellungen sind standardisiert und werden von allen AWS SDKs Tools gemeinsam genutzt, um konsistente Funktionen in verschiedenen Programmiersprachen und Anwendungen zu unterstützen.

Weitere Informationen zur Konfiguration Ihrer Anwendung mit diesen Methoden AWS SDKs sowie Einzelheiten zu den einzelnen SDK-übergreifenden Einstellungen finden Sie im Referenzhandbuch und im Tools-Referenzhandbuch. Alle Einstellungen, die das SDK anhand der Umgebungsvariablen oder Konfigurationsdateien auflösen kann, finden Sie in der Referenz zu Einstellungen im Referenzhandbuch AWS SDKs und im Tools-Referenzhandbuch.

Um eine Anfrage an zu stellen AWS-Service, instanziieren Sie zunächst einen Client für diesen Dienst. Sie können allgemeine Einstellungen für Service-Clients wie Timeouts und den HTTP-Client konfigurieren und die Konfiguration erneut versuchen.

Jeder Dienstclient benötigt einen Anmeldeinformationsanbieter AWS-Region und einen Anmeldeinformationsanbieter. Das SDK verwendet diese Werte, um Anfragen an die richtige Region für Ihre Ressourcen zu senden und Anfragen mit den richtigen Anmeldeinformationen zu signieren. Sie können diese Werte programmgesteuert im Code angeben oder sie automatisch aus der Umgebung laden lassen.

Das SDK verfügt über eine Reihe von Stellen (oder Quellen), die überprüft werden, um einen Wert für Konfigurationseinstellungen zu finden.

  1. Jede explizite Einstellung, die im Code oder auf einem Service-Client selbst festgelegt ist, hat Vorrang vor allen anderen Einstellungen.

  2. Umgebungsvariablen

    • Einzelheiten zum Setzen von Umgebungsvariablen finden Sie unter Umgebungsvariablen im Referenzhandbuch AWS SDKs und im Tools-Referenzhandbuch.

    • Beachten Sie, dass Sie Umgebungsvariablen für eine Shell auf verschiedenen Gültigkeitsebenen konfigurieren können: systemweit, benutzerweit und für eine bestimmte Terminalsitzung.

  3. Geteilte Dateien und Dateien config credentials

  4. Jeder vom SDK-Quellcode selbst bereitgestellte Standardwert wird zuletzt verwendet.

    • Für einige Eigenschaften, z. B. Region, gibt es keine Standardeinstellung. Sie müssen sie entweder explizit im Code, in einer Umgebungseinstellung oder in der gemeinsam genutzten config Datei angeben. Wenn das SDK die erforderliche Konfiguration nicht auflösen kann, können API-Anfragen zur Laufzeit fehlschlagen.

AWS SDK for Ruby Ruby-Umgebungsvariablen

Neben den SDK-übergreifenden Umgebungsvariablen, die von den meisten unterstützt werden AWS SDKs, unterstützt das AWS SDK for Ruby einige einzigartige Variablen:

AWS_SDK_CONFIG_OPT_OUT

Wenn die Umgebungsvariable AWS SDK for Ruby gesetzt AWS_SDK_CONFIG_OPT_OUT ist, wird die gemeinsam genutzte AWS config Datei ~/.aws/config, normalerweise at, für keine Konfigurationswerte verwendet.

AMAZON_REGION

Eine alternative Umgebungsvariable AWS_REGION zur Einstellung von AWS-Region. Dieser Wert wird nur geprüft, wenn AWS_REGION er nicht verwendet wird.