As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Crie uma entrega do Amazon S3
<a name="data-delivery-s3-create"></a>

 Crie uma entrega que envie registros de um stream do Amazon Kinesis Data Streams para um bucket do Amazon S3 de uso geral. Você pode criar uma entrega com o Console de gerenciamento da AWS ou AWS CLI o. Os registros são entregues em seu formato de origem, agrupados em objetos de tamanho ideal, com compactação configurável e uma estrutura de chaves do S3 que você define. 

**nota**  
 Antes de criar uma entrega, preencha os pré-requisitos em[Começando com a entrega de uso geral do S3](data-delivery-s3-getting-started.md), incluindo a função de execução do serviço IAM descrita em. [Permissões do IAM para entrega de dados](data-delivery-iam.md) 

## Usar o Console de gerenciamento da AWS
<a name="data-delivery-s3-create-console"></a>

1. Abra o console Kinesis em. [https://console.aws.amazon.com/kinesis](https://console.aws.amazon.com/kinesis)

1. No painel de navegação, escolha Entrega de uso geral do ** S3 e**, em seguida, escolha ** Criar entrega. **

1. **Etapa 1: Configuração da fonte. ** Em Detalhes da ** entrega**, insira um nome ** de entrega**. **Em ** Source, escolha o On-Demand stream a partir do qual fazer a entrega. Somente On-Demand transmissões são exibidas. Escolha **Próximo**.

1. **Etapa 2: Configuração de destino. ** Escolha um formato de ** registro ** (**JSON ****, ** STRING ou ** BYTE\_ARRAY**) e especifique o destino:
   + **ARN do bucket S3 ** — o ARN do bucket de uso geral do Amazon S3 de destino.
   + **Proprietário esperado do bucket ** — o Conta da AWS ID de 12 dígitos do proprietário esperado do bucket.
   + **Tipo de compactação ** — escolha ** GZIP**, ** ZSTD ou Nenhum**. ** **
   + **Classe de armazenamento ** — opcionalmente, escolha uma classe de armazenamento Amazon S3.
   + **Modelo de chave de saída ** — defina opcionalmente a estrutura da chave de objeto do Amazon S3. Para obter detalhes, consulte [Modelo de chave de saída S3 para entrega do Amazon S3](data-delivery-s3-key-template.md).
   + **Atualização dos dados ** — o tempo máximo de buffer em segundos antes da entrega dos registros (mínimo 300, máximo 900).

   Escolha **Próximo**.

1. **Etapa 3: Configuração adicional. ** Configure a criptografia, o acesso ao serviço (a função do IAM), uma fila opcional de cartas mortas, entrega de registros e tags. Escolha **Próximo**.

1. **Etapa 4: Revise e crie. ** Revise sua configuração e escolha ** Criar entrega**. A entrega passa de CREATING para ACTIVE após a conclusão do provisionamento.

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

 Use o `create-channel` comando para criar uma entrega do Amazon S3 que envie registros para um bucket do Amazon S3 de uso geral com formato JSON e compactação 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"
        }
    }'
```

 O comando retorna o canal ARN (`ChannelARN`). Use-o com `describe-channel` para verificar se a entrega atinge o estado ATIVO. Consulte [Descreva uma entrega do Amazon S3](data-delivery-s3-describe.md). Para personalizar a estrutura da chave de objeto do Amazon S3, consulte[Modelo de chave de saída S3 para entrega do Amazon S3](data-delivery-s3-key-template.md). 

 **Referência da API ** — veja `CreateChannel` na Referência da API do * Amazon Kinesis Data Streams. *