Verwenden Sie Endpunkte in der AWS CLI - AWS Command Line Interface
Festlegen eines Endpunkts für einen einzelnen BefehlLegen Sie den globalen Endpunkt für alle fest 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 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 Sie Endpunkte in der AWS CLI

Um programmgesteuert eine Verbindung zu einem herzustellen AWS-Service, verwenden Sie einen Endpunkt. Ein Endpunkt ist die URL des Einstiegspunkts 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 eine benutzerdefinierte Endpunkt-URL von Amazon S3.

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

Legen Sie den globalen Endpunkt für alle fest 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 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 FIPS unterstützt, gibt diese Einstellung an, welchen FIPS-Endpunkt verwendet werden soll. AWS CLI 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 Dienst in Ihrem vorhanden ist AWS-Region, 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 finden Sie unter FIPS-Endpunkte nach AWS-Region 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:

  • 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 Anfragen. AWS 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 für 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 existiert AWS-Region, 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 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 Dienst verwendet wird. Dieser <SERVICE> wird durch den Bezeichner ersetzt. AWS-Service 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 Umgebungsvariablen zur Konfiguration der 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

Der AWS-Service Bezeichner basiert auf dem API-Modell, serviceId indem alle Leerzeichen 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:

  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. Der servicespezifische Endpunktwert, der durch die Einstellung endpoint_url in einem services-Abschnitt der freigegebenen config-Datei bereitgestellt wird

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

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

  8. Jede Standard-Endpunkt-URL für den jeweiligen Endpunkt 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.