Etiquetar los 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.

Revisar los 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:

• Crear un flujo con etiquetas

• 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

Seguir costos mediante 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.

Comprender las 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: _ . / = + - @.

Etiquetar 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 Detalles del flujo haga clic en la pestaña Etiquetas.

Crear un flujo de datos con una etiqueta

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. Seleccionar Crear un flujo.

3. En la página Crear flujo de datos, escriba un nombre para su flujo de datos y, a continuación, elija el modo de capacidad Bajo demanda o Aprovisionado. El modo Bajo demanda está seleccionado de forma predeterminada. Para obtener más información, consulte Elegir el modo de capacidad del flujo de datos.

4. En la sección Etiquetas, elija Agregar nueva etiqueta. Especifique la etiqueta en el campo Clave y, si lo desea, especifique un valor en el campo Valor.

   Si detecta un error, la clave o el valor de la etiqueta que especificó no cumplen con las restricciones de la etiqueta. Para obtener más información, consulte Comprender las restricciones de las etiquetas.

5. Elija Create data stream (Crear flujo de datos).

6. En la página Flujos de datos, el valor Estado del flujo se muestra como Creándose mientras se crea. Cuando el flujo está listo para usarse, el estado cambia a Activo.

7. Elija el nombre del flujo. La página Detalles del flujo muestra un resumen de la configuración del flujo, junto con información de monitoreo.

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 Detalles del flujo haga clic en la pestaña Etiquetas.

4. Especifique la clave de etiqueta en el campo Clave, si lo desea, escriba un valor de etiqueta en el campo Valor y, a continuación, elija Agregar 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 Comprender las restricciones de las etiquetas.

5. Para ver la nueva etiqueta en la lista en la pestaña 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 Detalles de flujo, seleccione la pestaña Etiquetas y, a continuación, seleccione el icono Quitar de la etiqueta.

4. En el cuadro de diálogo Eliminar etiqueta, elija Sí, eliminar.

Etiquetar flujos con la AWS CLI

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

create-stream

Crea un flujo con etiquetas.

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.

Etiquetar 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:

CreateStream

Crea un flujo con etiquetas.

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.