

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.

# AWS STS Regionale Endpunkte
<a name="feature-sts-regionalized-endpoints"></a>

**Anmerkung**  
Hilfe zum Verständnis des Layouts von Einstellungsseiten oder zur Interpretation der **nachfolgenden Tabelle Support by AWS SDKs und Tools** finden Sie unter[Die Einstellungsseiten dieses Handbuchs verstehen](settings-reference.md#settingsPages).

 AWS -Security-Token-Service (AWS STS) ist sowohl als globaler als auch als regionaler Service verfügbar. Einige von AWS SDKs und CLIs verwenden standardmäßig den globalen Dienstendpunkt (`https://sts.amazonaws.com`), während andere die regionalen Dienstendpunkte (`https://sts.{region_identifier}.{partition_domain}`) verwenden. In Regionen, die [standardmäßig aktiviert](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html) sind, werden Anfragen an den AWS STS globalen Endpunkt automatisch in derselben Region bearbeitet, aus der die Anfrage stammt. In Opt-in-Regionen werden Anfragen an den AWS STS globalen Endpunkt von einer einzigen Person AWS-Region, USA Ost (Nord-Virginia), bedient. *Weitere Informationen zu AWS STS Endpunkten finden Sie in der *AWS -Security-Token-Service API-Referenz* unter [Endgeräte](https://docs.aws.amazon.com/STS/latest/APIReference/welcome.html#sts-endpoints) oder [AWS STS im Benutzerhandbuch unter Verwalten](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html). AWS-RegionAWS Identity and Access Management *

Es hat sich AWS bewährt, wann immer möglich regionale Endpunkte zu verwenden und Ihre zu konfigurieren. [AWS-Region](feature-region.md) Kunden in anderen [Partitionen](https://docs.aws.amazon.com/glossary/latest/reference/glos-chap.html?id=docs_gateway#partition) als kommerziellen Partitionen müssen regionale Endpunkte verwenden. Nicht alle SDKs AND-Tools unterstützen diese Einstellung, aber alle haben ein definiertes Verhalten in Bezug auf globale und regionale Endpunkte. Weitere Informationen finden Sie im folgenden Abschnitt .

**Anmerkung**  
AWS hat in Regionen, die AWS -Security-Token-Service [standardmäßig aktiviert](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html) sind, Änderungen am globalen Endpunkt (`https://sts.amazonaws.com`) () vorgenommen, um dessen Stabilität und Leistung zu verbessern.AWS STS AWS STS Anfragen an den globalen Endpunkt werden automatisch in denselben Workloads bearbeitet AWS-Region wie Ihre Workloads. Diese Änderungen werden nicht in Opt-in-Regionen bereitgestellt. Wir empfehlen, dass Sie die entsprechenden AWS STS regionalen Endpunkte verwenden. Weitere Informationen finden Sie im *AWS Identity and Access Management Benutzerhandbuch* unter [Änderungen an AWS STS globalen Endpunkten](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_region-endpoints.html#reference_sts_global_endpoint_changes).

Für SDKs Tools, die diese Einstellung unterstützen, können Kunden die Funktionalität wie folgt konfigurieren:

**`sts_regional_endpoints`- Einstellung für gemeinsam genutzte AWS `config` Dateien`AWS_STS_REGIONAL_ENDPOINTS`- Umgebungsvariable**  
Diese Einstellung gibt an, wie das SDK oder Tool den AWS-Service Endpunkt bestimmt, über den es mit dem AWS -Security-Token-Service (AWS STS) kommuniziert.  
**Standardwert:**`regional`, siehe Ausnahmen in der folgenden Tabelle.   
Alle neuen SDK-Hauptversionen, die nach Juli 2022 veröffentlicht werden, werden standardmäßig auf`regional`. Neue SDK-Hauptversionen könnten diese Einstellung und dieses `regional` Nutzungsverhalten entfernen. Um future Auswirkungen dieser Änderung zu verringern, empfehlen wir Ihnen, nach Möglichkeit mit `regional` der Verwendung in Ihrer Anwendung zu beginnen.
**Gültige Werte:** *(Empfohlener Wert:`regional`)*   
+ **`legacy`**— Verwendet den globalen AWS STS Endpunkt,`sts.amazonaws.com`.
+ **`regional`**— Das SDK oder Tool verwendet immer den AWS STS Endpunkt für die aktuell konfigurierte Region. Wenn der Client beispielsweise für die Verwendung konfiguriert ist`us-west-2`, AWS STS werden alle Aufrufe an den regionalen Endpunkt `sts.us-west-2.amazonaws.com` statt an den globalen `sts.amazonaws.com` Endpunkt getätigt. Um eine Anforderung an den globalen Endpunkt zu senden, während diese Einstellung aktiviert ist, können Sie die Region auf `aws-global` festlegen.
Beispiel für das Einstellen dieser Werte in der `config` Datei:  

```
[default]
sts_regional_endpoints = regional
```
Linux/macOS-Beispiel für das Setzen von Umgebungsvariablen über die Befehlszeile:  

```
export AWS_STS_REGIONAL_ENDPOINTS=regional
```
Windows-Beispiel für das Setzen von Umgebungsvariablen über die Befehlszeile:  

```
setx AWS_STS_REGIONAL_ENDPOINTS regional
```

## Support von AWS SDKs und Tools
<a name="feature-sts-regionalized-endpoints-sdk-compat"></a>

**Anmerkung**  
Es hat sich AWS bewährt, wann immer möglich regionale Endpunkte zu verwenden und Ihre [AWS-Region](feature-region.md) zu konfigurieren. 

 In der folgenden Tabelle finden Sie eine Zusammenfassung für Ihr SDK oder Tool:
+ **Unterstützt die Einstellung**: Gibt an, ob die gemeinsam genutzte `config` Dateivariable und die Umgebungsvariable für regionale STS-Endpunkte unterstützt werden. 
+ **Standardeinstellungswert**: Der Standardwert der Einstellung, sofern er unterstützt wird. 
+ **Standard-Ziel-STS-Endpunkt des Service-Clients**: Welcher Standardendpunkt wird vom Client verwendet, auch wenn die Einstellung zur Änderung nicht verfügbar ist. 
+ **Fallback-Verhalten des Service-Clients**: Was tut das SDK, wenn es einen regionalen Endpunkt verwenden soll, aber keine Region konfiguriert wurde. Dieses Verhalten gilt unabhängig davon, ob ein regionaler Endpunkt aufgrund einer Standardeinstellung verwendet wird oder weil er in der Einstellung ausgewählt `regional` wurde. 

In der Tabelle werden auch die folgenden Werte verwendet:
+ **Globaler Endpunkt**:`https://sts.amazonaws.com`.
+ **Regionaler Endpunkt**: Basierend auf der von Ihrer Anwendung [AWS-Region](feature-region.md) verwendeten Konfiguration. 
+ **`us-east-1`(Regional)**: Verwendet den `us-east-1` Regions-Endpunkt, verwendet jedoch längere Sitzungstoken als typische globale Anfragen. 


| SDK |  Unterstützt die Einstellung  |  Standardeinstellungswert  |  Standard-Ziel-STS-Endpunkt des Service-Clients  |  Fallback-Verhalten des Serviceclients  | Hinweise oder weitere Informationen | 
| --- | --- | --- | --- | --- | --- | 
| [AWS CLI  ](https://docs.aws.amazon.com/cli/latest/userguide/) v2 | Nein | – | Regionaler Endpunkt | Globaler Endpunkt |  | 
| [AWS CLI v1](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-welcome.html) | Ja | legacy | Globaler Endpunkt | Globaler Endpunkt |  | 
| [SDK for C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Nein | – | Regionaler Endpunkt | us-east-1(Regional) |  | 
| [SDK for Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Nein | – | Regionaler Endpunkt | Fehler bei der Anfrage |  | 
| [SDK for Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Ja | legacy | Globaler Endpunkt | Globaler Endpunkt | Um die Einstellungen für gemeinsam genutzte config Dateien zu verwenden, müssen Sie das Laden aus der Konfigurationsdatei aktivieren. Weitere Informationen finden Sie unter [Sitzungen](https://docs.aws.amazon.com/sdk-for-go/api/aws/session/). | 
| [SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Nein | – | Regionaler Endpunkt | Fehler bei der Anfrage |  Wenn keine Region konfiguriert ist, verwendet der `AssumeRole` und `AssumeRoleWithWebIdentity` den globalen STS-Endpunkt.  | 
| [SDK for Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Ja | legacy | Globaler Endpunkt | Globaler Endpunkt |  | 
| [SDK für JavaScript 3.x](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Nein | – | Regionaler Endpunkt | us-east-1(Regional) |  | 
| [SDK für JavaScript 2.x](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Ja | legacy | Globaler Endpunkt | Globaler Endpunkt |  | 
| [SDK für Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Nein | – | Regionaler Endpunkt | Globaler Endpunkt |  | 
| [SDK for .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Nein | – | Regionaler Endpunkt | us-east-1(Regional) |  | 
| [SDK for .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Ja | regional | Globaler Endpunkt | Globaler Endpunkt |  | 
| [SDK for PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Ja | regional | Globaler Endpunkt | Fehler bei der Anfrage |  | 
| [SDK for Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Ja | regional | Globaler Endpunkt | Globaler Endpunkt |  | 
| [SDK for Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Ja | regional | Regionaler Endpunkt | Anfrage ist fehlgeschlagen |  | 
| [SDK für Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Nein | – | Regionaler Endpunkt | Fehler bei der Anfrage |  | 
| [SDK für Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Nein | – | Regionaler Endpunkt | Fehler bei der Anfrage |  | 
| [Tools für PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Ja | regional | Globaler Endpunkt | Globaler Endpunkt |  | 
| [Tools für PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Ja | regional | Globaler Endpunkt | Globaler Endpunkt |  | 