**Diese Dokumentation bezieht sich AWS CLI nur auf Version 1 von.** Wir haben die end-of-support bevorstehende AWS CLI Version 1 angekündigt. Wir empfehlen Ihnen, auf die AWS CLI Version 2 zu migrieren. Termine, zusätzliche Details und Informationen zur Migration finden Sie in der [Ankündigung](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/). Dokumentation zu Version 2 von finden Sie im [Benutzerhandbuch für Version 2. AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) 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 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. **Contents** + [Festlegen eines Endpunkts für einen einzelnen Befehl](#endpoints-command) + [Legen Sie den globalen Endpunkt für alle fest AWS-Services](#endpoints-global) + [So eingestellt, dass FIPs Endpunkte für alle verwendet werden AWS-Services](#endpoints-fips) + [Stellen Sie ein, dass Dual-Stack-Endpunkte für alle verwendet werden AWS-Services](#endpoints-dual-stack) + [Festlegen servicespezifischer Endpunkte](#endpoints-service-specific) + [Umgebungsvariablen](#endpoints-service-specific-envvars) + [Freigegebene `config`-Datei](#endpoints-service-specific-config) + [Liste der servicespezifischen Kennungen](#endpoints-service-specific-table) + [Kontobasierte Endpunkte](#endpoints-accountid) + [Priorität der Endpunktkonfiguration und der Einstellungen](#endpoints-precedence) ## 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\$1IGNORE\$1CONFIGURED\$1ENDPOINT\$1URLS`- Ignoriere den konfigurierten 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\$1ENDPOINT\$1URL` – 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\$1configure\$1endpoint\$1urls`- Ignoriert den konfigurierten Endpunkt URLs. ``` ignore_configure_endpoint_urls = true ``` + `endpoint\$1url` – 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 eingestellt, 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: + `AWS\$1USE\$1FIPS\$1ENDPOINT`-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\$1fips\$1endpoint`-Dateieinstellung. ``` use_fips_endpoint = true ``` Einige AWS Dienste bieten Endgeräte, die in einigen Fällen den [Federal Information Processing Standard (FIPS) 140-2](https://aws.amazon.com/compliance/fips/) 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](#endpoints-service-specific). Weitere Informationen zur Angabe von FIPS-Endpunkten durch finden Sie unter [FIPS-Endpunkte](https://aws.amazon.com/compliance/fips/) nach AWS-Region Dienst. ## Stellen Sie ein, dass Dual-Stack-Endpunkte für alle verwendet werden AWS-Services Verwenden Sie eine der folgenden Einstellungen, um Anforderungen für alle Services so weiterzuleiten, dass Dual-Stack-Endpunkte verwendet werden: + `AWS\$1USE\$1DUALSTACK\$1ENDPOINT`-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\$1dualstack\$1endpoint`-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 IPv4 sowohl IPv6 Datenverkehr als auch unterstützen, finden Sie unter [Verwenden von Amazon S3 S3-Dual-Stack-Endpunkten](https://docs.aws.amazon.com/AmazonS3/latest/userguide/dual-stack-endpoints.html) 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 Möglichkeit, 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: + Mit der Befehlszeilenoption `--endpoint-url` für einen einzelnen Befehl. + Umgebungsvariablen: + `AWS\$1IGNORE\$1CONFIGURED\$1ENDPOINT\$1URLS`- Ignoriert alle konfigurierten Endpunkte URLs, sofern sie nicht in der Befehlszeile angegeben wurden. + `AWS\$1ENDPOINT\$1URL\$1` – Gibt einen benutzerdefinierten Endpunkt an, der für einen bestimmten Service verwendet wird, wobei `` durch die AWS-Service -Kennung ersetzt wird. Informationen zu allen servicespezifischen Variablen finden Sie unter [Servicespezifische Endpunkte: Liste servicespezifischer Kennungen](#endpoints-service-specific-table). + `config`-Datei: + `ignore\$1configure\$1endpoint\$1urls`- Ignoriert alle konfigurierten Endpunkte URLs, sofern sie nicht mithilfe von Umgebungsvariablen oder in der Befehlszeile angegeben wurden. + Der Abschnitt [`services`](cli-configure-files.md#cli-configure-files-format-services) der `config`-Datei in Kombination mit der Dateieinstellung `endpoint\$1url`. **Topics** + [Umgebungsvariablen](#endpoints-service-specific-envvars) + [Freigegebene `config`-Datei](#endpoints-service-specific-config) + [Liste der servicespezifischen Kennungen](#endpoints-service-specific-table) ### 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\$1IGNORE\$1CONFIGURED\$1ENDPOINT\$1URLS`- Ignoriert alle konfigurierten Endpunkte 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\$1ENDPOINT\$1URL\$1`- Gibt einen benutzerdefinierten Endpunkt an, der für einen bestimmten Dienst verwendet `` wird, wobei dieser durch den AWS-Service Bezeichner ersetzt wird. Informationen zu allen servicespezifischen Variablen finden Sie unter [Servicespezifische Endpunkte: Liste servicespezifischer Kennungen](#endpoints-service-specific-table). 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 [Konfiguration von Umgebungsvariablen für AWS CLI](cli-configure-envvars.md). ### 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`](cli-configure-files.md#cli-configure-files-format-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 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](#endpoints-service-specific-table). ``` [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. 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\$1ACCOUNT\$1ID` – Gibt die AWS -kontobasierte Endpunkt-ID an, die für Aufrufe an unterstützte AWS-Services verwendet werden soll. ------ #### [ Linux or macOS ] ``` $ export AWS_ACCOUNT_ID= ``` ------ #### [ Windows Command Prompt ] **Einrichten für alle Sitzungen** ``` C:\> setx AWS_ACCOUNT_ID ``` **Einrichten nur für die aktuelle Sitzung** ``` C:\> set AWS_ACCOUNT_ID= ``` ------ #### [ PowerShell ] ``` PS C:\> $Env:AWS_ACCOUNT_ID="" ``` ------ + `AWS\$1ACCOUNT\$1ID\$1ENDPOINT\$1MODE`— Gibt an, ob ein AWS kontobasierter Endpunkt IDs für Anrufe an den Support verwendet werden soll. AWS-Services 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\$1account\$1id`- Gibt die AWS kontobasierte Endpunkt-ID an, die für Anrufe an den Support verwendet werden soll. AWS-Services ``` aws_account_id = ``` + `account\$1id\$1endpoint\$1mode`- Gibt an, ob der AWS kontobasierte Endpunkt IDs für Anrufe an den Support verwendet werden soll. AWS-Services 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 Anfragen für Dienste, die diese Funktion unterstützen, optimieren. Wenn Sie einen Anbieter für Anmeldeinformationen und einen Dienst verwenden, der kontobasierte Endpunkte unterstützt, erstellt und verwendet dieser AWS CLI automatisch einen kontobasierten Endpunkt anstelle eines regionalen Endpunkts. Kontobasierte Endpunkte verwenden das folgende Format, wobei es durch Ihre Konto-ID und durch Ihre ersetzt `` wird: AWS `` AWS-Region ``` https://.myservice..amazonaws.com ``` Standardmäßig ist der AWS CLI kontobasierte Endpunktmodus auf eingestellt. `preferred` ## 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 sie werden explizit in der Befehlszeile als Parameter deklariert. Die Einstellungen für die AWS CLI Endpunktkonfiguration haben in der folgenden Reihenfolge Vorrang: 1. Die Befehlszeilenoption `--endpoint-url` 1. Bei aktivierter Option die globale Endpunkt-Umgebungsvariable `AWS\$1IGNORE\$1CONFIGURED\$1ENDPOINT\$1URLS` oder die Profileinstellung `ignore\$1configure\$1endpoint\$1urls` zum Ignorieren von benutzerdefinierten Endpunkten 1. Der Wert, der von einer servicespezifischen Umgebungsvariablen `AWS\$1ENDPOINT\$1URL\$1` bereitgestellt wird, z. B. `AWS_ENDPOINT_URL_DYNAMODB` 1. Die von den `AWS\$1USE\$1DUALSTACK\$1ENDPOINT`-, `AWS\$1USE\$1FIPS\$1ENDPOINT`- und `AWS\$1ENDPOINT\$1URL`-Umgebungsvariablen bereitgestellten Werte. 1. Die `AWS\$1ACCOUNT\$1ID\$1ENDPOINT\$1MODE`-Umgebungsvariable ist auf `required` oder `preferred` festgelegt, wobei die Konto-ID in der `AWS\$1ACCOUNT\$1ID`-Umgebungsvariable oder der `aws\$1account\$1id`-Einstellung verwendet wird. 1. Der servicespezifische Endpunktwert, der durch die Einstellung `endpoint\$1url` in einem `services`-Abschnitt der freigegebenen `config`-Datei bereitgestellt wird 1. Der Wert, der durch die Einstellung `endpoint\$1url` in einem `profile` der freigegebenen `config`-Datei bereitgestellt wird 1. `use\$1dualstack\$1endpoint`-, `use\$1fips\$1endpoint`- und `endpoint\$1url`-Einstellungen. 1. Die `account\$1id\$1endpoint\$1mode`-Einstellung ist auf `required` oder `preferred` festgelegt, wobei die Konto-ID in der `AWS\$1ACCOUNT\$1ID`-Umgebungsvariable oder der `aws\$1account\$1id`-Einstellung verwendet wird. 1. 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](https://docs.aws.amazon.com/general/latest/gr/rande.html) im *Allgemeine Amazon Web Services-Referenz*.