

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# AWS STS Endpoint regionali
<a name="feature-sts-regionalized-endpoints"></a>

**Nota**  
Per informazioni sulla comprensione del layout delle pagine delle impostazioni o sull'interpretazione della tabella **Support by AWS SDKs and tools** che segue, vedere[Informazioni sulle pagine delle impostazioni di questa guida](settings-reference.md#settingsPages).

 AWS Security Token Service (AWS STS) è disponibile sia come servizio globale che regionale. Alcuni CLIs utilizzano AWS SDKs il servizio globale endpoint (`https://sts.amazonaws.com`) per impostazione predefinita, mentre altri utilizzano gli endpoint di servizio regionali ()`https://sts.{region_identifier}.{partition_domain}`. Nelle regioni [abilitate per impostazione predefinita](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html), le richieste all'endpoint AWS STS globale vengono servite automaticamente nella stessa regione da cui proviene la richiesta. Nelle regioni opt-in, le richieste all'endpoint AWS STS globale vengono servite da un'unica regione Regione AWS, gli Stati Uniti orientali (Virginia settentrionale). *Per ulteriori informazioni sugli AWS STS endpoint, consulta [Endpoints](https://docs.aws.amazon.com/STS/latest/APIReference/welcome.html#sts-endpoints) nell'*AWS Security Token Service API Reference* o [Manage in an AWS STSRegione AWS nella](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html) User Guide.AWS Identity and Access Management *

È consigliabile utilizzare gli endpoint regionali ogni volta che è possibile e configurare i propri. AWS [Regione AWS](feature-region.md) I clienti con [partizioni](https://docs.aws.amazon.com/glossary/latest/reference/glos-chap.html?id=docs_gateway#partition) diverse da quelle commerciali devono utilizzare endpoint regionali. Non tutti SDKs gli strumenti supportano questa impostazione, ma tutti hanno un comportamento definito rispetto agli endpoint globali e regionali. Per ulteriori informazioni, consulta la sezione seguente.

**Nota**  
AWS ha apportato modifiche all'endpoint globale AWS Security Token Service (AWS STS`https://sts.amazonaws.com`) nelle Regioni [abilitate di default](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html) per migliorarne la resilienza e le prestazioni. AWS STS le richieste all'endpoint globale vengono servite automaticamente Regione AWS come i tuoi carichi di lavoro. Queste modifiche non verranno implementate nelle Regioni con attivazione facoltativa. Ti consigliamo di utilizzare gli endpoint AWS STS regionali appropriati. Per ulteriori informazioni, consulta le [modifiche AWS STS globali agli endpoint nella Guida](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_region-endpoints.html#reference_sts_global_endpoint_changes) per l'*AWS Identity and Access Management utente*.

Per SDKs gli strumenti che supportano questa impostazione, i clienti possono configurare la funzionalità utilizzando quanto segue:

**`sts_regional_endpoints`- impostazione di AWS `config` file condivisi`AWS_STS_REGIONAL_ENDPOINTS`- variabile d'ambiente**  
Questa impostazione specifica in che modo l'SDK o lo strumento determina l' Servizio AWS endpoint che utilizza per comunicare con (). AWS Security Token Service AWS STS  
**Valore predefinito:**`regional`, vedi le eccezioni nella tabella seguente.   
Tutte le nuove versioni principali dell'SDK rilasciate dopo luglio 2022 verranno utilizzate per impostazione predefinita. `regional` Le nuove versioni principali dell'SDK potrebbero rimuovere questa impostazione e questo comportamento d'uso. `regional` Per ridurre l'impatto futuro di questa modifica, ti consigliamo di iniziare a `regional` utilizzarla nella tua applicazione quando possibile.
**Valori validi:** *(Valore consigliato:`regional`)*   
+ **`legacy`**— Utilizza l' AWS STS endpoint globale,`sts.amazonaws.com`.
+ **`regional`**— L'SDK o lo strumento utilizza sempre l' AWS STS endpoint per la regione attualmente configurata. Ad esempio, se il client è configurato per l'uso`us-west-2`, tutte le chiamate AWS STS vengono effettuate all'endpoint regionale`sts.us-west-2.amazonaws.com`, anziché all'endpoint globale. `sts.amazonaws.com` Per inviare una richiesta all'endpoint globale mentre questa impostazione è abilitata, è possibile impostare l'area geografica su `aws-global`.
Esempio di impostazione di questi valori nel `config` file:  

```
[default]
sts_regional_endpoints = regional
```
Esempio in Linux/macOS di impostazione delle variabili di ambiente tramite riga di comando:  

```
export AWS_STS_REGIONAL_ENDPOINTS=regional
```
Esempio in Windows di impostazione delle variabili di ambiente tramite riga di comando:  

```
setx AWS_STS_REGIONAL_ENDPOINTS regional
```

## Support by AWS SDKs and tools
<a name="feature-sts-regionalized-endpoints-sdk-compat"></a>

**Nota**  
È AWS consigliabile utilizzare gli endpoint regionali ogni volta che è possibile e configurare i propri[Regione AWS](feature-region.md). 

 La tabella che segue riassume, per il tuo SDK o strumento:
+ **Supporta l'impostazione**: se sono supportate la variabile di `config` file condivisa e la variabile di ambiente per gli endpoint regionali STS. 
+ **Valore di impostazione predefinito**: il valore predefinito dell'impostazione, se supportata. 
+ **Il client di servizio predefinito si rivolge a STS Endpoint**: quale endpoint predefinito viene utilizzato dal client anche se l'impostazione per modificarlo non è disponibile. 
+ **Comportamento di fallback del client di servizio**: cosa fa l'SDK quando dovrebbe utilizzare un endpoint regionale ma non è stata configurata alcuna regione. Questo è il comportamento indipendentemente dal fatto che stia utilizzando un endpoint regionale a causa di un valore predefinito o perché `regional` è stato selezionato dall'impostazione. 

La tabella utilizza anche i seguenti valori:
+ **Endpoint globale**:`https://sts.amazonaws.com`.
+ **Endpoint regionale**: in base alla configurazione [Regione AWS](feature-region.md) utilizzata dall'applicazione. 
+ **`us-east-1`(Regionale)**: utilizza l'endpoint `us-east-1` Region ma con token di sessione più lunghi rispetto alle richieste globali tipiche. 


| SDK |  Supporta l'impostazione  |  Valore di impostazione predefinito  |  Il client di servizio predefinito è destinato a STS Endpoint  |  Comportamento di fallback del client di servizio  | Note o ulteriori informazioni | 
| --- | --- | --- | --- | --- | --- | 
| [AWS CLI  ](https://docs.aws.amazon.com/cli/latest/userguide/) v2 | No | N/D | Endpoint regionale | Endpoint globale |  | 
| [AWS CLI v1](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-welcome.html) | Sì | legacy | Endpoint globale | Endpoint globale |  | 
| [SDK per C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | No | N/D | Endpoint regionale | us-east-1(Regionale) |  | 
| [SDK per Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | No | N/D | Endpoint regionale | Richiesta non riuscita |  | 
| [SDK per Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Sì | legacy | Endpoint globale | Endpoint globale | [Per utilizzare le impostazioni dei `config` file condivisi, devi attivare il caricamento dal file di configurazione; vedi Sessioni.](https://docs.aws.amazon.com/sdk-for-go/api/aws/session/) | 
| [SDK per Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | No | N/D | Endpoint regionale | Richiesta non riuscita |  Se non è configurata alcuna regione, `AssumeRole` e `AssumeRoleWithWebIdentity` utilizzerà l'endpoint STS globale.  | 
| [SDK per Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Sì | legacy | Endpoint globale | Endpoint globale |  | 
| [SDK per 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | No | N/D | Endpoint regionale | us-east-1(Regionale) |  | 
| [SDK per 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Sì | legacy | Endpoint globale | Endpoint globale |  | 
| [SDK per Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | No | N/D | Endpoint regionale | Endpoint globale |  | 
| [SDK per.NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | No | N/D | Endpoint regionale | us-east-1(Regionale) |  | 
| [SDK per.NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sì | regional | Endpoint globale | Endpoint globale |  | 
| [SDK per PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sì | regional | Endpoint globale | Richiesta non riuscita |  | 
| [SDK per Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sì | regional | Endpoint globale | Endpoint globale |  | 
| [SDK per Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sì | regional | Endpoint regionale | Richiesta fallita |  | 
| [SDK per Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | No | N/D | Endpoint regionale | Richiesta fallita |  | 
| [SDK per Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | No | N/D | Endpoint regionale | Richiesta non riuscita |  | 
| [Strumenti per PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sì | regional | Endpoint globale | Endpoint globale |  | 
| [Strumenti per PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sì | regional | Endpoint globale | Endpoint globale |  | 