Etiquetado de flujos de Amazon Kinesis Data Streams

Puede asignar sus propios metadatos a los flujos que cree en Amazon Kinesis Data Streams en forma de etiquetas. Una etiqueta es un par clave-valor definido por el usuario para un flujo. El uso de las etiquetas es una forma sencilla y potente para administrar los recursos de AWS y organizar los datos, incluidos los datos de facturación.

Conceptos básicos de etiquetas

Utilice la consola de Kinesis Data Streams, la AWS CLI o la API de Kinesis Data Streams para realizar las siguientes tareas:

• Agregar etiquetas a una secuencia

• Listar las etiquetas para sus secuencias

• Eliminar etiquetas de una secuencia

Puede utilizar las etiquetas para categorizar sus secuencias. Por ejemplo, puede clasificar las secuencias en categorías por objetivo, propietario o entorno. Dado que define la clave y el valor de cada etiqueta, puede crear un conjunto de categorías personalizadas para satisfacer sus necesidades específicas. Por ejemplo, podría definir un conjunto de etiquetas que le ayude a realizar un seguimiento de las secuencias por propietario y aplicaciones asociadas. Estos son algunos ejemplos de etiquetas:

• Proyecto: nombre del proyecto

• Propietario: nombre

• Objetivo: pruebas de carga

• Aplicación: nombre de aplicación

• Entorno: producción

Seguimiento de costos utilizando el etiquetado

Puede utilizar etiquetas para categorizar y hacer un seguimiento de los costos de AWS. Cuando se aplican etiquetas a los recursos de AWS, incluidos los flujos, el informe de asignación de costos de AWS incluye el uso y los costos agregados por etiquetas. Puede aplicar etiquetas que representen categorías de negocio (por ejemplo, centros de costos, nombres de aplicación o propietarios) para organizar los costos entre diferentes servicios. Para obtener más información, consulte Utilizar etiquetas de asignación de costos para informes de facturación personalizados en la Guía del usuario de AWS Billing.

Restricciones de las etiquetas

Se aplican las siguientes restricciones a las etiquetas.

Restricciones básicas

• El número máximo de etiquetas por recurso (flujo) es 50.

• Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas.

• No se pueden cambiar ni editar etiquetas de un flujo eliminado.

Restricciones de clave de etiqueta

• Cada clave de etiqueta debe ser única. Si agrega una etiqueta con una clave que ya está en uso, la nueva etiqueta sobrescribe el par clave-valor existente.

• Una clave de etiqueta no puede comenzar por aws: porque este prefijo está reservado para su utilización por AWS. AWS crea etiquetas cuyo nombre comienza por este prefijo por usted, pero usted no puede editarlas ni eliminarlas.

• Las claves de etiqueta deben tener entre 1 y 128 caracteres Unicode de longitud.

• Las claves de etiquetas deben constar de los siguientes caracteres: letras Unicode, números, espacios en blanco y los siguientes caracteres especiales: _ . / = + - @.

Restricciones de valor de etiqueta

• Los valores de etiqueta deben tener entre 0 y 255 caracteres Unicode de longitud.

• Los valores de etiqueta pueden estar en blanco. De lo contrario, deben constar de los siguientes caracteres: letras Unicode, números, espacios en blanco y cualquiera de los siguientes caracteres especiales: _ . / = + - @.

Etiquetado de flujos mediante la consola de Kinesis Data Streams

Puede agregar, enumerar y eliminar etiquetas con la consola de Kinesis Data Streams.

Para ver las etiquetas de una secuencia

1. Abra la consola de Kinesis Data Streams. En la barra de navegación, expanda el selector de regiones y seleccione una región.

2. En la página Stream-List (Lista de secuencias), seleccione una secuencia.

3. En la página Stream Details (Detalles de la secuencia) haga clic en la pestaña Tags (Etiquetas).

Para agregar una etiqueta a una secuencia

1. Abra la consola de Kinesis Data Streams. En la barra de navegación, expanda el selector de regiones y seleccione una región.

2. En la página Stream-List (Lista de secuencias), seleccione una secuencia.

3. En la página Stream Details (Detalles de la secuencia) haga clic en la pestaña Tags (Etiquetas).

4. Especifique la clave de etiqueta en el campo Key (Clave), escriba un valor de etiqueta en el campo Value (Valor) (opcional) y haga clic en Add Tag (Añadir etiqueta).

   Si el botón Add Tag (Añadir etiqueta) no está habilitado, la clave o el valor de etiqueta que ha especificado no cumplen las restricciones para etiquetas. Para obtener más información, consulte Restricciones de las etiquetas.

5. Para ver la nueva etiqueta en la pestaña Tags (Etiquetas), haga clic en el icono de actualización.

Para eliminar una etiqueta de una secuencia

1. Abra la consola de Kinesis Data Streams. En la barra de navegación, expanda el selector de regiones y seleccione una región.

2. En la página Stream-List, seleccione una secuencia.

3. En la página Stream Details (Detalles de la secuencia), haga clic en la pestaña Tags (Etiquetas) y, a continuación, haga clic en el icono Remove (Quitar) de la etiqueta.

4. En el cuadro de diálogo Delete Tag (Eliminar etiqueta), haga clic en Yes, Delete (Sí, eliminar).

Etiquetado de secuencias con la AWS CLI

Puede agregar, enumerar y eliminar etiquetas mediante la AWS CLI. Para ver ejemplos, consulte la documentación siguiente.

add-tags-to-stream

Añade o actualiza las etiquetas para la secuencia especificada.

list-tags-for-stream

Enumera las etiquetas de la secuencia especificada.

remove-tags-from-stream

Elimina las etiquetas de la secuencia especificada.

Etiquetado de flujos mediante la API de Kinesis Data Streams

Puede agregar, enumerar y eliminar etiquetas con la API de Kinesis Data Streams. Para ver ejemplos, consulte la documentación siguiente:

AddTagsToStream

Añade o actualiza las etiquetas para la secuencia especificada.

ListTagsForStream

Enumera las etiquetas de la secuencia especificada.

RemoveTagsFromStream

Elimina las etiquetas de la secuencia especificada.