Imposta l'endpoint per un singolo comando Imposta un endpoint globale per tutti Servizi AWS Impostato per utilizzare gli endpoint FIP per tutti Servizi AWS Imposta per utilizzare gli endpoint dual-stack per tutti Servizi AWS Imposta endpoint specifici del servizio Priorità della configurazione e delle impostazioni degli endpoint

Usa gli 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

Imposta l'endpoint per un singolo comando

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


$ 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 gli URL degli endpoint configurati.

AWS_ENDPOINT_URL- Imposta l'URL globale dell'endpoint.

Il config file:
- ignore_configure_endpoint_urls- Ignora gli URL degli endpoint configurati.
```
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 --endpoint-url riga di comando sostituiscono qualsiasi endpoint globale.

Impostato per utilizzare gli endpoint FIP per tutti Servizi AWS

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

AWS_USE_FIPS_ENDPOINTvariabile di ambiente.
Linux or macOS
```
$ export AWS_USE_FIPS_ENDPOINT=true
```
Windows Command Prompt
Da impostare per tutte le sessioni
```
C:\> setx AWS_USE_FIPS_ENDPOINT true
```
Da impostare solo per la sessione corrente
```
C:\> set AWS_USE_FIPS_ENDPOINT=true
```
PowerShell
```
PS C:\> $Env:AWS_USE_FIPS_ENDPOINT="true"
```
use_fips_endpointimpostazione del file.
```
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'--endpoint-urlopzione o utilizza endpoint specifici del servizio.

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

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:

AWS_USE_DUALSTACK_ENDPOINTvariabile di ambiente.

use_dualstack_endpointimpostazione del file.
```
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 IPv4 che IPv6, consulta Using Using Amazon S3 dual-stack endpoint nella Amazon Simple Storage Service User Guide. Gli endpoint dual-stack sono disponibili per alcuni 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 per il servizio offre la possibilità di utilizzare un endpoint persistente di tua 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. 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 URL degli endpoint configurati, a meno che non siano specificati nella riga di comando.
- 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, vedere. Endpoint specifici del servizio: elenco di identificatori specifici del servizio
configfile:
- ignore_configure_endpoint_urls- Ignora tutti gli URL degli endpoint configurati, a meno che non sia specificato utilizzando variabili di ambiente o nella riga di comando.
- La servicessezione del config file combinata con l'impostazione del endpoint_url file.

Argomenti relativi agli endpoint specifici del servizio:

Variabili di ambiente
File condiviso config
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. Usa le variabili di ambiente se desideri che tutti i profili utilizzino gli stessi endpoint sul tuo dispositivo.

Le seguenti sono variabili di ambiente specifiche del servizio:

AWS_IGNORE_CONFIGURED_ENDPOINT_URLS- Ignora tutti gli URL degli endpoint configurati, a meno che non siano specificati nella riga di comando.
Linux or macOS
```
$ export AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true
```
Windows Command Prompt
Da impostare per tutte le sessioni
```
C:\> setx AWS_IGNORE_CONFIGURED_ENDPOINT_URLS true
```
Da impostare 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' Servizio AWS identificatore. Per tutte le variabili specifiche del servizio, vedere. 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
Da impostare per tutte le sessioni
```
C:\> setx AWS_ENDPOINT_URL_ELASTIC_BEANSTALK http://localhost:4567
```
Da impostare 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, vedereVariabili di ambiente per configurare AWS CLI.

Endpoint specifici del servizio: file condiviso `config`

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

L'esempio seguente utilizza una services sezione per configurare un URL 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 gli URL degli endpoint specifici del servizio per Amazon S3 e nello stesso profilo. AWS Elastic Beanstalk

Per un elenco di tutte le chiavi identificative del servizio da utilizzare nella sezione, consulta. services 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 services definizione:


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

Il seguente esempio di identificatore di servizio utilizza. AWS Elastic Beanstalk AWS Elastic Beanstalk ha un serviceId ofElastic Beanstalk, quindi la chiave identificativa del servizio è. elastic_beanstalk

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

Priorità della configurazione e delle impostazioni degli endpoint

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

L'opzione della --endpoint-url riga di comando.
Se abilitata, la variabile di ambiente AWS_IGNORE_CONFIGURED_ENDPOINT_URLS globale dell'endpoint o l'impostazione del profilo ignore_configure_endpoint_urls per ignorare gli endpoint personalizzati.
Il valore fornito da una variabile AWS_ENDPOINT_URL_<SERVICE> di ambiente specifica del servizio, ad esempio. AWS_ENDPOINT_URL_DYNAMODB
I valori forniti dalle variabili AWS_USE_DUALSTACK_ENDPOINTAWS_USE_FIPS_ENDPOINT, e di AWS_ENDPOINT_URL ambiente.
Il valore dell'endpoint specifico del servizio fornito dall'endpoint_urlimpostazione all'interno di una services sezione del file condiviso. config
Il valore fornito dall'endpoint_urlimpostazione all'interno di uno profile dei file condivisi. config
use_dualstack_endpointuse_fips_endpointe endpoint_url impostazioni.
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

Usa un proxy HTTP

Credenziali di autenticazione e accesso