

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Crear una entrega de Amazon S3
<a name="data-delivery-s3-create"></a>

 Cree una entrega que envíe los registros de una transmisión de Amazon Kinesis Data Streams a un bucket de Amazon S3 de uso general. Puede crear una entrega con Consola de administración de AWS o con. AWS CLI Los registros se entregan en su formato original, agrupados en objetos de tamaño óptimo, con una compresión configurable y una estructura de claves S3 que usted defina. 

**nota**  
 Antes de crear una entrega, complete los requisitos previos[Cómo comenzar con la entrega de uso general de S3](data-delivery-s3-getting-started.md), incluida la función de ejecución del servicio de IAM que se describe en. [Permisos de IAM para la entrega de datos](data-delivery-iam.md) 

## Uso de Consola de administración de AWS
<a name="data-delivery-s3-create-console"></a>

1. Abra la consola Kinesis en. [https://console.aws.amazon.com/kinesis](https://console.aws.amazon.com/kinesis)

1. En el panel de navegación, elija **S3 para uso general** y, a continuación, elija **Crear entrega**.

1. **Paso 1: Configuración de origen.** En **Detalles de entrega**, introduce un **nombre de entrega**. En **Fuente**, selecciona la On-Demand transmisión desde la que deseas realizar la entrega. Solo se muestran las On-Demand transmisiones. Elija **Siguiente**.

1. **Paso 2: Configuración del destino.** Elija un **formato de registro** (**JSON**, **STRING** o **BYTE\_ARRAY**) y, a continuación, especifique el destino:
   + **ARN del bucket S3: el ARN** del bucket de Amazon S3 de uso general de destino.
   + **Propietario esperado del bucket**: el Cuenta de AWS ID de 12 dígitos del propietario esperado del bucket.
   + **Tipo de compresión****: elija **GZIP**, **ZSTD** o Ninguno.**
   + **Clase de almacenamiento**: si lo desea, elija una clase de almacenamiento de Amazon S3.
   + **Plantilla de clave de salida**: defina opcionalmente la estructura de clave de objeto de Amazon S3. Para obtener más información, consulte [Plantilla de clave de salida de S3 para la entrega de Amazon S3](data-delivery-s3-key-template.md).
   + **Actualización de los datos**: el tiempo máximo de almacenamiento en búfer en segundos antes de que se entreguen los registros (mínimo 300, máximo 900).

   Elija **Siguiente**.

1. **Paso 3: Configuración adicional.** Configure el cifrado, el acceso a los servicios (la función de IAM), una cola opcional de cartas sin salida, la entrega de registros y las etiquetas. Elija **Siguiente**.

1. **Paso 4: Revisar y crear.** Revisa la configuración y, a continuación, selecciona **Crear envío**. La entrega pasa de CREATING a ACTIVE una vez finalizado el aprovisionamiento.

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

 Utilice el `create-channel` comando para crear una entrega de Amazon S3 que envíe los registros a un bucket de Amazon S3 de uso general con formato JSON y compresión 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"
        }
    }'
```

 El comando devuelve el ARN del canal ()`ChannelARN`. Úselo con `describe-channel` para verificar que la entrega alcance el estado ACTIVO. Consulte [Describa una entrega de Amazon S3](data-delivery-s3-describe.md). Para personalizar la estructura de claves de objetos de Amazon S3, consulte[Plantilla de clave de salida de S3 para la entrega de Amazon S3](data-delivery-s3-key-template.md). 

 **Referencia de la API**: consulte `CreateChannel` la referencia de la *API de Amazon Kinesis Data Streams*. 