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.
# Etiquetar recursos de Amazon Kinesis Data Streams
Puede asignar sus propios metadatos a los flujos y a los consumidores de distribución ramificada mejorada 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 etiquetas es una forma sencilla pero eficaz de gestionar AWS los recursos y organizar los datos, incluidos los datos de facturación.
**Topics**
+ [Revisar los conceptos básicos de etiquetas](#tagging-basics)
+ [Seguir costos mediante etiquetado](#tagging-billing)
+ [Comprender las restricciones de las etiquetas](#tagging-restrictions)
+ [Etiquetar flujos mediante la consola de Kinesis Data Streams](#tagging-console)
+ [Etiquete las transmisiones mediante el AWS CLI](#tagging-cli)
+ [Etiquete las transmisiones con Kinesis Data Streams APIs](#tagging-api)
+ [Etiquete a los consumidores mediante el AWS CLI](#tagging-consumers-cli)
+ [Etiquete a los consumidores mediante Kinesis Data Streams APIs](#tagging-consumers-api)
## Revisar los conceptos básicos de etiquetas
Los recursos de Kinesis Data Streams que se pueden etiquetar son los flujos de datos y consumidores con distribución ramificada mejorada. Utilice la consola AWS CLI de Kinesis Data Streams o la API de Kinesis Data Streams para realizar las siguientes tareas:
+ crear un recurso con etiquetas,
+ agregar etiquetas a un recurso,
+ enumerar las etiquetas de los recursos,
+ eliminar etiquetas de un recurso.
**nota**
No es posible aplicar etiquetas a consumidores de distribución ramificada mejorada mediante la consola de Kinesis Data Streams. Para aplicar etiquetas a los consumidores, utilice nuestra API AWS CLI de Kinesis Data Streams.
Puede utilizar etiquetas para categorizar sus recursos . Por ejemplo, puede clasificar los recursos 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 los recursos 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
**importante**
Para agregar etiquetas al crear un flujo, debe incluir los permisos `kinesis:CreateStream` y `kinesis:AddTagsToStream` para ese flujo. **No se puede utilizar** el permiso `kinesis:TagResource` para etiquetar flujos al crearlos.
Para agregar etiquetas durante el registro de un consumidor, debe incluir los permisos `kinesis:TagResource` y `kinesis:RegisterStreamConsumer`.
## Seguir costos mediante etiquetado
Puede usar etiquetas para categorizar y realizar un seguimiento de sus AWS costos. Al aplicar etiquetas a los recursos de Kinesis Data Streams, AWS el informe de asignación de costes incluye el uso y los costes agregados por etiquetas. Puede aplicar etiquetas que representen categorías de negocio (como centros de costos, nombres de aplicación o propietarios) para estructurar 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](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) 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 para cada recurso es de 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 recurso 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.
+ No puedes empezar una clave de etiqueta con él `aws:` porque este prefijo está reservado para que lo usen. AWS AWS crea etiquetas que comienzan con este prefijo en tu nombre, pero no puedes 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, actualizar, enumerar y eliminar etiquetas de sus flujos con la consola de Kinesis Data Streams.
**Para ver las etiquetas de una secuencia**
1. [Inicie sesión en la consola de Kinesis Consola de administración de AWS y ábrala en https://console.aws.amazon.com /kinesis.](https://console.aws.amazon.com/kinesis)
1. En el panel de navegación izquierdo, elija **Flujos de datos**.
1. En la página **Flujos de datos**, seleccione el flujo que desea etiquetar.
1. En la página de detalles de Stream, seleccione **Configuración**.
1. En la sección **Etiquetas**, consulte las etiquetas aplicadas al flujo.
**Crear un flujo de datos con una etiqueta**
1. Abra la consola de Kinesis Data Streams.
1. En el panel de navegación izquierdo, elija **Flujos de datos**.
1. Elija **Create data stream (Crear flujo de datos)**.
1. En la página **Crear flujo de datos**, escriba un nombre para su flujo de datos.
1. En **Capacidad de flujo de datos**, elija el modo de capacidad **Bajo demanda** o **Aprovisionado**.
Para obtener más información acerca de los modos de capacidad, consulte [Elegir el modo correcto para el flujo](how-do-i-size-a-stream.md).
1. En la sección **Etiquetas**, haga lo siguiente:
1. Elija **Añadir nueva etiqueta**.
1. En **Clave**, ingrese la etiqueta y seleccione, de manera opcional, un valor en el campo **Valor**.
Si detecta un error, la clave o el valor de la etiqueta que especificó no cumple con las restricciones de la etiqueta. Para obtener más información, consulte [Comprender las restricciones de las etiquetas](#tagging-restrictions).
1. Elija **Create data stream (Crear flujo de datos)**.
**Cómo agregar o actualizar una etiqueta en un flujo**
1. Abra la consola de Kinesis Data Streams.
1. En el panel de navegación izquierdo, elija **Flujos de datos**.
1. En la página **Flujos de datos**, elija el flujo en el que desee agregar o actualizar las etiquetas.
1. En la página de detalles de Stream, seleccione **Configuración**.
1. En la sección **Etiquetas**, elija **Administrar etiquetas**.
1. En **Etiquetas**, elija una de las siguientes opciones:
+ Para agregar una etiqueta, elija **Agregar nueva etiqueta** y, a continuación, ingrese la **Clave** de la etiqueta y los datos del**Valor**. Repita este paso tantas veces como sea necesario.
El número máximo de etiquetas que puede agregar a cada flujo es de 50.
+ Para actualizar una etiqueta existente, ingrese un nuevo valor de etiqueta en el campo **Valor** de la **Clave** de esa etiqueta.
Si detecta un error, la clave o el valor de la etiqueta que especificó no cumple con las restricciones de la etiqueta. Para obtener más información, consulte [Comprender las restricciones de las etiquetas](#tagging-restrictions).
1. Elija **Save changes (Guardar cambios)**.
**Para eliminar una etiqueta de una secuencia**
1. Abra la consola de Kinesis Data Streams.
1. En el panel de navegación izquierdo, elija **Flujos de datos**.
1. En la página **Flujos de datos**, elija el flujo del que desea eliminar etiquetas.
1. En la página de detalles de Stream, seleccione **Configuración**.
1. En la sección **Etiquetas**, elija **Administrar etiquetas**.
1. Busque el par de etiqueta **Clave** y **Valor** que desea eliminar. Luego, seleccione **Eliminar**.
1. Seleccione **Save changes (Guardar cambios)**.
## Etiquete las transmisiones mediante el AWS CLI
Puede agregar, enumerar y eliminar etiquetas de los flujos mediante la AWS CLI. Para ver ejemplos, consulte la documentación siguiente.
[create-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/create-stream.html)
Crea un flujo con etiquetas.
[add-tags-to-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/add-tags-to-stream.html)
Añade o actualiza las etiquetas para la secuencia especificada.
[list-tags-for-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/list-tags-for-stream.html)
Enumera las etiquetas de la secuencia especificada.
[remove-tags-from-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/remove-tags-from-stream.html)
Elimina las etiquetas de la secuencia especificada.
## Etiquete las transmisiones con Kinesis Data Streams APIs
Puede añadir, enumerar y eliminar etiquetas de sus transmisiones mediante Kinesis Data APIs Streams. Para ver ejemplos, consulte la documentación siguiente:
[CreateStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_CreateStream.html)
Crea un flujo con etiquetas.
[AddTagsToStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_AddTagsToStream.html)
Añade o actualiza las etiquetas para la secuencia especificada.
[ListTagsForStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_ListTagsForStream.html)
Enumera las etiquetas de la secuencia especificada.
[RemoveTagsFromStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_RemoveTagsFromStream.html)
Elimina las etiquetas de la secuencia especificada.
## Etiquete a los consumidores mediante el AWS CLI
Puede agregar, enumerar y eliminar etiquetas de sus consumidores mediante la AWS CLI. Para ver ejemplos, consulte la documentación siguiente:
[register-stream-consumer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/register-stream-consumer.html)
Registra un consumidor para un flujo de datos de Kinesis con etiquetas
[tag-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/tag-resource.html)
Agrega o actualiza las etiquetas para el recurso de Kinesis especificado
[list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/list-tags-for-resource.html)
Muestra una lista de las etiquetas del recurso de Kinesis especificado
[untag-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/untag-resource.html)
Elimina las etiquetas del recurso de Kinesis especificado
## Etiquete a los consumidores mediante Kinesis Data Streams APIs
Puede añadir, enumerar y eliminar etiquetas de sus consumidores mediante Kinesis Data APIs Streams. Para ver ejemplos, consulte la documentación siguiente:
[RegisterStreamConsumer](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_RegisterStreamConsumer.html)
Registra un consumidor para un flujo de datos de Kinesis con etiquetas
[TagResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_TagResource.html)
Agrega o actualiza las etiquetas para el recurso de Kinesis especificado
[ListTagsForResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_ListTagsForResource.html)
Muestra una lista de las etiquetas del recurso de Kinesis especificado
[UntagResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_UntagResource.html)
Elimina las etiquetas del recurso de Kinesis especificado