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

# Inizia con AWS SDK per Go
<a name="getting-started"></a>

 AWS SDK per Go Richiede una versione minima di Go 1.23. È possibile visualizzare la versione corrente di Go eseguendo il seguente comando: 

```
go version
```

 Per informazioni sull'installazione o l'aggiornamento della tua versione di Go, consulta [Download e installazione nella documentazione](https://go.dev/doc/install) di Go. 

## Crea un account Amazon
<a name="get-an-amazon-account"></a>

 Prima di poter utilizzare la AWS SDK per Go versione 2, devi disporre di un account Amazon. Per ulteriori informazioni, consulta [Creare un AWS account](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-creating.html). 

## Installa la AWS SDK per Go v2
<a name="install-the-aws-sdk-for-go-v2"></a>

 La AWS SDK per Go v2 utilizza i moduli Go, una funzionalità introdotta in Go 1.11. Inizializza il tuo progetto locale eseguendo il seguente comando Go. 

```
go mod init example
```

 Dopo aver inizializzato il progetto del modulo Go, sarai in grado di recuperare l'SDK e le sue dipendenze richieste utilizzando il comando. `go get` Queste dipendenze verranno registrate nel `go.mod` file creato dal comando precedente. 

 I comandi seguenti mostrano come recuperare il set standard di moduli SDK da utilizzare nell'applicazione. 

```
go get github.com/aws/aws-sdk-go-v2
go get github.com/aws/aws-sdk-go-v2/config
```

 Questo recupererà il modulo SDK principale e il modulo di configurazione utilizzato per caricare la configurazione condivisa. AWS 

 Successivamente puoi installare uno o più client API AWS di servizio richiesti dall'applicazione. Tutti i client API si trovano nella gerarchia di `github.com/aws/aws-sdk-go-v2/service` importazione. Un set completo di client API attualmente supportati è disponibile [qui](https://pkg.go.dev/github.com/aws/aws-sdk-go-v2/service). Per installare un client di servizio, esegui il seguente comando per recuperare il modulo e registrare la dipendenza nel file`go.mod`. In questo esempio recuperiamo il client API Amazon S3. 

```
go get github.com/aws/aws-sdk-go-v2/service/s3
```

## Ottieni le tue AWS chiavi di accesso
<a name="get-your-aws-access-keys"></a>

 Le chiavi di accesso sono composte da un ID chiave di accesso e una chiave di accesso segreta che sono utilizzati per firmare le richieste programmatiche eseguite verso AWS. Se non disponi delle chiavi di accesso, puoi crearle utilizzando la [Console di AWS gestione](https://console.aws.amazon.com/console/home). Ti consigliamo di utilizzare le chiavi di accesso IAM anziché le chiavi di accesso all'account AWS root. IAM ti consente di controllare in modo sicuro l'accesso ai AWS servizi e alle risorse del tuo AWS account. 

**Nota**  
Per creare le chiavi delle credenziali d'accesso, bisogna disporre delle autorizzazioni per effettuare le operazioni richieste dalle azioni IAM. Per ulteriori informazioni, consulta [Autorizzazioni necessarie per accedere alle risorse IAM nella Guida](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_permissions-required.html) per l'utente IAM. 

### Per ottenere l'ID della chiave di accesso e la chiave di accesso segreta.
<a name="to-get-your-access-key-id-and-secret-access-key"></a>

1.  Apri la [console IAM](https://console.aws.amazon.com/iam/home). 

1.  Nel menu di navigazione, scegliere **Users (Utenti)**. 

1.  Selezionare il tuo nome utente IAM; (non la casella di spunta). 

1.  Aprire la scheda **Security credentials (Credenziali di sicurezza)** e quindi scegliere **Create access key (Crea chiave di accesso)**. 

1.  Per visualizzare la nuova chiave di accesso, seleziona **Show** (Mostra). Le credenziali sono simili ai seguenti: 
   +  ID chiave di accesso: `AKIAIOSFODNN7EXAMPLE` 
   +  Chiave di accesso segreta `wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY` 

1.  Per fare il download della coppia di chiavi, scegliere **Download .csv file**. Conserva le chiavi in un posto sicuro. 

**avvertimento**  
 Mantieni riservate le chiavi per proteggere il tuo AWS account e non condividerle mai con nessuno al di fuori dell'organizzazione. 

### Argomenti correlati
<a name="related-topics"></a>
+  [Che cos'è IAM?](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html) nella Guida per l'utente di IAM. 
+  [AWS Credenziali di sicurezza](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) in Amazon Web Services General Reference. 

## Richiama un'operazione
<a name="invoke-an-operation"></a>

 Dopo aver installato l'SDK, importi AWS i pacchetti nelle tue applicazioni Go per utilizzare l'SDK, come mostrato nell'esempio seguente, che importa le librerie, AWS Config e Amazon S3. Dopo aver importato i pacchetti SDK, viene caricata la configurazione condivisa dell' AWS SDK, viene creato un client e viene richiamata un'operazione API. 

```
package main

import (
    "context"
    "log"
    "github.com/aws/aws-sdk-go-v2/aws"
    "github.com/aws/aws-sdk-go-v2/config"
    "github.com/aws/aws-sdk-go-v2/service/s3"
)

func main() {
    // Load the Shared AWS Configuration (~/.aws/config)
    cfg, err := config.LoadDefaultConfig(context.TODO())
    if err != nil {
        log.Fatal(err)
    }

    // Create an Amazon S3 service client
    client := s3.NewFromConfig(cfg)

    // Get the first page of results for ListObjectsV2 for a bucket
    output, err := client.ListObjectsV2(context.TODO(), &s3.ListObjectsV2Input{
        Bucket: aws.String("amzn-s3-demo-bucket"),
    })
    if err != nil {
        log.Fatal(err)
    }

    log.Println("first page results")
    for _, object := range output.Contents {
        log.Printf("key=%s size=%d", aws.ToString(object.Key), *object.Size)
    }
}
```