La AWS SDK per Java 1.x è stata raggiunta end-of-support il 31 dicembre 2025. Ti consigliamo di eseguire la migrazione a per continuare [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html)a ricevere nuove funzionalità, miglioramenti della disponibilità e aggiornamenti di sicurezza. 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à. # Nozioni di base In questa sezione vengono fornite informazioni su come installare, configurare e utilizzare AWS SDK per Java. **Topics** + [Configurazione di base](signup-create-iam-user.md) + [ # Modi per ottenere il AWS SDK per Java ](setup-install.md) + [ # Usa gli strumenti di costruzione ](setup-build-tools.md) + [Credenziali temporanee e regione](setup-credentials.md) # Configurazione di base con cui lavorare Servizi AWS ## Panoramica di Per sviluppare correttamente applicazioni che consentano l'accesso Servizi AWS tramite AWS SDK per Java, sono necessarie le seguenti condizioni: + È necessario essere in grado di [AWS accedere al portale di accesso](#setup-awsaccount) disponibile in AWS IAM Identity Center. + Le [autorizzazioni del ruolo IAM](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html) configurato per l'SDK devono consentire l'accesso a Servizi AWS ciò che l'applicazione richiede. Le autorizzazioni associate alla policy **PowerUserAccess** AWS gestita sono sufficienti per la maggior parte delle esigenze di sviluppo. + Un ambiente di sviluppo con i seguenti elementi: + [File di configurazione condivisi](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) configurati nel modo seguente: + Il `config` file contiene un profilo predefinito che specifica un Regione AWS. + Il `credentials` file contiene credenziali temporanee come parte di un profilo predefinito. + Un'[installazione adeguata di Java](#java-dg-java-env). + [Uno [strumento di automazione degli edifici](setup-build-tools.md) come [Maven o Gradle](https://maven.apache.org/download.cgi).](https://gradle.org/install/) + Un editor di testo per lavorare con il codice. + (Facoltativo, ma consigliato) Un IDE (ambiente di sviluppo integrato) come [IntelliJ IDEA](https://www.jetbrains.com/idea/download/#section=windows), [Eclipse o](https://www.eclipse.org/ide/). [NetBeans](https://netbeans.org/downloads/) Quando usi un IDE, puoi anche integrarlo con Kit di strumenti AWS s per lavorare più facilmente. Servizi AWS I [Kit di strumenti AWS per IntelliJ](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/welcome.html)e [AWS Toolkit for Eclipse](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/welcome.html)sono due toolkit che è possibile utilizzare per lo sviluppo in Java. **Importante** Le istruzioni in questa sezione di configurazione presuppongono che l'utente o l'organizzazione utilizzi IAM Identity Center. Se la tua organizzazione utilizza un provider di identità esterno che funziona indipendentemente da IAM Identity Center, scopri come ottenere credenziali temporanee da utilizzare con l'SDK for Java. Segui [queste istruzioni](#setup-temp-creds) per aggiungere credenziali temporanee al file. `~/.aws/credentials` Se il tuo provider di identità aggiunge automaticamente credenziali temporanee al `~/.aws/credentials` file, assicurati che il nome del profilo sia `[default]` tale da non dover fornire un nome di profilo all'SDK o. AWS CLI ## Capacità di accesso al portale di accesso AWS Il portale di AWS accesso è il luogo web in cui è possibile accedere manualmente allo IAM Identity Center. Il formato dell'URL è `d-xxxxxxxxxx.awsapps.com/start` o`your_subdomain.awsapps.com/start`. Se non conosci il portale di AWS accesso, segui le linee guida per l'accesso all'account nella [fase 1 dell'argomento sull'autenticazione di IAM Identity Center](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html#idcGettingStarted) nella guida di riferimento AWS SDKs e agli strumenti. Non seguite lo Step 2 perché la versione AWS SDK per Java 1.x non supporta l'aggiornamento automatico dei token e il recupero automatico delle credenziali temporanee per l'SDK descritto nella Fase 2. ## Configura file di configurazione condivisi I file di configurazione condivisi risiedono sulla workstation di sviluppo e contengono le impostazioni di base utilizzate da tutti AWS SDKs e dalla ( AWS Command Line Interface CLI). I file [di configurazione condivisi possono contenere diverse impostazioni](https://docs.aws.amazon.com/sdkref/latest/guide/settings-reference.html), ma queste istruzioni configurano gli elementi di base necessari per lavorare con l'SDK. ### Configura il file condiviso `config` L'esempio seguente mostra il contenuto di un `config` file condiviso. ``` [default] region=us-east-1 output=json ``` Per scopi di sviluppo, utilizzate il codice Regione AWS [più vicino](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/) al punto in cui intendete eseguire il codice. Per un [elenco dei codici regionali](https://docs.aws.amazon.com/general/latest/gr/rande.html#region-names-codes) da utilizzare nel `config` file, consulta la Riferimenti generali di Amazon Web Services guida. L'`json`impostazione per il formato di output è uno dei [diversi valori possibili](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html). Segui le indicazioni riportate [in questa sezione](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html) per creare il `config` file. ### Imposta le credenziali temporanee per l'SDK Dopo aver avuto accesso a un Account AWS ruolo IAM tramite il portale di AWS accesso, configura il tuo ambiente di sviluppo con credenziali temporanee per l'accesso all'SDK. **Passaggi per configurare un `credentials` file locale con credenziali temporanee** 1. [Crea un `credentials` file condiviso](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html). 1. Nel `credentials` file, incolla il seguente testo segnaposto finché non inserisci le credenziali temporanee di lavoro. ``` [default] aws_access_key_id= aws_secret_access_key= aws_session_token= ``` 1. Salvare il file. Il file `~/.aws/credentials` dovrebbe ora esistere sul tuo sistema di sviluppo locale. Questo file contiene il [profilo [predefinito]](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile) utilizzato dall'SDK for Java se non viene specificato un profilo denominato specifico. 1. [Accedere al portale di AWS accesso](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosignin.html). 1. Segui queste istruzioni sotto l'intestazione [Aggiornamento manuale delle credenziali](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtogetcredentials.html#how-to-get-temp-credentials) per copiare le credenziali del ruolo IAM dal AWS portale di accesso. 1. Per la fase 4 delle istruzioni collegate, scegli il nome del ruolo IAM che concede l'accesso per le tue esigenze di sviluppo. Questo ruolo in genere ha un nome simile **PowerUserAccess**a **Developer**. 1. Per il passaggio 7, seleziona l'opzione **Aggiungi manualmente un profilo al file delle AWS credenziali** e copia il contenuto. 1. Incolla le credenziali copiate nel `credentials` file locale e rimuovi qualsiasi nome di profilo che è stato incollato. Il file dovrebbe essere simile al seguente: ``` [default] aws_access_key_id=AKIAIOSFODNN7EXAMPLE aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY aws_session_token=IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE ``` 1. Salvate il file `credentials` L'SDK for Java accederà a queste credenziali temporanee quando creerà un client di servizio e le utilizzerà per ogni richiesta. Le impostazioni per il ruolo IAM scelto nella fase 5a [determinano la durata di validità delle credenziali temporanee](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosessionduration.html). La durata massima è di dodici ore. Dopo la scadenza delle credenziali temporanee, ripeti i passaggi da 4 a 7. ## Installare un ambiente di sviluppo Java La versione AWS SDK per Java V1 richiede un JDK Java 7 o versione successiva e sono supportate tutte le versioni JDK di Java LTS (supporto a lungo termine). Se si utilizza la versione 1.12.767 o precedente dell'SDK, è possibile utilizzare Java 7, ma se si utilizza la versione 1.12.768 o successiva dell'SDK, è necessario Java 8. L'[archivio centrale di Maven](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom) elenca l'ultima versione dell'SDK for Java. AWS SDK per Java [Funziona con l'[Oracle Java SE Development Kit](https://www.oracle.com/java/technologies/downloads/) e con le distribuzioni di Open Java Development Kit (OpenJDK) come [Amazon Corretto](https://aws.amazon.com/corretto)[, Red](https://developers.redhat.com/products/openjdk/overview) Hat OpenJDK e Adoptium.](https://adoptium.net/) # Modi per ottenere il AWS SDK per Java ## Prerequisiti Per utilizzare il AWS SDK per Java, devi avere: + Devi essere in grado di [accedere al portale di AWS accesso](signup-create-iam-user.md#setup-awsaccount) disponibile in AWS IAM Identity Center. + Un'[installazione adeguata di Java](signup-create-iam-user.md#java-dg-java-env). + Credenziali temporanee configurate nel `credentials` file condiviso locale. Consulta l'[Configurazione di base con cui lavorare Servizi AWS](signup-create-iam-user.md)argomento per istruzioni su come configurare l'uso dell'SDK for Java. ## Usa uno strumento di compilazione per gestire le dipendenze per l'SDK for Java (consigliato) Ti consigliamo di utilizzare Apache Maven o Gradle con il tuo progetto per accedere alle dipendenze richieste dell'SDK for Java. [ Questa sezione](setup-build-tools.md) descrive come utilizzare questi strumenti. ## Scarica ed estrai l'SDK (scelta non consigliata) Ti consigliamo di utilizzare uno strumento di compilazione per accedere all'SDK del tuo progetto. Puoi, tuttavia, scaricare un jar predefinito dell'ultima versione dell'SDK. **Nota** Per informazioni su come scaricare e creare versioni precedenti dell'SDK, consulta [Installazione delle versioni precedenti](#install-prev-sdk) dell'SDK. 1. [Scarica l'SDK da .zip. https://sdk-for-java.amazonwebservices.com/latest/ aws-java-sdk](https://sdk-for-java.amazonwebservices.com/latest/aws-java-sdk.zip) 1. Dopo aver scaricato l'SDK, estrai i contenuti in una directory locale. L'SDK contiene le seguenti directory: + `documentation`- contiene la documentazione dell'API (disponibile anche sul Web: [AWS SDK per Java API Reference](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/)). + `lib`- contiene i `.jar` file SDK. + `samples`- contiene un codice di esempio funzionante che dimostra come utilizzare l'SDK. + `third-party/lib`- contiene librerie di terze parti utilizzate dall'SDK, come Apache commons logging, AspectJ e il framework Spring. Per utilizzare l'SDK, aggiungi il percorso completo `lib` e le `third-party` directory alle dipendenze nel tuo file di build e aggiungile al tuo java per eseguire il codice. `CLASSPATH` ## Crea versioni precedenti dell'SDK dal codice sorgente (scelta non consigliata) Solo la versione più recente dell'SDK completo viene fornita in forma predefinita come jar scaricabile. Tuttavia, puoi creare una versione precedente dell'SDK utilizzando Apache Maven (open source). Maven scaricherà tutte le dipendenze necessarie, creerà e installerà l'SDK in un unico passaggio. Visita [http://maven.apache.org/](http://maven.apache.org/) per istruzioni di installazione e ulteriori informazioni. 1. Vai alla GitHub pagina dell'SDK all'indirizzo: [AWS SDK per Java (GitHub).](https://github.com/aws/aws-sdk-java) 1. Scegli il tag corrispondente al numero di versione dell'SDK che desideri. Ad esempio, `1.6.10`. 1. Fai clic sul pulsante **Scarica ZIP** per scaricare la versione dell'SDK selezionata. 1. Decomprimi il file in una directory del tuo sistema di sviluppo. Su molti sistemi, è possibile utilizzare il gestore di file grafico per eseguire questa operazione o utilizzare l'`unzip`utilità in una finestra di terminale. 1. In una finestra di terminale, accedi alla directory in cui hai decompresso il codice sorgente dell'SDK. 1. [Compila e installa l'SDK con il seguente comando (è richiesto Maven):](https://maven.apache.org/) ``` mvn clean install -Dgpg.skip=true ``` Il file `.jar` risultante viene creato nella directory `target`. 1. (Facoltativo) Crea la documentazione di riferimento dell'API utilizzando il seguente comando: ``` mvn javadoc:javadoc ``` La documentazione è incorporata nella `target/site/apidocs/` directory. # Usa gli strumenti di costruzione L'uso di strumenti di compilazione aiuta a gestire lo sviluppo di progetti Java. Sono disponibili diversi strumenti di compilazione, ma mostriamo come iniziare a usare due strumenti di compilazione popolari: Maven e Gradle. Questo argomento mostra come utilizzare questi strumenti di compilazione per gestire le dipendenze SDK for Java necessarie per i tuoi progetti. **Topics** + [ # Utilizzare gli SDK con Apache Maven ](setup-project-maven.md) + [ # Utilizzare gli SDK con Gradle ](setup-project-gradle.md) # Utilizzare gli SDK con Apache Maven Puoi usare [Apache Maven](https://maven.apache.org/) per configurare e creare AWS SDK per Java progetti o per creare l'SDK stesso. **Nota** Per utilizzare le linee guida in questo argomento è necessario che sia installato Maven. Se non è già installato, visita [http://maven.apache.org/](http://maven.apache.org/) per scaricarlo e installarlo. ## Crea un nuovo pacchetto Maven Per creare un pacchetto Maven di base, apri una finestra di terminale (riga di comando) ed esegui: ``` mvn -B archetype:generate \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DgroupId=org.example.basicapp \ -DartifactId=myapp ``` Sostituisci *org.example.basicapp* con lo spazio dei nomi completo del pacchetto della tua applicazione e *myapp* con il nome del tuo progetto (questo diventerà il nome della directory del tuo progetto). Per impostazione predefinita, crea un modello di progetto utilizzando l'archetipo [quickstart, che è un buon punto di partenza](http://maven.apache.org/archetypes/maven-archetype-quickstart/) per molti progetti. Sono disponibili altri archetipi; visita la pagina degli archetipi di [Maven per un elenco degli archetipi inclusi](https://maven.apache.org/archetypes/index.html). Può scegliere un determinato archetipo da utilizzare aggiungendo l'argomento `-DarchetypeArtifactId` al comando `archetype:generate`. Per esempio: ``` mvn archetype:generate \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DarchetypeArtifactId=maven-archetype-webapp \ -DgroupId=org.example.webapp \ -DartifactId=mywebapp ``` **Nota** [Molte altre informazioni sulla creazione e la configurazione dei progetti sono disponibili nella Maven Getting Started Guide.](https://maven.apache.org/guides/getting-started/) ## Configura l'SDK come dipendenza Maven Per utilizzarlo AWS SDK per Java nel tuo progetto, dovrai dichiararlo come dipendenza nel file del tuo progetto. `pom.xml` [A partire dalla versione 1.9.0, puoi importare [singoli componenti](#configuring-maven-individual-components) o l'intero SDK.](#configuring-maven-entire-sdk) ### Specificazione di singoli moduli SDK Per selezionare singoli moduli SDK, utilizza la AWS SDK per Java distinta base (BOM) per Maven, che garantirà che i moduli specificati utilizzino la stessa versione dell'SDK e siano compatibili tra loro. Per utilizzare il BOM, aggiungi una `` sezione al `pom.xml` file dell'applicazione, aggiungendola `aws-java-sdk-bom` come dipendenza e specificando la versione dell'SDK che desideri utilizzare: ``` com.amazonaws aws-java-sdk-bom 1.11.1000 pom import ``` [Per visualizzare l'ultima versione della distinta base disponibile su AWS SDK per Java Maven Central, visita: com.amazonaws/. https://mvnrepository.com/artifact/ aws-java-sdk-bom](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom) Puoi anche utilizzare questa pagina per vedere quali moduli (dipendenze) sono gestiti dal BOM che puoi includere nella sezione del file del tuo progetto. `` `pom.xml` Ora puoi selezionare singoli moduli dall'SDK che usi nella tua applicazione. Poiché la versione SDK è già stata dichiarata nella distinta base, non è necessario specificare il numero di versione di ogni componente. ``` com.amazonaws aws-java-sdk-s3 com.amazonaws aws-java-sdk-dynamodb ``` Puoi anche fare riferimento a per * AWS Code Sample Catalog *scoprire quali dipendenze usare per un determinato periodo. Servizio AWS Fare riferimento al file POM in un esempio di servizio specifico. Ad esempio, se sei interessato alle dipendenze per il servizio AWS S3, consulta l'esempio [completo](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/java/example_code/s3/src/main/java/aws/example/s3/GetAcl.java) su. GitHub (Guardate il pom 3). under /java/example\$1code/s ### Importazione di tutti i moduli SDK Se desideri inserire l'*intero* SDK come dipendenza, non utilizzare il metodo BOM, ma dichiaralo semplicemente nel tuo modo: `pom.xml` ``` com.amazonaws aws-java-sdk 1.11.1000 ``` ## Creare il progetto Una volta impostato il progetto, puoi crearlo usando il comando di Maven: `package` ``` mvn package ``` Questo creerà il tuo `–0—jar` file nella `target` directory. ## Crea l'SDK con Maven Puoi usare Apache Maven per creare l'SDK dal codice sorgente. Per fare ciò, [scarica il codice SDK da](https://github.com/aws/aws-sdk-java), decomprimilo localmente GitHub, quindi esegui il seguente comando Maven: ``` mvn clean install ``` # Utilizzare gli SDK con Gradle Per gestire le dipendenze SDK per il tuo progetto [Gradle](https://gradle.com/), importa la BOM Maven per the nel file dell'applicazione. AWS SDK per Java `build.gradle` **Nota** Negli esempi seguenti, sostituisci *1.12.529* nel file di build con una versione valida di. AWS SDK per Java Trova la versione più recente nel repository [centrale di Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest). ## Configurazione del progetto per Gradle 4.6 o versioni successive A [partire da Gradle 4.6](https://docs.gradle.org/4.6/release-notes.html#bom-import), è possibile utilizzare la funzionalità di supporto POM migliorata di Gradle per importare file BOM (Bill of Materials) dichiarando una dipendenza da una BOM. 1. Se stai usando Gradle 5.0 o versioni successive, vai al passaggio 2. Altrimenti, abilita la funzione *IMPROVED\$1POM\$1SUPPORT* nel file. `settings.gradle` ``` enableFeaturePreview('IMPROVED_POM_SUPPORT') ``` 1. Aggiungete il BOM alla sezione delle *dipendenze del file dell'applicazione*. `build.gradle` ``` ... dependencies { implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529') // Declare individual SDK dependencies without version ... } ``` 1. Specifica i moduli SDK da utilizzare nella sezione *dipendenze*. Ad esempio, quanto segue include una dipendenza per Amazon Simple Storage Service ().Amazon S3 ``` ... dependencies { implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529') implementation 'com.amazonaws:aws-java-sdk-s3' ... } ``` Gradle risolve automaticamente la versione corretta delle dipendenze SDK utilizzando le informazioni della distinta base. Di seguito è riportato un esempio di `build.gradle` file completo che include una dipendenza per. Amazon S3 ``` group 'aws.test' version '1.0-SNAPSHOT' apply plugin: 'java' sourceCompatibility = 1.8 repositories { mavenCentral() } dependencies { implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529') implementation 'com.amazonaws:aws-java-sdk-s3' } ``` **Nota** Nell'esempio precedente, sostituite la dipendenza per Amazon S3 con le dipendenze dei AWS servizi che utilizzerete nel progetto. [I moduli (dipendenze) gestiti dalla AWS SDK per Java BOM sono elencati nell'archivio centrale di Maven.](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest) ## Configurazione del progetto per le versioni di Gradle precedenti alla 4.6 Le versioni di Gradle precedenti alla 4.6 non dispongono del supporto BOM nativo. Per gestire AWS SDK per Java le dipendenze del tuo progetto, usa il [plug-in di gestione delle dipendenze](https://github.com/spring-gradle-plugins/dependency-management-plugin) di Spring per Gradle per importare la BOM Maven per l'SDK. 1. Aggiungi il plug-in di gestione delle dipendenze al file dell'applicazione. `build.gradle` ``` buildscript { repositories { mavenCentral() } dependencies { classpath "io.spring.gradle:dependency-management-plugin:1.0.9.RELEASE" } } apply plugin: "io.spring.dependency-management" ``` 1. Aggiungere la distinta base alla sezione *dependencyManagement* del file. ``` dependencyManagement { imports { mavenBom 'com.amazonaws:aws-java-sdk-bom:1.12.529' } } ``` 1. Specificate i moduli SDK che utilizzerete nella sezione delle *dipendenze*. Ad esempio, quanto riportato di seguito include una dipendenza per Amazon S3. ``` dependencies { compile 'com.amazonaws:aws-java-sdk-s3' } ``` Gradle risolve automaticamente la versione corretta delle dipendenze SDK utilizzando le informazioni della distinta base. Di seguito è riportato un esempio di `build.gradle` file completo che include una dipendenza per. Amazon S3 ``` group 'aws.test' version '1.0' apply plugin: 'java' sourceCompatibility = 1.8 repositories { mavenCentral() } buildscript { repositories { mavenCentral() } dependencies { classpath "io.spring.gradle:dependency-management-plugin:1.0.9.RELEASE" } } apply plugin: "io.spring.dependency-management" dependencyManagement { imports { mavenBom 'com.amazonaws:aws-java-sdk-bom:1.12.529' } } dependencies { compile 'com.amazonaws:aws-java-sdk-s3' testCompile group: 'junit', name: 'junit', version: '4.11' } ``` **Nota** Nell'esempio precedente, sostituite la dipendenza per Amazon S3 con le dipendenze del AWS servizio che utilizzerete nel progetto. [I moduli (dipendenze) gestiti dalla AWS SDK per Java BOM sono elencati nell'archivio centrale di Maven.](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest) [Per ulteriori informazioni sulla specificazione delle dipendenze dell'SDK utilizzando il BOM, consulta Uso dell'SDK con Apache Maven.](setup-project-maven.md) # Imposta credenziali AWS temporanee e Regione AWS per lo sviluppo Per connettersi a uno qualsiasi dei servizi supportati con AWS SDK per Java, è necessario fornire credenziali AWS temporanee. AWS SDKs E CLIs utilizzano le *catene di provider* per cercare credenziali AWS temporanee in diversi punti, tra cui variabili di system/user ambiente e file di AWS configurazione locali. Questo argomento fornisce informazioni di base sulla configurazione delle credenziali AWS temporanee per lo sviluppo di applicazioni locali tramite. AWS SDK per Java Se devi configurare le credenziali da utilizzare all'interno di un'istanza EC2 o se utilizzi l'IDE Eclipse per lo sviluppo, consulta invece i seguenti argomenti: + Quando usi un'istanza EC2, crea un ruolo IAM e poi consenti all'istanza EC2 di accedere a quel ruolo, come mostrato in [Using IAM Roles to Grant Access to Resources](java-dg-roles.md) on. AWS Amazon EC2 + Configura AWS le credenziali all'interno di Eclipse utilizzando. [AWS Toolkit for Eclipse](https://aws.amazon.com/eclipse/) Per ulteriori informazioni, consulta [Configurare AWS le credenziali](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/setup-credentials.html) nella [Guida per AWS Toolkit for Eclipse l'utente](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/). ## Configurare le credenziali temporanee È possibile configurare le credenziali temporanee per i AWS SDK per Java in diversi modi, ma di seguito sono riportati gli approcci consigliati: + Impostate le credenziali temporanee nel file di profilo delle AWS credenziali sul sistema locale, che si trova in: + `~/.aws/credentials` su Linux, macOS o Unix + `C:\Users\USERNAME\.aws\credentials` in Windows Per istruzioni su come ottenere le [Imposta le credenziali temporanee per l'SDK](signup-create-iam-user.md#setup-temp-creds) credenziali temporanee, consulta questa guida. + Imposta le variabili `AWS_ACCESS_KEY_ID``AWS_SECRET_ACCESS_KEY`, e di `AWS_SESSION_TOKEN` ambiente. Per impostare queste variabili su Linux, macOS o Unix, utilizza : ``` export AWS_ACCESS_KEY_ID=your_access_key_id export AWS_SECRET_ACCESS_KEY=your_secret_access_key export AWS_SESSION_TOKEN=your_session_token ``` Per impostare queste variabili su Windows, utilizza : ``` set AWS_ACCESS_KEY_ID=your_access_key_id set AWS_SECRET_ACCESS_KEY=your_secret_access_key set AWS_SESSION_TOKEN=your_session_token ``` + Per un'istanza di EC2, specificare un ruolo IAM e concedere all'istanza EC2 l'accesso a tale ruolo. Consulta [IAM Roles Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html) nella Guida per Amazon EC2 l'utente delle istanze Linux per una discussione dettagliata su come funziona. Dopo aver impostato le credenziali AWS temporanee utilizzando uno di questi metodi, queste verranno caricate automaticamente AWS SDK per Java dalla catena di fornitori di credenziali predefinita. Per ulteriori informazioni sull'utilizzo delle AWS credenziali nelle applicazioni Java, consultate [Lavorare](credentials.md) con le credenziali. AWS ## Aggiornamento delle credenziali IMDS AWS SDK per Java Supporta l'aggiornamento facoltativo delle credenziali IMDS in background ogni 1 minuto, indipendentemente dalla data di scadenza delle credenziali. Ciò consente di aggiornare le credenziali più frequentemente e riduce la possibilità che il mancato accesso all'IMDS influisca sulla disponibilità percepita. AWS ``` 1. // Refresh credentials using a background thread, automatically every minute. This will log an error if IMDS is down during 2. // a refresh, but your service calls will continue using the cached credentials until the credentials are refreshed 3. // again one minute later. 4. 5. InstanceProfileCredentialsProvider credentials = 6. InstanceProfileCredentialsProvider.createAsyncRefreshingProvider(true); 7. 8. AmazonS3Client.builder() 9. .withCredentials(credentials) 10. .build(); 11. 12. // This is new: When you are done with the credentials provider, you must close it to release the background thread. 13. credentials.close(); ``` ## Imposta il Regione AWS È necessario impostare un valore predefinito Regione AWS che verrà utilizzato per accedere ai AWS servizi con AWS SDK per Java. Per ottimizzare le prestazioni di rete, scegliere una regione geograficamente vicina alla propria posizione (o ai clienti). Per un elenco delle regioni per ogni servizio, consulta [Regioni ed endpoint](https://docs.aws.amazon.com/general/latest/gr/rande.html) nel Riferimento Amazon Web Services generale. **Nota** Se *non* si seleziona una regione, per impostazione predefinita verrà utilizzato us-east-1. Puoi utilizzare tecniche simili per impostare le credenziali per impostare la tua regione predefinita: AWS + Imposta il Regione AWS file di AWS configurazione sul tuo sistema locale, che si trova in: + \$1/.aws/config su Linux, macOS o Unix + C:\$1Users\$1USERNAME\$1 .aws\$1 config su Windows Questo file deve contenere righe nel seguente formato: \$1 ``` [default] region = your_aws_region ``` \$1 *Sostituisci il valore desiderato Regione AWS (ad esempio, «us-east-1") con your\$1aws\$1region.* + Imposta la variabile di ambiente `AWS_REGION`. Su Linux, macOS o Unix, usa: **``** ``` export AWS_REGION=your_aws_region ``` In Windows, utilizza ** `` **: ``` set AWS_REGION=your_aws_region ``` Dove *your\$1aws\$1region* è il nome desiderato. Regione AWS