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

# Crea una consegna Amazon S3
<a name="data-delivery-s3-create"></a>

 Crea una distribuzione che invii i record da un flusso Amazon Kinesis Data Streams a un bucket Amazon S3 generico. Puoi creare una consegna con o. Console di gestione AWS AWS CLI I record vengono forniti nel loro formato sorgente, raggruppati in oggetti di dimensioni ottimali, con compressione configurabile e una struttura di chiavi S3 definita dall'utente. 

**Nota**  
 Prima di creare una distribuzione, completa i prerequisiti in[Guida introduttiva alla distribuzione generica di S3](data-delivery-s3-getting-started.md), incluso il ruolo di esecuzione del servizio IAM descritto in. [Autorizzazioni IAM per la consegna dei dati](data-delivery-iam.md) 

## Utilizzo di Console di gestione AWS
<a name="data-delivery-s3-create-console"></a>

1. Apri la console Kinesis all'indirizzo. [https://console.aws.amazon.com/kinesis](https://console.aws.amazon.com/kinesis)

1. Nel pannello di navigazione, scegli **S3 General Purpose Delivery, quindi scegli **Crea** consegna**.

1. **Fase 1: Configurazione del codice sorgente.** In **Dettagli di consegna**, inserisci un **nome di consegna**. Per **Source**, scegli lo On-Demand stream da cui effettuare la trasmissione. Vengono visualizzati solo On-Demand gli stream. Scegli **Avanti**.

1. **Fase 2: Configurazione della destinazione.** Scegliete un **formato di registrazione** (**JSON**, **STRING** o **BYTE\_ARRAY**), quindi specificate la destinazione:
   + ARN del **bucket S3: l'ARN** del bucket Amazon S3 generico di destinazione.
   + Proprietario **previsto del bucket: l'ID a 12 Account AWS cifre del proprietario** del bucket previsto.
   + **Tipo di compressione** ****: scegli **GZIP, ZSTD** o Nessuno.****
   + **Classe di storage**: opzionalmente scegli una classe di storage Amazon S3.
   + **Modello di chiave di output**: definisci facoltativamente la struttura chiave dell'oggetto Amazon S3. Per informazioni dettagliate, vedi [Modello di chiave di output S3 per la consegna di Amazon S3](data-delivery-s3-key-template.md).
   + **Freschezza dei dati**: il tempo massimo di buffering in secondi prima della consegna dei record (minimo 300, massimo 900).

   Scegli **Avanti**.

1. **Fase 3: Configurazione aggiuntiva.** Configura la crittografia, l'accesso al servizio (il ruolo IAM), una coda opzionale di lettere non scritte, la consegna dei log e i tag. Scegli **Avanti**.

1. **Fase 4: Rivedi e crea.** Controlla la configurazione, quindi scegli **Crea consegna**. La consegna passa da CREATING a ACTIVE dopo il completamento del provisioning.

## Utilizzo di AWS CLI
<a name="data-delivery-s3-create-cli"></a>

 Usa il `create-channel` comando per creare una distribuzione Amazon S3 che invii i record a un bucket Amazon S3 generico con formato JSON e compressione GZIP: 

```
aws kinesis create-channel \
    --channel-name "my-s3-delivery" \
    --service-execution-role-arn "arn:aws:iam::111122223333:role/my-channel-role" \
    --stream-configuration-list '[
        {
            "StreamARN": "arn:aws:kinesis:us-east-1:111122223333:stream/my-stream",
            "RecordConfiguration": {
                "RecordFormatType": "JSON"
            }
        }
    ]' \
    --s3-destination-configuration '{
        "DataFreshnessInSeconds": 300,
        "StorageConfiguration": {
            "BucketARN": "arn:aws:s3:::amzn-s3-demo-destination-bucket",
            "ExpectedBucketOwner": "111122223333",
            "CompressionType": "GZIP",
            "StorageClass": "STANDARD"
        }
    }'
```

 Il comando restituisce il canale ARN ()`ChannelARN`. Utilizzatelo con `describe-channel` per verificare che la consegna raggiunga lo stato ATTIVO. Consulta [Descrivi una consegna Amazon S3](data-delivery-s3-describe.md). Per personalizzare la struttura delle chiavi degli oggetti di Amazon S3, consulta. [Modello di chiave di output S3 per la consegna di Amazon S3](data-delivery-s3-key-template.md) 

 **Riferimento all'API**: `CreateChannel` consulta il riferimento all'API *Amazon Kinesis Data Streams*.