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.

Verwenden von Endpunkten in der AWS CLI

Um programmgesteuert eine Verbindung zu einem herzustellen AWS-Service, verwenden Sie einen Endpunkt. Ein Endpunkt ist URL der Einstiegspunkt für einen AWS Webdienst. Die AWS Command Line Interface (AWS CLI) verwendet automatisch den Standardendpunkt für jeden Dienst in einem AWS-Region, aber Sie können einen alternativen Endpunkt für Ihre API Anfragen angeben.

Festlegen eines Endpunkts für einen einzelnen Befehl

Verwenden Sie die Befehlszeilenoption --endpoint-url, um Endpunkteinstellungen oder Umgebungsvariablen für einen einzelnen Befehl zu überschreiben. Das folgende Befehlsbeispiel verwendet einen benutzerdefinierten Amazon S3 S3-EndpunktURL.

$ aws s3 ls --endpoint-url http://localhost:4567

Legen Sie den globalen Endpunkt für alle fest AWS-Services

Verwenden Sie eine der folgenden EinstellungenURL, um Anfragen für alle Dienste an einen benutzerdefinierten Endpunkt weiterzuleiten:

Servicespezifische Endpunkte und die Befehlszeilenoption --endpoint-url haben Vorrang vor allen globalen Endpunkten.

Stellen Sie ein, dass FIPs Endpunkte für alle verwendet werden AWS-Services

Verwenden Sie eine der folgenden Methoden, um Anfragen für alle Dienste zur Verwendung von FIPs Endpunkten weiterzuleiten:

Einige AWS Dienste bieten Endgeräte, die in einigen Fällen den Federal Information Processing Standard (FIPS) 140-2 unterstützen. AWS-Regionen Wenn der AWS Dienst dies unterstütztFIPS, gibt diese Einstellung an, welcher FIPS Endpunkt verwendet werden soll. AWS CLI Im Gegensatz zu AWS Standardendpunkten verwenden FIPS Endpunkte eine TLS Softwarebibliothek, die 140-2 entsprichtFIPS. Diese Endpunkte können von Unternehmen erfordert werden, die mit der US-Regierung interagieren.

Wenn diese Einstellung aktiviert ist, aber kein FIPS Endpunkt für den Dienst in Ihrem vorhanden ist AWS-Region, schlägt der Befehl möglicherweise fehl. AWS Geben Sie in diesem Fall mithilfe der --endpoint-url-Option manuell den Endpunkt an, der im Befehl verwendet werden soll, oder verwenden Sie servicespezifische Endpunkte.

Weitere Informationen zur Angabe von FIPS Endpunkten nach finden Sie AWS-Region unter FIPSEndpunkte nach Dienst.

So einstellen, dass Dual-Stack-Endpunkte für alle AWS-Services verwendet werden

Verwenden Sie eine der folgenden Einstellungen, um Anforderungen für alle Services so weiterzuleiten, dass Dual-Stack-Endpunkte verwendet werden:

Ermöglicht die Verwendung von Dual-Stack-Endpunkten zum Senden von Anfragen. AWS Weitere Informationen zu Dual-Stack-Endpunkten, die IPv4 sowohl IPv6 Datenverkehr als auch unterstützen, finden Sie unter Verwenden von Amazon S3 S3-Dual-Stack-Endpunkten im Amazon Simple Storage Service-Benutzerhandbuch. Dual-Stack-Endpunkte sind für einige Services in einigen Regionen verfügbar. Wenn kein Dual-Stack-Endpunkt für den Service oder AWS-Region existiert, schlägt die Anfrage fehl. Diese ist standardmäßig deaktiviert.

Festlegen servicespezifischer Endpunkte

Die dienstspezifische Endpunktkonfiguration bietet die Option, einen persistenten Endpunkt Ihrer Wahl für AWS CLI Anfragen zu verwenden. Diese Einstellungen bieten Flexibilität bei der Unterstützung lokaler Endpunkte, VPC Endpunkte und lokaler AWS Entwicklungsumgebungen von Drittanbietern. Verschiedene Endpunkte können für Test- und Produktionsumgebungen verwendet werden. Sie können einen Endpunkt URL für eine einzelne Person angeben. AWS-Services

Servicespezifische Endpunkte können wie folgt festgelegt werden:

Servicespezifische Endpunkte: Umgebungsvariablen

Umgebungsvariablen überschreiben die Einstellungen in Ihrer Konfigurationsdatei, aber nicht die in der Befehlszeile angegebenen Optionen. Verwenden Sie Umgebungsvariablen, wenn Sie möchten, dass alle Profile dieselben Endpunkte auf Ihrem Gerät verwenden.

Die folgenden Umgebungsvariablen sind servicespezifisch:

Weitere Informationen zum Festlegen von Umgebungsvariablen finden Sie unter Konfiguration von Umgebungsvariablen für AWS CLI.

Servicespezifische Endpunkte: freigegebene config-Datei

In der freigegebenen config-Datei wird endpoint_url in mehreren Abschnitten verwendet. Wenn Sie einen servicespezifischen Endpunkt festlegen möchten, verwenden Sie die Einstellung endpoint_url, die unter einem Service-ID-Schlüssel innerhalb eines services-Abschnitts verschachtelt ist. Details zur Definition eines services-Abschnitts in Ihrer freigegebenen config-Datei finden Sie unter Abschnittstyp: services.

Das folgende Beispiel verwendet einen services Abschnitt zur Konfiguration eines dienstspezifischen Endpunkts URL für Amazon S3 und eines benutzerdefinierten globalen Endpunkts, der für alle anderen Dienste verwendet wird:

[profile dev1]
endpoint_url = http://localhost:1234
services = s3-specific

[services testing-s3]
s3 = 
  endpoint_url = http://localhost:4567

Mit einem einzigen Profil können Endpunkte für mehrere Services konfiguriert werden. Im folgenden Beispiel wird der dienstspezifische Endpunkt URLs für Amazon S3 und AWS Elastic Beanstalk im selben Profil festgelegt.

Eine Liste aller Service-ID-Schlüssel, die im services-Abschnitt verwendet werden können, finden Sie unter Liste der servicespezifischen Kennungen.

[profile dev1]
services = testing-s3-and-eb

[services testing-s3-and-eb]
s3 = 
  endpoint_url = http://localhost:4567
elastic_beanstalk = 
  endpoint_url = http://localhost:8000

Der Abschnitt zur Servicekonfiguration kann in mehreren Profilen verwendet werden. Im folgenden Beispiel verwenden zwei Profile dieselbe services-Definition:

[profile dev1]
output = json
services = testing-s3

[profile dev2]
output = text
services = testing-s3

[services testing-s3]
s3 = 
  endpoint_url = https://localhost:4567

Servicespezifische Endpunkte: Liste servicespezifischer Kennungen

Der AWS-Service Bezeichner basiert auf dem API Modell, indem alle Leerzeichen serviceId durch Unterstriche ersetzt und alle Buchstaben klein geschrieben werden.

Das folgende Beispiel für eine Service-ID verwendet. AWS Elastic Beanstalk AWS Elastic Beanstalk hat einen Wert serviceId vonElastic Beanstalk, daher lautet der Service-Identifier-Schlüsselelastic_beanstalk.

In der folgenden Tabelle sind alle servicespezifischen Kennungen, config-Dateischlüssel und Umgebungsvariablen aufgeführt.

Priorität der Endpunktkonfiguration und der Einstellungen

Die Einstellungen für die Endpunktkonfiguration befinden sich an mehreren Stellen, z. B. in den System- oder Benutzerumgebungsvariablen, in lokalen AWS Konfigurationsdateien oder werden explizit in der Befehlszeile als Parameter deklariert. Die AWS CLI -Endpunktkonfigurationseinstellungen haben Vorrang in der folgenden Reihenfolge: