

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 di Amazon Kinesis Data Streams a un bucket Amazon S3 generico. Puoi creare una consegna con o con. Console di gestione AWS AWS CLI I record vengono consegnati nel loro formato sorgente, raggruppati in oggetti di dimensioni ottimali, con compressione configurabile e una struttura chiave 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 distribuzione 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 ** Create delivery. **

1. **Fase 1: Configurazione del codice sorgente. ** In Dettagli ** spedizione**, inserisci un nome ** di spedizione**. Per ** Source**, scegli lo On-Demand stream da cui effettuare la spedizione. 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 previsto del bucket.
   + **Tipo di compressione**: scegli ** GZIP**, ** ZSTD o Nessuno. ** ** **
   + **Classe di archiviazione**: opzionalmente, scegli una classe di archiviazione 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).
   + **Aggiornamento 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 di lettere morte opzionale, la consegna dei log e i tag. Scegli **Avanti**.

1. **Fase 4: Rivedi e crea. ** Rivedi la tua configurazione, quindi scegli ** Crea spedizione**. La consegna passa da CREATING a ACTIVE una volta completato il provisioning.

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

 Usa il `create-channel` comando per creare una consegna Amazon S3 che invii 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::123456789012:role/my-channel-role" \
    --stream-configuration-list '[
        {
            "StreamARN": "arn:aws:kinesis:us-east-1:123456789012:stream/my-stream",
            "RecordConfiguration": {
                "RecordFormatType": "JSON"
            }
        }
    ]' \
    --s3-destination-configuration '{
        "DataFreshnessInSeconds": 300,
        "StorageConfiguration": {
            "BucketARN": "arn:aws:s3:::my-destination-bucket",
            "ExpectedBucketOwner": "123456789012",
            "CompressionType": "GZIP",
            "StorageClass": "STANDARD"
        }
    }'
```

 Il comando restituisce il canale ARN (). `ChannelARN` Usalo 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 API**: consulta il riferimento `CreateChannel` alle API di * Amazon Kinesis Data Streams. * 