Impostare l’endpoint per un unico comando Imposta un endpoint globale per tutti Servizi AWS Impostato per utilizzare gli FIPs endpoint per tutti Servizi AWS Imposta per utilizzare gli endpoint dual-stack per tutti Servizi AWS Imposta endpoint specifici del servizio Endpoint basati sull’account Configurazione dell’endpoint e precedenza delle impostazioni

Questa documentazione è valida AWS CLI solo per la versione 1.

Abbiamo annunciato l' end-of-supportimminente rilascio della AWS CLI versione 1. Ti consigliamo di migrare alla AWS CLI versione 2. Per date, dettagli aggiuntivi e informazioni su come effettuare la migrazione, consulta l'annuncio. Per la documentazione relativa alla versione 2 di AWS CLI, consulta la Guida per l'utente della versione 2.

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

Utilizzo degli endpoint in AWS CLI

Per connetterti a livello di codice a un Servizio AWS, usi un endpoint. Un endpoint è l'URL del punto di ingresso per un servizio Web. AWS Il AWS Command Line Interface (AWS CLI) utilizza automaticamente l'endpoint predefinito per ogni servizio in un Regione AWS, ma puoi specificare un endpoint alternativo per le tue richieste API.

Argomenti sugli endpoint

Impostare l’endpoint per un unico comando

Per sovrascrivere le impostazioni degli endpoint o le variabili di ambiente per un singolo comando, utilizza l’opzione --endpoint-url della riga di comando. Il comando di esempio seguente utilizza un URL personalizzato per l’endpoint Amazon S3.


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

Imposta un endpoint globale per tutti Servizi AWS

Per indirizzare le richieste di tutti i servizi a un URL endpoint personalizzato, utilizza una delle seguenti impostazioni:

Variabili di ambiente:

AWS_IGNORE_CONFIGURED_ENDPOINT_URLS- Ignora l'endpoint URLs configurato.

AWS_ENDPOINT_URL - Imposta l’URL globale dell’endpoint.

Il file config
- ignore_configure_endpoint_urls- Ignora l'endpoint URLs configurato.
```
ignore_configure_endpoint_urls = true
```
- endpoint_url - Imposta l’URL globale dell’endpoint.
```
endpoint_url = http://localhost:4567
```

Gli endpoint specifici del servizio e l’opzione della riga di comando --endpoint-url sostituiscono qualsiasi endpoint globale.

Impostato per utilizzare gli FIPs endpoint per tutti Servizi AWS

Per indirizzare le richieste di tutti i servizi all'utilizzo FIPs degli endpoint, utilizza uno dei seguenti:

Variabile di ambiente AWS_USE_FIPS_ENDPOINT.
Linux or macOS
```
$ export AWS_USE_FIPS_ENDPOINT=true
```
Windows Command Prompt
Impostazione per tutte le sessioni
```
C:\> setx AWS_USE_FIPS_ENDPOINT true
```
Impostazione solo per la sessione corrente
```
C:\> set AWS_USE_FIPS_ENDPOINT=true
```
PowerShell
```
PS C:\> $Env:AWS_USE_FIPS_ENDPOINT="true"
```
Impostazione del file use_fips_endpoint.
```
use_fips_endpoint = true
```

Alcuni AWS servizi offrono endpoint che supportano il Federal Information Processing Standard (FIPS) 140-2, in altri. Regioni AWS Quando il AWS servizio supporta FIPS, questa impostazione specifica quale endpoint FIPS deve utilizzare. AWS CLI A differenza degli endpoint AWS standard, gli endpoint FIPS utilizzano una libreria software TLS conforme agli standard FIPS 140-2. Questi endpoint potrebbero essere necessari ad aziende che interagiscono con il governo degli Stati Uniti.

Se questa impostazione è abilitata, ma non esiste un endpoint FIPS per il servizio in uso, il comando potrebbe non riuscire. Regione AWS AWS In questo caso, specifica manualmente l’endpoint da utilizzare nel comando utilizzando l’opzione --endpoint-url oppure utilizza gli endpoint specifici del servizio.

Per ulteriori informazioni sulla specificazione degli endpoint FIPS per Regione AWS, vedere FIPS Endpoints by Service.

Imposta per utilizzare gli endpoint dual-stack per tutti Servizi AWS

Per indirizzare le richieste relative a tutti i servizi in modo che utilizzino gli endpoint dual-stack quando disponibili, utilizza una delle seguenti impostazioni:

Variabile di ambiente AWS_USE_DUALSTACK_ENDPOINT.

Impostazione del file use_dualstack_endpoint.
```
use_dualstack_endpoint = true
```

Consente l'uso di endpoint dual-stack per inviare richieste. AWS Per ulteriori informazioni sugli endpoint dual-stack, che supportano sia il traffico che il IPv6 traffico, consulta Using IPv4 Using Amazon S3 dual-stack endpoint nella Amazon Simple Storage Service User Guide. Gli endpoint dual-stack sono disponibili per determinati servizi in alcune Regioni. Se non esiste un endpoint dual-stack per il servizio o se la richiesta ha esito negativo. Regione AWS Questa opzione è disabilitata per impostazione predefinita.

Imposta endpoint specifici del servizio

La configurazione degli endpoint specifica del servizio offre la possibilità di utilizzare un endpoint persistente di propria scelta per le richieste. AWS CLI 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.

Gli endpoint specifici del servizio possono essere specificati nei seguenti modi:

L’opzione della riga di comando --endpoint-url per un singolo comando.
Variabili di ambiente:
- AWS_IGNORE_CONFIGURED_ENDPOINT_URLS- Ignora tutti gli endpoint configurati URLs, a meno che non sia specificato nella riga di comando.
- AWS_ENDPOINT_URL_<SERVICE> - Specifica un endpoint personalizzato utilizzato per un servizio specifico, dove <SERVICE> viene sostituito con l’identificatore Servizio AWS . Per tutte le variabili specifiche del servizio, consulta Endpoint specifici del servizio: elenco di identificatori specifici del servizio.
config file
- ignore_configure_endpoint_urls- Ignora tutti gli endpoint configurati URLs, a meno che non sia specificato utilizzando le variabili di ambiente o sulla riga di comando.
- La sezione services del file config combinata con l’impostazione del file endpoint_url.

Argomenti relativi agli endpoint specifici del servizio:

Variabili di ambiente
File config condiviso
Elenco di identificatori specifici del servizio

Endpoint specifici del servizio: variabili di ambiente

Le variabili di ambiente sostituiscono le impostazioni nel file di configurazione, ma non sostituiscono le opzioni specificate nella riga di comando. Utilizza le variabili di ambiente se desideri che tutti i profili impieghino gli stessi endpoint sul tuo dispositivo.

Le seguenti sono variabili di ambiente specifiche del servizio:

AWS_IGNORE_CONFIGURED_ENDPOINT_URLS- Ignora tutti gli endpoint configurati URLs, a meno che non sia specificato nella riga di comando.
Linux or macOS
```
$ export AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true
```
Windows Command Prompt
Impostazione per tutte le sessioni
```
C:\> setx AWS_IGNORE_CONFIGURED_ENDPOINT_URLS true
```
Impostazione solo per la sessione corrente
```
C:\> set AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true
```
PowerShell
```
PS C:\> $Env:AWS_IGNORE_CONFIGURED_ENDPOINT_URLS="true"
```
AWS_ENDPOINT_URL_<SERVICE>- Speciifica un endpoint personalizzato utilizzato per un servizio specifico, dove <SERVICE> viene sostituito con l'identificatore. Servizio AWS Per tutte le variabili specifiche del servizio, consulta Endpoint specifici del servizio: elenco di identificatori specifici del servizio.

I seguenti esempi di variabili di ambiente impostano un endpoint per AWS Elastic Beanstalk.
Linux or macOS
```
$ export AWS_ENDPOINT_URL_ELASTIC_BEANSTALK=http://localhost:4567
```
Windows Command Prompt
Impostazione per tutte le sessioni
```
C:\> setx AWS_ENDPOINT_URL_ELASTIC_BEANSTALK http://localhost:4567
```
Impostazione solo per la sessione corrente
```
C:\> set AWS_ENDPOINT_URL_ELASTIC_BEANSTALK=http://localhost:4567
```
PowerShell
```
PS C:\> $Env:AWS_ENDPOINT_URL_ELASTIC_BEANSTALK="http://localhost:4567"
```

Per ulteriori informazioni sull’impostazione delle variabili di ambiente, consulta Configurazione delle variabili di ambiente per AWS CLI.

Endpoint specifici del servizio: file `config` condiviso

Nel file config condiviso, endpoint_url viene utilizzato in più sezioni. Per impostare un endpoint specifico del servizio, utilizza l’impostazione endpoint_urlannidata sotto una chiave identificativa del servizio all’interno di una sezione dei services. Per i dettagli sulla definizione di una sezione services nel file config condiviso, consulta Tipo di sezione: services.

L’esempio seguente utilizza una sezione services per configurare un URL dell’endpoint specifico del servizio per Amazon S3 e un endpoint globale personalizzato utilizzato per tutti gli altri servizi:


[profile dev1]
endpoint_url = http://localhost:1234
services = s3-specific

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

Un singolo profilo può configurare gli endpoint per più servizi. L'esempio seguente imposta l'endpoint specifico del servizio per Amazon URLs S3 e AWS Elastic Beanstalk nello stesso profilo.

Per un elenco di tutte le chiavi identificative del servizio da utilizzare nella sezione services, consulta Elenco di identificatori specifici del servizio.


[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

La sezione di configurazione del servizio può essere utilizzata in più profili. L’esempio seguente presenta due profili che utilizzano la stessa definizione dei services:


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

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

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

Endpoint specifici del servizio: elenco di identificatori specifici del servizio

L' Servizio AWS identificatore si basa sul modello API e sostituisce tutti gli spazi con caratteri serviceId di sottolineatura e tutte le lettere minuscole.

La tabella seguente elenca tutti gli identificatori, le chiavi di file e le variabili di ambiente specifici del servizio config.

Endpoint basati sull’account

Gli endpoint basati su account possono essere specificati nei seguenti modi:

Variabili di ambiente
- AWS_ACCOUNT_ID - Specifica l’ID dell’endpoint basato sull’account AWS da utilizzare per le chiamate ai Servizi AWS supportati.
  Linux or macOS
  
  $ export AWS_ACCOUNT_ID=<account-id>
  
  Windows Command Prompt
  
  Impostazione per tutte le sessioni
  
  C:\> setx AWS_ACCOUNT_ID <account-id>
  
  Impostazione solo per la sessione corrente
  
  C:\> set AWS_ACCOUNT_ID=<account-id>
  
  PowerShell
  
  PS C:\> $Env:AWS_ACCOUNT_ID="<account-id>"
- AWS_ACCOUNT_ID_ENDPOINT_MODE- Specifica se utilizzare un endpoint AWS IDs basato sull'account per le chiamate ai servizi di assistenza. Servizi AWS Può essere impostato su preferred, disabled o required. Il valore predefinito è preferred.
  Linux or macOS
  
  $ export AWS_ACCOUNT_ID_ENDPOINT_MODE=preferred
  
  Windows Command Prompt
  
  Impostazione per tutte le sessioni
  
  C:\> setx AWS_ACCOUNT_ID_ENDPOINT_MODE preferred
  
  Impostazione solo per la sessione corrente
  
  C:\> set AWS_ACCOUNT_ID_ENDPOINT_MODE=preferred
  
  PowerShell
  
  PS C:\> $Env:AWS_ACCOUNT_ID_ENDPOINT_MODE="preferred"
Il file config
- aws_account_id- Speciifica l'ID dell'endpoint AWS basato sull'account da utilizzare per le chiamate ai servizi supportati. Servizi AWS
```
aws_account_id = <account-id>
```
- account_id_endpoint_mode- Speciifica se utilizzare un endpoint basato sull' AWS account per le chiamate ai servizi supportati. IDs Servizi AWS Può essere impostato su preferred, disabled o required. Il valore predefinito è preferred.
```
account_id_endpoint_mode = preferred
```

Gli endpoint basati su account aiutano a garantire prestazioni e scalabilità elevate utilizzando l'ID AWS dell'account per semplificare il routing delle richieste di servizi che supportano questa funzionalità. Servizio AWS Quando si utilizza un fornitore di credenziali e un servizio che supporta gli endpoint basati su account, crea e utilizza AWS CLI automaticamente un endpoint basato sull'account anziché un endpoint regionale.

Gli endpoint basati sull'account utilizzano il seguente formato, in cui <account-id> viene sostituito dall'ID dell'account e sostituito dal seguente: AWS <region> Regione AWS


https://<account-id>.myservice.<region>.amazonaws.com

Per impostazione predefinita AWS CLI, la modalità endpoint basata sull'account è impostata su. preferred

Configurazione dell’endpoint e precedenza delle impostazioni

Le impostazioni di configurazione degli endpoint si trovano in più posizioni, ad esempio le variabili di sistema o di ambiente utente, i file di AWS configurazione locali o sono dichiarate esplicitamente nella riga di comando come parametro. Le impostazioni di configurazione AWS CLI degli endpoint hanno la precedenza nell'ordine seguente:

Opzione della riga di comando --endpoint-url.
Se abilitata, la variabile di ambiente globale AWS_IGNORE_CONFIGURED_ENDPOINT_URLS dell’endpoint o l’impostazione del profilo ignore_configure_endpoint_urls per ignorare gli endpoint personalizzati.
Il valore fornito da una variabile di ambiente AWS_ENDPOINT_URL_<SERVICE> specifica del servizio, ad esempio AWS_ENDPOINT_URL_DYNAMODB.
I valori forniti dalle variabili di ambiente AWS_USE_DUALSTACK_ENDPOINT, AWS_USE_FIPS_ENDPOINT e AWS_ENDPOINT_URL.
La variabile di ambiente AWS_ACCOUNT_ID_ENDPOINT_MODE è impostata su preferred o required e utilizza l’ID account nella variabile aws_account_id o nell’impostazione AWS_ACCOUNT_ID di ambiente.
Il valore dell’endpoint specifico del servizio fornito dall’impostazione endpoint_url all’interno di una sezione services del file condiviso config.
Il valore fornito dall’impostazione endpoint_url all’interno di un profile dei file config condivisi.
Impostazioni di use_dualstack_endpoint, use_fips_endpoint e endpoint_url.
L’impostazione account_id_endpoint_mode è configurata su preferred o required che utilizza l’ID account nella variabile di ambiente AWS_ACCOUNT_ID o nell’impostazione aws_account_id.
Qualsiasi URL di endpoint predefinito per il rispettivo dispositivo Servizio AWS viene utilizzato per ultimo. Per un elenco degli endpoint del servizio standard disponibili in ogni regione, consulta Regioni ed endpoint AWS nella Riferimenti generali di Amazon Web Services.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Proxy HTTP

Credenziali di autenticazione e accesso