View a markdown version of this page

Creación de una entrega de Amazon S3 - Amazon Kinesis Data Streams
Uso de Consola de administración de AWSUso de AWS CLI

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

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 previosCómo comenzar con la entrega de uso general de S3, incluida la función de ejecución del servicio de IAM que se describe en. Permisos de IAM para la entrega de datos

Uso de Consola de administración de AWS

  1. Abra la consola de Kinesis en. https://console.aws.amazon.com/kinesis

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

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

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

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

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

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

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. Para personalizar la estructura de claves de objetos de Amazon S3, consultePlantilla de clave de salida de S3 para la entrega de Amazon S3.

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