

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.

# Creación de 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 el Consola de administración de AWS o el AWS CLI. Los registros se entregan en su formato original, agrupados en objetos de tamaño óptimo, con 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 de Kinesis en. [https://console.aws.amazon.com/kinesis](https://console.aws.amazon.com/kinesis)

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

1. **Paso 1: Configuración de la fuente. ** En Detalles ** de entrega**, introduce un nombre ** de entrega**. **En ** Fuente, elige 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 de 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 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**: elige ** GZIP**, ** ZSTD ** o Ninguna. ** **
   + **Clase de almacenamiento**: si lo desea, elija una clase de almacenamiento de Amazon S3.
   + **Plantilla de clave de salida**: si lo desea, defina la estructura de claves de objetos 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 mensajes muertos, la entrega de registros y las etiquetas. Elija **Siguiente**.

1. **Paso 4: Revisa y crea. ** 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::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"
        }
    }'
```

 El comando devuelve el canal ARN ()`ChannelARN`. Se usa 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. 