Verwenden von Endpunkten in der AWS CLI - AWS Command Line Interface
Festlegen eines Endpunkts für einen einzelnen BefehlFestlegen des globalen Endpunkts für alle AWS-ServicesSo einstellen, dass FIPs-Endpunkte für alle AWS-Services verwendet werdenSo einstellen, dass Dual-Stack-Endpunkte für alle AWS-Services verwendet werdenFestlegen servicespezifischer EndpunkteKontobasierte EndpunktePriorität der Endpunktkonfiguration und der Einstellungen

Diese Dokumentation bezieht sich AWS CLI nur auf Version 1 von. Dokumentation zu Version 2 von finden Sie im Benutzerhandbuch für Version 2. AWS CLI

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 AWS-Service herzustellen, verwenden Sie einen Endpunkt. Ein Endpunkt ist die URL des Eintrittspunkts für einen AWS-Web-Service. Die AWS Command Line Interface (AWS CLI) verwendet automatisch den Standardendpunkt für jeden Service in einer AWS-Region. Sie können jedoch einen alternativen Endpunkt für Ihre API-Anforderungen 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 eine benutzerdefinierte Endpunkt-URL von Amazon S3.

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

Festlegen des globalen Endpunkts für alle AWS-Services

Verwenden Sie eine der folgenden Einstellungen, um Anforderungen für alle Services an eine benutzerdefinierte Endpunkt-URL weiterzuleiten:

  • Umgebungsvariablen:

    • AWS_IGNORE_CONFIGURED_ENDPOINT_URLS – Ignorieren Sie konfigurierte Endpunkt-URLs.

      Linux or macOS
      $ export AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true
      Windows Command Prompt

      Einrichten für alle Sitzungen

      C:\> setx AWS_IGNORE_CONFIGURED_ENDPOINT_URLS true

      Einrichten nur für die aktuelle Sitzung

      C:\> set AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true
      PowerShell
      PS C:\> $Env:AWS_IGNORE_CONFIGURED_ENDPOINT_URLS="true"

    • AWS_ENDPOINT_URL – Legen Sie eine globale Endpunkt-URL fest.

      Linux or macOS
      $ export AWS_ENDPOINT_URL=http://localhost:4567
      Windows Command Prompt

      Einrichten für alle Sitzungen

      C:\> setx AWS_ENDPOINT_URL http://localhost:4567

      Einrichten nur für die aktuelle Sitzung

      C:\> set AWS_ENDPOINT_URL=http://localhost:4567
      PowerShell
      PS C:\> $Env:AWS_ENDPOINT_URL="http://localhost:4567"

  • Die Datei config:

    • ignore_configure_endpoint_urls – Ignorieren Sie konfigurierte Endpunkt-URLs.

      ignore_configure_endpoint_urls = true

    • endpoint_url – Legen Sie eine globale Endpunkt-URL fest.

      endpoint_url = http://localhost:4567

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

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

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

  • AWS_USE_FIPS_ENDPOINT-Umgebungsvariable.

    Linux or macOS
    $ export AWS_USE_FIPS_ENDPOINT=true
    Windows Command Prompt

    Einrichten für alle Sitzungen

    C:\> setx AWS_USE_FIPS_ENDPOINT true

    Einrichten nur für die aktuelle Sitzung

    C:\> set AWS_USE_FIPS_ENDPOINT=true
    PowerShell
    PS C:\> $Env:AWS_USE_FIPS_ENDPOINT="true"

  • use_fips_endpoint-Dateieinstellung.

    use_fips_endpoint = true

Einige AWS-Services bieten Endpunkte, die Federal Information Processing Standard (FIPS) 140-2 in einigen AWS-Regionenunterstützen. Wenn der AWS-Service FIPS unterstützt, gibt diese Einstellung an, welchen FIPS-Endpunkt die AWS CLI verwenden soll. Im Gegensatz zu Standard-AWS-Endpunkten verwenden FIPS-Endpunkte eine TLS-Softwarebibliothek, die den Standard FIPS 140-2 erfüllt. 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 Service in Ihrer AWS-Region vorhanden ist, schlägt der AWS-Befehl möglicherweise fehl. 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 AWS-Region finden Sie unter FIPS-Endpunkte nach Service.

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:

  • AWS_USE_DUALSTACK_ENDPOINT-Umgebungsvariable.

    Linux or macOS
    $ export AWS_USE_DUALSTACK_ENDPOINT=true
    Windows Command Prompt

    Einrichten für alle Sitzungen

    C:\> setx AWS_USE_DUALSTACK_ENDPOINT true

    Einrichten nur für die aktuelle Sitzung

    C:\> set AWS_USE_DUALSTACK_ENDPOINT=true
    PowerShell
    PS C:\> $Env:AWS_USE_DUALSTACK_ENDPOINT="true"

  • use_dualstack_endpoint-Dateieinstellung.

    use_dualstack_endpoint = true

Ermöglicht die Verwendung von Dual-Stack-Endpunkten zum Senden von AWS-Anfragen. Weitere Informationen zu Dual-Stack-Endpunkten, die sowohl IPv4- als auch IPv6-Datenverkehr unterstützen, finden Sie unter Verwenden von Amazon-S3-Dual-Stack-Endpunkten im Benutzerhandbuch zu Amazon Simple Storage Service. 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 vorhanden ist, schlägt die Anfrage fehl. Diese ist standardmäßig deaktiviert.

Festlegen servicespezifischer Endpunkte

Die servicespezifische Endpunktkonfiguration bietet die Möglichkeit, einen persistenten Endpunkt Ihrer Wahl für AWS CLI-Anforderungen 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 eine Endpunkt-URL für einzelne AWS-Services angeben.

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:

  • AWS_IGNORE_CONFIGURED_ENDPOINT_URLS – Ignoriert alle konfigurierten Endpunkt-URLs, sofern sie nicht in der Befehlszeile angegeben wurden.

    Linux or macOS
    $ export AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true
    Windows Command Prompt

    Einrichten für alle Sitzungen

    C:\> setx AWS_IGNORE_CONFIGURED_ENDPOINT_URLS true

    Einrichten nur für die aktuelle Sitzung

    C:\> set AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true
    PowerShell
    PS C:\> $Env:AWS_IGNORE_CONFIGURED_ENDPOINT_URLS="true"

  • AWS_ENDPOINT_URL_<SERVICE> – Gibt einen benutzerdefinierten Endpunkt an, der für einen bestimmten Service verwendet wird, wobei <SERVICE> durch die AWS-Service-Kennung ersetzt wird. Informationen zu allen servicespezifischen Variablen finden Sie unter Servicespezifische Endpunkte: Liste servicespezifischer Kennungen.

    In den folgenden Beispielen für Umgebungsvariablen wird ein Endpunkt für AWS Elastic Beanstalk festgelegt:

    Linux or macOS
    $ export AWS_ENDPOINT_URL_ELASTIC_BEANSTALK=http://localhost:4567
    Windows Command Prompt

    Einrichten für alle Sitzungen

    C:\> setx AWS_ENDPOINT_URL_ELASTIC_BEANSTALK http://localhost:4567

    Einrichten nur für die aktuelle Sitzung

    C:\> set AWS_ENDPOINT_URL_ELASTIC_BEANSTALK=http://localhost:4567
    PowerShell
    PS C:\> $Env:AWS_ENDPOINT_URL_ELASTIC_BEANSTALK="http://localhost:4567"

Weitere Informationen zum Festlegen von Umgebungsvariablen finden Sie unter Konfigurieren von Umgebungsvariablen für die 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 einer servicespezifischen Endpunkt-URL für Amazon S3 und eines benutzerdefinierten globalen Endpunkts, der für alle anderen Services 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 werden die servicespezifischen Endpunkt-URLs für Amazon S3 und AWS Elastic Beanstalk in demselben 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

Die AWS-Service-Kennung basiert auf der serviceId des API-Modells, indem alle Leerzeichen durch Unterstriche ersetzt und alle Buchstaben klein geschrieben werden.

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

Kontobasierte Endpunkte

Kontobasierte Endpunkte können wie folgt festgelegt werden:

  • Umgebungsvariablen

    • AWS_ACCOUNT_ID – Gibt die AWS-kontobasierte Endpunkt-ID an, die für Anrufe an unterstützte AWS-Services verwendet werden soll.

      Linux or macOS
      $ export AWS_ACCOUNT_ID=<account-id>
      Windows Command Prompt

      Einrichten für alle Sitzungen

      C:\> setx AWS_ACCOUNT_ID <account-id>

      Einrichten nur für die aktuelle Sitzung

      C:\> set AWS_ACCOUNT_ID=<account-id>
      PowerShell
      PS C:\> $Env:AWS_ACCOUNT_ID="<account-id>"

    • AWS_ACCOUNT_ID_ENDPOINT_MODE – Gibt an, ob AWS-kontobasierte Endpunkt-IDs für Anrufe an unterstützte AWS-Services verwendet werden sollen. Mögliche Einstellungen sind preferred, disabled oder required. Der Standardwert ist preferred.

      Linux or macOS
      $ export AWS_ACCOUNT_ID_ENDPOINT_MODE=preferred
      Windows Command Prompt

      Einrichten für alle Sitzungen

      C:\> setx AWS_ACCOUNT_ID_ENDPOINT_MODE preferred

      Einrichten nur für die aktuelle Sitzung

      C:\> set AWS_ACCOUNT_ID_ENDPOINT_MODE=preferred
      PowerShell
      PS C:\> $Env:AWS_ACCOUNT_ID_ENDPOINT_MODE="preferred"

  • Die Datei config:

    • aws_account_id – Gibt die AWS-kontobasierte Endpunkt-ID an, die für Anrufe an unterstützte AWS-Services verwendet werden soll. 

      aws_account_id = <account-id>

    • account_id_endpoint_mode – Gibt an, ob AWS-kontobasierte Endpunkt-IDs für Anrufe an unterstützte AWS-Services verwendet werden sollen. Mögliche Einstellungen sind preferred, disabled oder required. Der Standardwert ist preferred.

      account_id_endpoint_mode = preferred

Kontobasierte Endpunkte sorgen für hohe Leistung und Skalierbarkeit, indem sie mithilfe Ihrer AWS-Konto-ID die Weiterleitung von AWS-Service-Anforderungen für Services optimieren, die diese Funktion unterstützen. Wenn Sie einen Anbieter für Anmeldeinformationen und einen Service verwenden, der kontobasierte Endpunkte unterstützt, erstellt und verwendet die AWS CLI automatisch einen kontobasierten Endpunkt anstelle eines regionalen Endpunkts.

Kontobasierte Endpunkte verwenden das folgende Format, wobei <account-id> durch Ihre AWS-Konto-ID und <region> durch Ihre AWS-Region ersetzt werden:

https://<account-id>.myservice.<region>.amazonaws.com

Standardmäßig ist der kontobasierte Endpunktmodus in der AWS CLI auf preferred eingestellt.

Priorität der Endpunktkonfiguration und der Einstellungen

Endpunktkonfigurationseinstellungen befinden sich an mehreren Stellen, z. B. System- oder Benutzerumgebungsvariablen, lokale AWS-Konfigurationsdateien, oder werden in der Befehlszeile als Parameter explizit deklariert. Die AWS CLI-Endpunktkonfigurationseinstellungen haben Vorrang in der folgenden Reihenfolge:

  1. Die Befehlszeilenoption --endpoint-url

  2. Bei aktivierter Option die globale Endpunkt-Umgebungsvariable AWS_IGNORE_CONFIGURED_ENDPOINT_URLS oder die Profileinstellung ignore_configure_endpoint_urls zum Ignorieren von benutzerdefinierten Endpunkten

  3. Der Wert, der von einer servicespezifischen Umgebungsvariablen AWS_ENDPOINT_URL_<SERVICE> bereitgestellt wird, z. B. AWS_ENDPOINT_URL_DYNAMODB

  4. Die von den AWS_USE_DUALSTACK_ENDPOINT-, AWS_USE_FIPS_ENDPOINT- und AWS_ENDPOINT_URL-Umgebungsvariablen bereitgestellten Werte.

  5. Die AWS_ACCOUNT_ID_ENDPOINT_MODE-Umgebungsvariable ist auf required oder preferred festgelegt, wobei die Konto-ID in der AWS_ACCOUNT_ID-Umgebungsvariable oder der aws_account_id-Einstellung verwendet wird.

  6. Der servicespezifische Endpunktwert, der durch die Einstellung endpoint_url in einem services-Abschnitt der freigegebenen config-Datei bereitgestellt wird

  7. Der Wert, der durch die Einstellung endpoint_url in einem profile der freigegebenen config-Datei bereitgestellt wird

  8. use_dualstack_endpoint-, use_fips_endpoint- und endpoint_url-Einstellungen.

  9. Die account_id_endpoint_mode-Einstellung ist auf required oder preferred festgelegt, wobei die Konto-ID in der AWS_ACCOUNT_ID-Umgebungsvariable oder der aws_account_id-Einstellung verwendet wird.

  10. Eine Standard-Endpunkt-URL für den jeweiligen AWS-Service wird zuletzt verwendet. Eine Liste der Standard-Service-Endpunkte, die in den einzelnen Regionen verfügbar sind, finden Sie unter AWS-Regionen und -Endpunkte im Allgemeine Amazon Web Services-Referenz.