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 di comandi a livello di API (s3api) in AWS CLI
<a name="cli-services-s3-apicommands"></a>

I comandi a livello di API (contenuti nel set di `s3api` comandi) forniscono l'accesso diretto ad Amazon Simple Storage Service (Amazon APIs S3) e abilitano alcune operazioni che non sono esposte nei comandi di alto livello. `s3` Questi comandi sono equivalenti agli altri servizi AWS che forniscono l'accesso a livello di API alle funzionalità dei servizi. Per ulteriori informazioni sui comandi `s3`, consulta [Utilizzo di comandi di alto livello (s3) in AWS CLI](cli-services-s3-commands.md)

Questo argomento fornisce esempi che dimostrano come utilizzare i comandi di livello inferiore mappati ad Amazon S3. APIs Inoltre, puoi trovare esempi per ogni comando dell'API S3 nella `s3api` sezione della guida di riferimento, [versione](https://docs.aws.amazon.com/cli/latest/reference/s3api/index.html) 2.

**Topics**
+ [Prerequisiti](#cli-services-s3-apicommands-prereqs)
+ [Applicazione di una lista di controllo accessi (ACL) personalizzata](#cli-services-s3-apicommands-acls)
+ [Configurazione di una policy di registrazione](#cli-services-s3-apicommands-logpol)
+ [Resources](#cli-services-s3-apicommands-resources)

## Prerequisiti
<a name="cli-services-s3-apicommands-prereqs"></a>

Per eseguire i comandi `s3api`, è necessario:
+ Istalla e configura la AWS CLI. Per ulteriori informazioni, consultare [Installazione o aggiornamento alla versione più recente di AWS CLI](getting-started-install.md) e [Credenziali di autenticazione e accesso per AWS CLI](cli-chap-authentication.md).
+ Il profilo che utilizzi deve disporre di autorizzazioni che consentano le AWS operazioni eseguite dagli esempi.
+ Glossario dei termini di Amazon S3:
  + **Bucket**: cartella Amazon S3 di primo livello.
  + **Prefisso**: una cartella Amazon S3 in un bucket.
  + **Oggetto**: qualsiasi elemento ospitato in un bucket Amazon S3.

## Applicazione di una lista di controllo accessi (ACL) personalizzata
<a name="cli-services-s3-apicommands-acls"></a>

Con i comandi di alto livello, puoi utilizzare l'`--acl`opzione per applicare elenchi di controllo degli accessi predefiniti (ACLs) agli oggetti Amazon S3. Ma non puoi usare quel comando per impostare bucket-wide. ACLs Tuttavia, puoi farlo utilizzando il comando ```[put-bucket-acl](https://docs.aws.amazon.com/cli/latest/reference/s3api/put-bucket-acl.html)` a livello di API. 

L'esempio seguente mostra come concedere il controllo completo a due AWS utenti (*user1@example.com* e *user2@example.com*) e il permesso di lettura a tutti. L'identificatore per "tutti" proviene da un URI speciale passato come parametro.

```
$ aws s3api put-bucket-acl --bucket {{amzn-s3-demo-bucket}} --grant-full-control 'emailaddress="{{user1@example.com}}",emailaddress="{{user2@example.com}}"' --grant-read 'uri="http://acs.amazonaws.com/groups/global/AllUsers"'
```

Per dettagli su come costruire il ACLs, consulta [PUT Bucket acl](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTacl.html) nel riferimento all'API di *Amazon Simple Storage Service*. I comandi ACL `s3api` nell'interfaccia a riga di comando, come `put-bucket-acl`, utilizzano la stessa [notazione di argomento abbreviata](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-shorthand.html).

## Configurazione di una policy di registrazione
<a name="cli-services-s3-apicommands-logpol"></a>

Il comando API `put-bucket-logging` configura una policy di registrazione di log dei bucket. 

Nell'esempio seguente, *all' AWS utente user@example.com* viene concesso il pieno controllo sui file di registro e tutti gli utenti hanno accesso in lettura ad essi. Nota che il comando `put-bucket-acl` è richiesto anche per concedere al sistema di distribuzione dei log di Amazon S3 (specificato da un URI) le autorizzazioni necessarie per leggere e scrivere i log nel bucket.

```
$ aws s3api put-bucket-acl --bucket {{amzn-s3-demo-bucket}} --grant-read-acp 'URI="http://acs.amazonaws.com/groups/s3/LogDelivery"' --grant-write 'URI="http://acs.amazonaws.com/groups/s3/LogDelivery"'
$ aws s3api put-bucket-logging --bucket {{amzn-s3-demo-bucket}} --bucket-logging-status file://logging.json
```

Il file `logging.json` nel comando precedente ha il seguente contenuto.

```
{
  "LoggingEnabled": {
    "TargetBucket": "amzn-s3-demo-bucket",
    "TargetPrefix": "amzn-s3-demo-bucketLogs/",
    "TargetGrants": [
      {
        "Grantee": {
          "Type": "AmazonCustomerByEmail",
          "EmailAddress": "{{user@example.com}}"
        },
        "Permission": "FULL_CONTROL"
      },
      {
        "Grantee": {
          "Type": "Group",
          "URI": "http://acs.amazonaws.com/groups/global/AllUsers"
        },
        "Permission": "READ"
      }
    ]
  }
}
```

## Resources
<a name="cli-services-s3-apicommands-resources"></a>

**AWS CLI riferimento:**
+ [https://docs.aws.amazon.com/cli/latest/reference/s3api/index.html](https://docs.aws.amazon.com/cli/latest/reference/s3api/index.html)
+ [https://docs.aws.amazon.com/cli/latest/reference/s3api/put-bucket-acl.html](https://docs.aws.amazon.com/cli/latest/reference/s3api/put-bucket-acl.html)
+ [https://docs.aws.amazon.com/cli/latest/reference/s3api/put-bucket-logging.html](https://docs.aws.amazon.com/cli/latest/reference/s3api/put-bucket-logging.html)

**Riferimento al servizio**:
+ [Utilizzo di bucket Amazon S3](https://docs.aws.amazon.com//AmazonS3/latest/userguide/UsingBucket.html) nella *Guida per l’utente di Amazon S3*
+ [Utilizzo di oggetti Amazon S3](https://docs.aws.amazon.com//AmazonS3/latest/userguide/UsingObjects.html) nella *Guida per l’utente di Amazon S3*
+ [Elenco gerarchico delle chiavi utilizzando un prefisso e un delimitatore](https://docs.aws.amazon.com//AmazonS3/latest/userguide/ListingKeysHierarchy.html) nella *Guida per l’utente di Amazon S3*
+ [https://docs.aws.amazon.com//AmazonS3/latest/userguide/LLAbortMPUnet.html](https://docs.aws.amazon.com//AmazonS3/latest/userguide/LLAbortMPUnet.html)