Konfiguration von Service-Clients im AWS SDK for Ruby - AWS SDK for Ruby
Vorrang der Einstellungen

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.

Konfiguration von Service-Clients im AWS SDK for Ruby

Für den programmgesteuerten Zugriff AWS-Services verwendet das AWS SDK for Ruby jeweils eine Client-Klasse. AWS-Service Wenn Ihre Anwendung beispielsweise auf Amazon zugreifen muss EC2, erstellt Ihre Anwendung ein EC2 Amazon-Client-Objekt als Schnittstelle zu diesem Service. Anschließend verwenden Sie den Service-Client, um Anfragen an dieses zu stellen AWS-Service.

Um eine Anfrage an einen zu stellen AWS-Service, müssen Sie zunächst einen Service-Client erstellen. Für jeden Code, den AWS-Service Sie verwenden, gibt es ein eigenes Gem und einen eigenen Typ, mit dem Sie interagieren können. Der Client stellt für jeden API-Vorgang, der vom Dienst verfügbar gemacht wird, eine Methode zur Verfügung.

Es gibt viele alternative Möglichkeiten, das SDK-Verhalten zu konfigurieren, aber letztendlich hat alles mit dem Verhalten von Service-Clients zu tun. Jede Konfiguration hat keine Wirkung, bis ein aus ihnen erstellter Service-Client verwendet wird.

Sie müssen festlegen, wie sich Ihr Code authentifiziert AWS , wenn Sie mit AWS-Services entwickeln. Sie müssen auch festlegen, was AWS-Region Sie verwenden möchten.

Das AWS SDKs Referenzhandbuch zu Tools enthält außerdem Einstellungen, Funktionen und andere grundlegende Konzepte, die in vielen der AWS SDKs Tools üblich sind.

Themen

Die Dateien „Gemeinsam genutzt“ config und „credentialsDateien“ können für Konfigurationseinstellungen verwendet werden. Alle AWS SDK-Einstellungen finden Sie in der Einstellungsreferenz im Referenzhandbuch AWS SDKs und im Tools-Referenzhandbuch.

Verschiedene Profile können zum Speichern verschiedener Konfigurationen verwendet werden. Um das aktive Profil anzugeben, das das SDK lädt, können Sie die AWS_PROFILE Umgebungsvariable oder die profile Option von verwendenAws.config.

Vorrang der Einstellungen

In globalen Einstellungen werden Funktionen, Anbieter von Anmeldeinformationen und andere Funktionen konfiguriert, die von den meisten unterstützt werden SDKs und weitreichende Auswirkungen auf alle haben. AWS-Services Alle AWS SDKs haben eine Reihe von Orten (oder Quellen), die sie überprüfen, um einen Wert für globale Einstellungen zu finden. Nicht alle Einstellungen sind in allen Quellen verfügbar. Im Folgenden finden Sie die Einstellung „Priorität bei der Suche“:

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

    1. Alle Parameter, die direkt an einen Client-Konstruktor übergeben werden, haben höchste Priorität.

    2. Aws.configwird auf globale oder dienstspezifische Einstellungen überprüft.

  2. Die Umgebungsvariable wird geprüft.

  3. Die gemeinsam genutzte AWS credentials Datei wird überprüft.

  4. Die gemeinsam genutzte AWS config Datei ist geprüft.

  5. Jeder Standardwert, der vom AWS SDK für den Ruby-Quellcode selbst bereitgestellt wird, wird zuletzt verwendet.