Utilizzo degli endpoint in AWS CLI

Per connettersi a livello di codice a un Servizio AWS, si utilizza un endpoint. Un endpoint è il punto URL 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 è possibile specificare un endpoint alternativo per le richieste. API

Argomenti sugli endpoint

• Imposta l'endpoint per un singolo comando
• Imposta un endpoint globale per tutti Servizi AWS
• Imposta per utilizzare gli endpoint per tutti FIPs Servizi AWS
• Imposta per utilizzare endpoint dual-stack per tutti Servizi AWS
• Imposta endpoint specifici del servizio
  • Variabili di ambiente
  • File condiviso config
  • Elenco di identificatori specifici del servizio
• Priorità della configurazione e delle impostazioni degli 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 endpoint Amazon S3 personalizzato. URL

$ 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 endpoint personalizzatoURL, utilizza una delle seguenti impostazioni:

• Variabili di ambiente:

  • AWS_IGNORE_CONFIGURED_ENDPOINT_URLS- Ignora l'endpoint URLs configurato.

    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- Imposta un endpoint URL globale.

    Linux or macOS

    $ export AWS_ENDPOINT_URL=http://localhost:4567

    Windows Command Prompt

    Da impostare per tutte le sessioni

    C:\> setx AWS_ENDPOINT_URL http://localhost:4567

    Da impostare solo per la sessione corrente

    C:\> set AWS_ENDPOINT_URL=http://localhost:4567

    PowerShell

    PS C:\> $Env:AWS_ENDPOINT_URL="http://localhost:4567"

• Il config file:

  • ignore_configure_endpoint_urls- Ignora l'endpoint URLs configurato.

    ignore_configure_endpoint_urls = true

  • endpoint_url- Imposta un endpoint URL globale.

    endpoint_url = http://localhost:4567

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

Imposta per utilizzare gli endpoint per tutti FIPs Servizi AWS

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

• 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 Se il AWS servizio supportaFIPS, questa impostazione specifica l'FIPSendpoint da utilizzare. AWS CLI A differenza degli AWS endpoint standard, gli FIPS endpoint utilizzano una libreria TLS software conforme a 140-2. FIPS Questi endpoint potrebbero essere necessari ad aziende che interagiscono con il governo degli Stati Uniti.

Se questa impostazione è abilitata, ma non esiste un FIPS endpoint per il servizio in uso Regione AWS, il comando potrebbe avere esito negativo. 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 in base al servizio, FIPS consulta Endpoints by Service Regione AWS. FIPS

Imposta per utilizzare 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.

  Linux or macOS

  $ export AWS_USE_DUALSTACK_ENDPOINT=true

  Windows Command Prompt

  Da impostare per tutte le sessioni

  C:\> setx AWS_USE_DUALSTACK_ENDPOINT true

  Da impostare solo per la sessione corrente

  C:\> set AWS_USE_DUALSTACK_ENDPOINT=true

  PowerShell

  PS C:\> $Env:AWS_USE_DUALSTACK_ENDPOINT="true"

• 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 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 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, VPC endpoint e ambienti di sviluppo locale di terze parti. AWS È possibile utilizzare endpoint diversi per ambienti di test e produzione. È possibile specificare un endpoint URL 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 endpoint configuratiURLs, a meno che non sia specificato 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 endpoint configuratiURLs, a meno che non sia specificato utilizzando le variabili di ambiente o sulla 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 endpoint configuratiURLs, a meno che non sia specificato 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, vedereConfigurazione delle variabili di ambiente per 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 endpoint specifico del servizio per Amazon URL 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, 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 su quello del API modello 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:

1. L'opzione della --endpoint-url riga di comando.

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

3. Il valore fornito da una variabile AWS_ENDPOINT_URL_<SERVICE> di ambiente specifica del servizio, ad esempio. AWS_ENDPOINT_URL_DYNAMODB

4. I valori forniti dalle variabili AWS_USE_DUALSTACK_ENDPOINTAWS_USE_FIPS_ENDPOINT, e di AWS_ENDPOINT_URL ambiente.

5. Il valore dell'endpoint specifico del servizio fornito dall'endpoint_urlimpostazione all'interno di una services sezione del file condiviso. config

6. Il valore fornito dall'endpoint_urlimpostazione all'interno di uno profile dei file condivisi. config

7. use_dualstack_endpointuse_fips_endpointe endpoint_url impostazioni.

8. Qualsiasi endpoint predefinito URL 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.