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à.
Riferimento alle impostazioni
SDKs forniscono specifiche per la lingua APIs . Servizi AWS Si occupano di alcune delle attività più complesse necessarie per effettuare correttamente le chiamate API, tra cui l'autenticazione, il comportamento dei tentativi e altro ancora. A tale scopo, SDKs dispongono di strategie flessibili per ottenere le credenziali da utilizzare per le richieste, mantenere le impostazioni da utilizzare con ciascun servizio e ottenere valori da utilizzare per le impostazioni globali.
È possibile trovare informazioni dettagliate sulle impostazioni di configurazione nelle seguenti sezioni:
-
AWS SDKse Tools: fornitori di credenziali standardizzati— Fornitori di credenziali comuni standardizzati su più piattaforme. SDKs
-
AWS SDKs e funzionalità standardizzate di Tools— Funzionalità comuni standardizzate su più piattaforme. SDKs
Creazione di clienti di servizio
Per accedere a livello di codice Servizi AWS, SDKs utilizzate una classe/oggetto client per ciascuno. Servizio AWS Ad esempio, se la tua applicazione deve accedere ad Amazon EC2, crea un oggetto EC2 client Amazon per interfacciarsi con quel servizio. Quindi utilizzi il client del servizio per effettuare richieste in merito Servizio AWS. Nella maggior parte dei casi SDKs, un oggetto client di servizio è immutabile, quindi è necessario creare un nuovo client per ogni servizio a cui si effettuano richieste e per effettuare richieste allo stesso servizio utilizzando una configurazione diversa.
Precedenza delle impostazioni
Le impostazioni globali configurano funzionalità, fornitori di credenziali e altre funzionalità che sono supportate dalla maggior parte SDKs e hanno un ampio impatto su tutti. Servizi AWS Tutte SDKs hanno una serie di luoghi (o fonti) che controllano per trovare un valore per le impostazioni globali. Quanto segue è l'impostazione della priorità di ricerca:
-
Qualsiasi impostazione esplicita impostata nel codice o su un client di servizio stesso ha la precedenza su qualsiasi altra cosa.
-
Alcune impostazioni possono essere impostate in base all'operazione e possono essere modificate secondo necessità per ogni operazione richiamata. Per l' AWS CLI operazione AWS Strumenti per PowerShell, queste assumono la forma di parametri specifici per operazione che vengono immessi nella riga di comando. Per un SDK, le assegnazioni esplicite possono assumere la forma di un parametro impostato quando si crea un'istanza di un Servizio AWS client o di un oggetto di configurazione o, a volte, quando si chiama una singola API.
-
-
Solo Java/Kotlin: la proprietà del sistema JVM per l'impostazione è verificata. Se è impostato, quel valore viene utilizzato per configurare il client.
-
La variabile di ambiente è selezionata. Se è impostato, quel valore viene utilizzato per configurare il client.
-
L'SDK verifica l'impostazione nel
credentialsfile condiviso. Se è impostato, il client lo utilizza. -
Il
configfile condiviso per l'impostazione. Se l'impostazione è presente, l'SDK la utilizza.-
La variabile di
AWS_PROFILEambiente o la proprietà di sistemaaws.profileJVM possono essere utilizzate per specificare il profilo caricato dall'SDK.
-
-
Qualsiasi valore predefinito fornito dal codice sorgente SDK stesso viene utilizzato per ultimo.
Nota
Alcuni SDKs strumenti potrebbero eseguire il controllo in un ordine diverso. Inoltre, alcuni SDKs strumenti supportano altri metodi di memorizzazione e recupero dei parametri. Ad esempio, AWS SDK for .NET supporta una fonte aggiuntiva denominata SDK Store. Per ulteriori informazioni sui provider esclusivi di un SDK o di uno strumento, consulta la guida specifica per l'SDK o lo strumento che stai utilizzando.
L'ordine determina quali metodi hanno la precedenza e sostituiscono gli altri. Ad esempio, se configuri un profilo nel config file condiviso, questo viene trovato e utilizzato solo dopo che l'SDK o lo strumento hanno prima verificato le altre posizioni. Ciò significa che se inserisci un'impostazione nel credentials file, questa viene utilizzata al posto di quella trovata nel config file. Se si configura una variabile di ambiente con un'impostazione e un valore, questa avrà la precedenza su tale impostazione credentials sia nei config file che. Infine, un'impostazione sulla singola operazione (parametro della AWS CLI
riga di comando o parametro API) o nel codice sovrascriverebbe tutti gli altri valori di quell'unico comando.
Pagine delle impostazioni
Le pagine all'interno della sezione di riferimento alle Impostazioni di questa guida descrivono in dettaglio le impostazioni disponibili che possono essere configurate tramite vari meccanismi. Le tabelle che seguono elencano le impostazioni dei file di configurazione e credenziali, le variabili di ambiente e (per Java e Kotlin SDKs) le impostazioni JVM che possono essere utilizzate al di fuori del codice per configurare la funzionalità. Ogni argomento collegato in ogni elenco porta alla pagina delle impostazioni corrispondente.
Ogni provider di credenziali o funzionalità dispone di una pagina in cui sono elencate le impostazioni utilizzate per configurare tale funzionalità. Per ogni impostazione, è spesso possibile impostare il valore aggiungendo l'impostazione a un file di configurazione o impostando una variabile di ambiente oppure (solo per Java e Kotlin) impostando una proprietà di sistema JVM. Ogni impostazione elenca tutti i metodi supportati per impostare il valore in un blocco sopra i dettagli della descrizione. Sebbene la precedenza vari, la funzionalità risultante è la stessa indipendentemente da come viene impostata.
La descrizione includerà l'eventuale valore predefinito che avrà effetto se non si esegue alcuna operazione. Definisce inoltre il valore valido per quell'impostazione.
Ad esempio, diamo un'occhiata a un'impostazione dalla pagina delle Richiesta di compressione funzionalità.
Le informazioni dell'impostazione di disable_request_compression esempio comunicano quanto segue:
-
Esistono tre modi equivalenti per controllare la compressione delle richieste al di fuori del codebase. Puoi eseguire una delle seguenti operazioni:
-
Impostalo nel tuo file di configurazione usando
disable_request_compression -
Impostala come variabile di ambiente usando
AWS_DISABLE_REQUEST_COMPRESSION -
Oppure, se stai usando Java o Kotlin SDK, impostalo come proprietà di sistema JVM usando
aws.disableRequestCompression
Nota
Potrebbe esserci anche un modo per configurare la stessa funzionalità direttamente nel codice, ma questo riferimento non copre questo aspetto poiché è unico per ogni SDK. Se desideri impostare la configurazione nel codice stesso, consulta la guida SDK o il riferimento API specifico.
-
-
Se non fai nulla, il valore predefinito sarà.
false -
Gli unici valori validi per questa impostazione booleana sono
truee.false
Nella parte inferiore di ogni pagina di funzionalità è presente una tabella di compatibilità con AWS SDKs.
Questa tabella mostra se l'SDK supporta le impostazioni elencate nella pagina. La Supported colonna indica il livello di supporto con i seguenti valori:
-
Yes— Le impostazioni sono completamente supportate dall'SDK così come scritto. -
Partial— Alcune impostazioni sono supportate o il comportamento si discosta dalla descrizione. InfattiPartial, una nota aggiuntiva indica la deviazione. -
No— Nessuna delle impostazioni è supportata. Ciò non afferma se sia possibile ottenere la stessa funzionalità nel codice; indica solo che le impostazioni di configurazione esterne elencate non sono supportate.
Configelenco delle impostazioni dei file
Le impostazioni elencate nella tabella seguente possono essere assegnate nel AWS config file condiviso. Sono globali e riguardano tutti Servizi AWS. SDKs e gli strumenti possono anche supportare impostazioni e variabili di ambiente uniche. Per visualizzare le impostazioni e le variabili di ambiente supportate solo da un singolo SDK o strumento, consulta l'SDK o la guida agli strumenti specifici.
Credentialselenco delle impostazioni dei file
Le impostazioni elencate nella tabella seguente possono essere assegnate nel AWS credentials file condiviso. Sono globali e riguardano tutti Servizi AWS. SDKs e gli strumenti possono anche supportare impostazioni e variabili di ambiente uniche. Per visualizzare le impostazioni e le variabili di ambiente supportate solo da un singolo SDK o strumento, consulta l'SDK o la guida agli strumenti specifici.
| Nome dell'impostazione | Informazioni |
|---|---|
aws_access_key_id
|
AWS chiavi di accesso |
aws_secret_access_key
|
AWS chiavi di accesso |
aws_session_token
|
AWS chiavi di accesso |
elenco delle variabili di ambiente
Le variabili di ambiente supportate dalla maggior parte SDKs sono elencate nella tabella seguente. Sono globali e riguardano tutti Servizi AWS. SDKs e gli strumenti possono anche supportare impostazioni e variabili di ambiente uniche. Per visualizzare le impostazioni e le variabili di ambiente supportate solo da un singolo SDK o strumento, consulta l'SDK o la guida agli strumenti specifici.
Elenco delle proprietà del sistema JVM
È possibile utilizzare le seguenti proprietà del sistema JVM per AWS SDK for Java e SDK AWS for Kotlin (destinate alla JVM). Come impostare le proprietà del sistema JVMPer istruzioni su come impostare le proprietà del sistema JVM, vedere.
