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. **Contents** + [ ## Impostare l’endpoint per un unico comando ](#endpoints-command) + [ ## Imposta un endpoint globale per tutti Servizi AWS ](#endpoints-global) + [ ## Impostato per utilizzare gli FIPs endpoint per tutti Servizi AWS ](#endpoints-fips) + [ ## Imposta per utilizzare gli endpoint dual-stack per tutti Servizi AWS ](#endpoints-dual-stack) + [ ## Imposta endpoint specifici del servizio ](#endpoints-service-specific) + [Variabili di ambiente](#endpoints-service-specific-envvars) + [File `config` condiviso](#endpoints-service-specific-config) + [Elenco di identificatori specifici del servizio](#endpoints-service-specific-table) + [Endpoint basati sull’account](#endpoints-accountid) + [ ## Configurazione dell’endpoint e precedenza delle impostazioni ](#endpoints-precedence) ## 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\$1IGNORE\$1CONFIGURED\$1ENDPOINT\$1URLS`- Ignora l'endpoint URLs configurato. ------ #### [ 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\$1ENDPOINT\$1URL` - Imposta l’URL globale dell’endpoint. ------ #### [ Linux or macOS ] ``` $ export AWS_ENDPOINT_URL=http://localhost:4567 ``` ------ #### [ Windows Command Prompt ] **Impostazione per tutte le sessioni** ``` C:\> setx AWS_ENDPOINT_URL http://localhost:4567 ``` **Impostazione solo per la sessione corrente** ``` C:\> set AWS_ENDPOINT_URL=http://localhost:4567 ``` ------ #### [ PowerShell ] ``` PS C:\> $Env:AWS_ENDPOINT_URL="http://localhost:4567" ``` ------ + Il file `config` + `ignore\$1configure\$1endpoint\$1urls`- Ignora l'endpoint URLs configurato. ``` ignore_configure_endpoint_urls = true ``` + `endpoint\$1url` - 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\$1USE\$1FIPS\$1ENDPOINT`. ------ #### [ 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\$1fips\$1endpoint`. ``` use_fips_endpoint = true ``` Alcuni AWS servizi offrono endpoint che supportano il [Federal Information Processing Standard (FIPS) 140-2](https://aws.amazon.com/compliance/fips/), 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](#endpoints-service-specific). [Per ulteriori informazioni sulla specificazione degli endpoint FIPS per Regione AWS, vedere FIPS Endpoints by Service.](https://aws.amazon.com/compliance/fips/) ## 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\$1USE\$1DUALSTACK\$1ENDPOINT`. ------ #### [ Linux or macOS ] ``` $ export AWS_USE_DUALSTACK_ENDPOINT=true ``` ------ #### [ Windows Command Prompt ] **Impostazione per tutte le sessioni** ``` C:\> setx AWS_USE_DUALSTACK_ENDPOINT true ``` **Impostazione solo per la sessione corrente** ``` C:\> set AWS_USE_DUALSTACK_ENDPOINT=true ``` ------ #### [ PowerShell ] ``` PS C:\> $Env:AWS_USE_DUALSTACK_ENDPOINT="true" ``` ------ + Impostazione del file `use\$1dualstack\$1endpoint`. ``` 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](https://docs.aws.amazon.com/AmazonS3/latest/userguide/dual-stack-endpoints.html) 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\$1IGNORE\$1CONFIGURED\$1ENDPOINT\$1URLS`- Ignora tutti gli endpoint configurati URLs, a meno che non sia specificato nella riga di comando. + `AWS\$1ENDPOINT\$1URL\$1` - Specifica un endpoint personalizzato utilizzato per un servizio specifico, dove `` 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](#endpoints-service-specific-table). + `config` file + `ignore\$1configure\$1endpoint\$1urls`- 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`](cli-configure-files.md#cli-configure-files-format-services) del file `config` combinata con l’impostazione del file `endpoint\$1url`. **Topics** + [Variabili di ambiente](#endpoints-service-specific-envvars) + [File `config` condiviso](#endpoints-service-specific-config) + [Elenco di identificatori specifici del servizio](#endpoints-service-specific-table) ### 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\$1IGNORE\$1CONFIGURED\$1ENDPOINT\$1URLS`- 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\$1ENDPOINT\$1URL\$1`- Speciifica un endpoint personalizzato utilizzato per un servizio specifico, dove `` 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](#endpoints-service-specific-table). 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](cli-configure-envvars.md). ### 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_url`annidata 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`](cli-configure-files.md#cli-configure-files-format-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](#endpoints-service-specific-table). ``` [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\$1ACCOUNT\$1ID` - 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= ``` ------ #### [ Windows Command Prompt ] **Impostazione per tutte le sessioni** ``` C:\> setx AWS_ACCOUNT_ID ``` **Impostazione solo per la sessione corrente** ``` C:\> set AWS_ACCOUNT_ID= ``` ------ #### [ PowerShell ] ``` PS C:\> $Env:AWS_ACCOUNT_ID="" ``` ------ + `AWS\$1ACCOUNT\$1ID\$1ENDPOINT\$1MODE`- 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\$1account\$1id`- Speciifica l'ID dell'endpoint AWS basato sull'account da utilizzare per le chiamate ai servizi supportati. Servizi AWS ``` aws_account_id = ``` + `account\$1id\$1endpoint\$1mode`- 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 `` viene sostituito dall'ID dell'account e sostituito dal seguente: AWS `` Regione AWS ``` https://.myservice..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: 1. Opzione della riga di comando `--endpoint-url`. 1. Se abilitata, la variabile di ambiente globale `AWS\$1IGNORE\$1CONFIGURED\$1ENDPOINT\$1URLS` dell’endpoint o l’impostazione del profilo `ignore\$1configure\$1endpoint\$1urls` per ignorare gli endpoint personalizzati. 1. Il valore fornito da una variabile di ambiente `AWS\$1ENDPOINT\$1URL\$1` specifica del servizio, ad esempio `AWS_ENDPOINT_URL_DYNAMODB`. 1. I valori forniti dalle variabili di ambiente `AWS\$1USE\$1DUALSTACK\$1ENDPOINT`, `AWS\$1USE\$1FIPS\$1ENDPOINT` e `AWS\$1ENDPOINT\$1URL`. 1. La variabile di ambiente `AWS\$1ACCOUNT\$1ID\$1ENDPOINT\$1MODE` è impostata su `preferred` o `required` e utilizza l’ID account nella variabile `aws\$1account\$1id` o nell’impostazione `AWS\$1ACCOUNT\$1ID` di ambiente. 1. Il valore dell’endpoint specifico del servizio fornito dall’impostazione `endpoint\$1url` all’interno di una sezione `services` del file condiviso `config`. 1. Il valore fornito dall’impostazione `endpoint\$1url` all’interno di un `profile` dei file `config` condivisi. 1. Impostazioni di `use\$1dualstack\$1endpoint`, `use\$1fips\$1endpoint` e `endpoint\$1url`. 1. L’impostazione `account\$1id\$1endpoint\$1mode` è configurata su `preferred` o `required` che utilizza l’ID account nella variabile di ambiente `AWS\$1ACCOUNT\$1ID` o nell’impostazione `aws\$1account\$1id`. 1. 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](https://docs.aws.amazon.com/general/latest/gr/rande.html) nella *Riferimenti generali di Amazon Web Services*.