

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à.

# Endpoint specifici del servizio
<a name="feature-ss-endpoints"></a>

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

La configurazione degli endpoint specifica del servizio offre la possibilità di utilizzare un endpoint di propria scelta per le richieste API e di mantenere tale scelta. Queste impostazioni offrono la flessibilità necessaria per supportare endpoint locali, endpoint VPC e ambienti di sviluppo locale di terze parti AWS . È possibile utilizzare endpoint diversi per ambienti di test e produzione. È possibile specificare un URL di endpoint per singoli utenti dei Servizi AWS. 

Configura questa funzionalità utilizzando quanto segue:

**`endpoint_url`- impostazione dei AWS `config` file condivisi`AWS_ENDPOINT_URL`- variabile d'ambiente`aws.endpointUrl`- Proprietà del sistema JVM: solo Java/Kotlin **  
Se specificata direttamente all'interno di un profilo o come variabile di ambiente, questa impostazione specifica l'endpoint utilizzato per tutte le richieste di servizio. Questo endpoint viene sovrascritto da qualsiasi endpoint configurato specifico del servizio.   
È inoltre possibile utilizzare questa impostazione all'interno di una `services` sezione di un AWS `config` file condiviso per impostare un endpoint personalizzato per un servizio specifico. Per un elenco di tutte le chiavi identificative del servizio da utilizzare per le sottosezioni all'interno della `services` sezione, vedere. [Identificatori per endpoint specifici del servizio](ss-endpoints-table.md)  
**Valore predefinito**: `none`  
**Valori validi:** un URL che include lo schema e l'host per l'endpoint. L'URL può facoltativamente contenere un componente del percorso che contiene uno o più segmenti di percorso.

**`AWS_ENDPOINT_URL_<SERVICE>`- variabile di ambiente`aws.endpointUrl<ServiceName>`- Proprietà del sistema JVM: solo Java/Kotlin **  
`AWS_ENDPOINT_URL_<SERVICE>`, `<SERVICE>` dov'è l' Servizio AWS identificatore, imposta un endpoint personalizzato per un servizio specifico. Per l’elenco di tutte le variabili di ambiente specifiche del servizio, consulta [Identificatori per endpoint specifici del servizio](ss-endpoints-table.md).   
Questo endpoint specifico del servizio sostituisce qualsiasi endpoint globale impostato. `AWS_ENDPOINT_URL`   
**Valore predefinito**: `none`  
**Valori validi:** un URL che include lo schema e l'host per l'endpoint. L'URL può facoltativamente contenere un componente del percorso che contiene uno o più segmenti di percorso.

**`ignore_configured_endpoint_urls`- impostazione condivisa AWS `config` dei file`AWS_IGNORE_CONFIGURED_ENDPOINT_URLS`- variabile d'ambiente`aws.ignoreConfiguredEndpointUrls`- Proprietà del sistema JVM: solo Java/Kotlin **  
Questa impostazione viene utilizzata per ignorare tutte le configurazioni personalizzate degli endpoint.  
Tieni presente che qualsiasi endpoint esplicito impostato nel codice o su uno stesso client di servizio viene utilizzato indipendentemente da questa impostazione. Ad esempio, l'inclusione del parametro della riga di `--endpoint-url` comando con un AWS CLI comando o il passaggio di un URL di endpoint a un costruttore del client avrà sempre effetto.  
**Valore predefinito**: `false`  
**Valori validi**:  
+ **`true`**— L'SDK o lo strumento non leggono alcuna opzione di configurazione personalizzata dal `config` file condiviso o dalle variabili di ambiente per l'impostazione di un URL dell'endpoint.
+ **`false`**— L'SDK o lo strumento utilizza tutti gli endpoint disponibili forniti dall'utente dal `config` file condiviso o dalle variabili di ambiente.

## Configura gli endpoint utilizzando variabili di ambiente
<a name="ss-endpoints-envar"></a>

Per indirizzare le richieste di tutti i servizi a un URL endpoint personalizzato, imposta la variabile di ambiente `AWS_ENDPOINT_URL` globale. 

```
export AWS_ENDPOINT_URL=http://localhost:4567
```

Per indirizzare le richieste per un URL di endpoint specifico Servizio AWS a un URL di endpoint personalizzato, utilizza la variabile di `AWS_ENDPOINT_URL_<SERVICE>` ambiente. Amazon DynamoDB ha un`serviceId`. [https://github.com/boto/botocore/blob/bcaf618c4b93c067efa0b85d3e92f3985ff60906/botocore/data/dynamodb/2012-08-10/service-2.json#L10](https://github.com/boto/botocore/blob/bcaf618c4b93c067efa0b85d3e92f3985ff60906/botocore/data/dynamodb/2012-08-10/service-2.json#L10) Per questo servizio, la variabile di ambiente dell’URL dell’endpoint è `AWS_ENDPOINT_URL_DYNAMODB`. Questo endpoint ha la precedenza sull'endpoint globale impostato `AWS_ENDPOINT_URL` per questo servizio. 

```
export AWS_ENDPOINT_URL_DYNAMODB=http://localhost:5678
```

 Come altro esempio, AWS Elastic Beanstalk ha un di. `serviceId` [https://github.com/boto/botocore/blob/bcaf618c4b93c067efa0b85d3e92f3985ff60906/botocore/data/elasticbeanstalk/2010-12-01/service-2.json#L9](https://github.com/boto/botocore/blob/bcaf618c4b93c067efa0b85d3e92f3985ff60906/botocore/data/elasticbeanstalk/2010-12-01/service-2.json#L9) L' Servizio AWS identificatore si basa sul modello API `serviceId` sostituendo tutti gli spazi con caratteri di sottolineatura e tutte le lettere maiuscole. Per impostare l'endpoint per questo servizio, la variabile di ambiente corrispondente è. `AWS_ENDPOINT_URL_ELASTIC_BEANSTALK` Per l’elenco di tutte le variabili di ambiente specifiche del servizio, consulta [Identificatori per endpoint specifici del servizio](ss-endpoints-table.md). 

```
export AWS_ENDPOINT_URL_ELASTIC_BEANSTALK=http://localhost:5567
```

## Configura gli endpoint utilizzando il file condiviso `config`
<a name="ss-endpoints-config"></a>

Nel `config` file condiviso, `endpoint_url` viene utilizzato in luoghi diversi per funzionalità diverse.
+ `endpoint_url`specificato direttamente all'interno di a `profile` rende quell'endpoint l'endpoint globale. 
+ `endpoint_url`annidato sotto una chiave identificativa del servizio all'interno di una `services` sezione fa sì che l'endpoint si applichi alle richieste fatte solo a quel servizio. Per i dettagli sulla definizione di una sezione `services` nel file `config` condiviso, consulta [Formato del file di configurazione](file-format.md#file-format-config). 

 L'esempio seguente utilizza una `services` definizione per configurare un URL di endpoint specifico del servizio da utilizzare per Amazon S3 e un endpoint globale personalizzato da utilizzare per tutti gli altri servizi: 

```
[profile dev-s3-specific-and-global]
endpoint_url = http://localhost:1234
services = s3-specific

[services s3-specific]
s3 = 
  endpoint_url = https://play.min.io:9000
```

Un singolo profilo può configurare gli endpoint per più servizi. Questo esempio mostra come impostare l'endpoint specifico del servizio per Amazon URLs S3 e AWS Elastic Beanstalk nello stesso profilo. AWS Elastic Beanstalk ha un. `serviceId` [https://github.com/boto/botocore/blob/bcaf618c4b93c067efa0b85d3e92f3985ff60906/botocore/data/elasticbeanstalk/2010-12-01/service-2.json#L9](https://github.com/boto/botocore/blob/bcaf618c4b93c067efa0b85d3e92f3985ff60906/botocore/data/elasticbeanstalk/2010-12-01/service-2.json#L9) L' Servizio AWS identificatore si basa sul modello API `serviceId` sostituendo tutti gli spazi con caratteri di sottolineatura e tutte le lettere minuscole. Pertanto, la chiave identificativa del servizio diventa `elastic_beanstalk` e le impostazioni per questo servizio iniziano sulla linea. `elastic_beanstalk = ` Per un elenco di tutte le chiavi identificative del servizio da utilizzare nella sezione `services`, consulta [Identificatori per endpoint specifici del servizio](ss-endpoints-table.md). 

```
[services testing-s3-and-eb]
s3 = 
  endpoint_url = http://localhost:4567
elastic_beanstalk = 
  endpoint_url = http://localhost:8000

[profile dev]
services = testing-s3-and-eb
```

La sezione di configurazione del servizio può essere utilizzata da più profili. Ad esempio, due profili possono utilizzare la stessa `services` definizione modificando altre proprietà del profilo: 

```
[services testing-s3]
s3 = 
  endpoint_url = https://localhost:4567

[profile testing-json]
output = json
services = testing-s3

[profile testing-text]
output = text
services = testing-s3
```

## Configura gli endpoint nei profili utilizzando credenziali basate sui ruoli
<a name="ss-endpoints-role"></a>

Se il tuo profilo dispone di credenziali basate sui ruoli configurate tramite un parametro `source_profile` per consentire a IAM di assumere la funzionalità del ruolo, l’SDK utilizza solo le configurazioni di servizio relative al profilo specificato. Non utilizza profili a cui sono associati ruoli concatenati. Ad esempio, può utilizzare il seguente file `config` condiviso: 

```
[profile A]
credential_source = Ec2InstanceMetadata
endpoint_url = https://profile-a-endpoint.aws/

[profile B]
source_profile = A
role_arn = arn:aws:iam::123456789012:role/roleB
services = profileB

[services profileB]
ec2 = 
  endpoint_url = https://profile-b-ec2-endpoint.aws
```

 Se utilizzi il profilo `B` ed effettui una chiamata nel codice verso Amazon EC2, l’endpoint viene risolto come `https://profile-b-ec2-endpoint.aws`. Se il codice invia una richiesta a qualsiasi altro servizio, la risoluzione dell’endpoint non seguirà alcuna logica personalizzata. L’endpoint non viene risolto come l’endpoint globale definito nel profilo `A`. Affinché un endpoint globale abbia effetto sul profilo `B`, è necessario impostare `endpoint_url` direttamente all’interno del profilo `B`. Per ulteriori informazioni in merito all'impostazione `source_profile`, consulta [Assumi il ruolo di fornitore di credenziali](feature-assume-role-credentials.md). 

## Precedenza delle impostazioni
<a name="ss-endpoints-precedence"></a>

 Le impostazioni di questa funzionalità possono essere utilizzate contemporaneamente, ma solo un valore avrà la priorità per servizio. Per le chiamate API effettuate verso un determinato valore Servizio AWS, viene utilizzato il seguente ordine per selezionare un valore: 

1. Qualsiasi impostazione esplicita impostata nel codice o su un client di servizio stesso ha la precedenza su qualsiasi altra cosa.
   + Per il AWS CLI, questo è il valore fornito dal parametro della `--endpoint-url` riga di comando. Per un SDK, le assegnazioni esplicite possono assumere la forma di un parametro impostato quando si crea un'istanza di un client o di un Servizio AWS oggetto di configurazione.

1. Il valore fornito da una variabile di ambiente specifica del servizio, ad esempio. `AWS_ENDPOINT_URL_DYNAMODB`

1. Il valore fornito dalla variabile di ambiente `AWS_ENDPOINT_URL` globale dell'endpoint.

1. Il valore fornito dall'`endpoint_url`impostazione annidata in una chiave di identificazione del servizio all'interno di una `services` sezione del file condiviso. `config`

1. Il valore fornito dall'`endpoint_url`impostazione specificato direttamente all'interno `profile` di uno dei file condivisi`config`.

1. Qualsiasi URL di endpoint predefinito per il rispettivo Servizio AWS viene utilizzato per ultimo.

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

Di seguito sono SDKs supportate le funzionalità e le impostazioni descritte in questo argomento. Vengono annotate eventuali eccezioni parziali. Tutte le impostazioni delle proprietà del sistema JVM sono supportate solo da AWS SDK per Java and the. AWS SDK per Kotlin 


| SDK | Supportata | Note o ulteriori informazioni | 
| --- | --- | --- | 
| [AWS CLI  ](https://docs.aws.amazon.com/cli/latest/userguide/) v2 | Sì |  | 
| [SDK per C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Sì |  | 
| [SDK per Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sì |  | 
| [SDK per Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | No |  | 
| [SDK per Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sì |  | 
| [SDK per Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | No |  | 
| [SDK per 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sì |  | 
| [SDK per 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | No |  | 
| [SDK per Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sì |  | 
| [SDK per.NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sì |  | 
| [SDK per.NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sì |  | 
| [SDK per PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sì |  | 
| [SDK per Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sì |  | 
| [SDK per Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sì |  | 
| [SDK per Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Sì |  | 
| [SDK per Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Sì |  | 
| [Strumenti per V5 PowerShell ](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sì |  | 
| [Strumenti per PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sì |  | 