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.
Puede asignar sus propios metadatos a las transmisiones y a los consumidores con distribución 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.
Contenido
Revisar los conceptos básicos de etiquetas
Los recursos de Kinesis Data Streams que puede etiquetar incluyen flujos de datos y consumidores con distribución mejorada. Utilice la consola AWS CLI de Kinesis Data Streams o la API de Kinesis Data Streams para realizar las siguientes tareas:
-
Cree un recurso con etiquetas
-
Añadir etiquetas a un recurso
-
Enumere las etiquetas de sus recursos
-
Eliminar etiquetas de un recurso
nota
No puede aplicar etiquetas a los consumidores con distribución 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, puede definir un conjunto de etiquetas que le ayuden a realizar un seguimiento de los recursos por propietario y aplicación asociada. 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 añadir etiquetas al crear una transmisión, debe incluir los
kinesis:AddTagsToStreampermisoskinesis:CreateStreamy los permisos de esa transmisión. No puedes usar elkinesis:TagResourcepermiso para etiquetar transmisiones mientras las creas. -
Para añadir etiquetas durante el registro de un consumidor, debes incluir los
kinesis:RegisterStreamConsumerpermisoskinesis:TagResourcey.
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 las categorías empresariales, como los centros de costes, los nombres de las aplicaciones o los propietarios, para organizar los costes en varios 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 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 puede iniciar una clave de etiqueta
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 añadir, actualizar, enumerar y eliminar etiquetas de sus transmisiones mediante la consola de Kinesis Data Streams.
Para ver las etiquetas de una secuencia
-
En el panel de navegación izquierdo, elija Data Streams.
-
En la página Flujos de datos, elija el flujo que desee etiquetar.
-
En la página de detalles de la transmisión, elija Configuración.
-
En la sección Etiquetas, consulta las etiquetas aplicadas a la transmisión.
Crear un flujo de datos con una etiqueta
-
Abra la consola de Kinesis Data Streams.
-
En el panel de navegación izquierdo, selecciona Flujos de datos.
-
Elija Create data stream (Crear flujo de datos).
-
En la página Crear flujo de datos, introduzca un nombre para el flujo de datos.
-
Para la capacidad de transmisión de datos, elija el modo de capacidad bajo demanda o aprovisionada.
Para obtener más información sobre los modos de capacidad, consulteElegir el modo de capacidad del flujo de datos.
-
En la sección Etiquetas, haga lo siguiente:
-
Elija Añadir nueva etiqueta.
-
En Clave, introduzca la etiqueta y, si lo desea, especifique un valor en el campo Valor.
Si ve un error, la clave o el valor de la etiqueta que especificó no cumplen las restricciones de la etiqueta. Para obtener más información, consulte Comprender las restricciones de las etiquetas.
-
-
Elija Create data stream (Crear flujo de datos).
Para añadir o actualizar una etiqueta en una transmisión
-
Abra la consola de Kinesis Data Streams.
-
En el panel de navegación izquierdo, selecciona Flujos de datos.
-
En la página Flujos de datos, elija el flujo al que desee añadir o actualizar las etiquetas.
-
En la página de detalles de la transmisión, seleccione Configuración.
-
En la sección Etiquetas, elija Administrar etiquetas.
-
En Etiquetas, realice una de las siguientes acciones:
-
Para añadir una etiqueta nueva, selecciona Añadir nueva etiqueta y, a continuación, introduce los datos clave y de valor de la etiqueta. Repita este paso tantas veces como sea necesario.
El número máximo de etiquetas que puedes añadir para cada transmisión es de 50.
-
Para actualizar una etiqueta existente, introduce un nuevo valor de etiqueta en el campo Valor de la clave de esa etiqueta.
Si aparece un error, la clave o el valor de la etiqueta que especificó no cumplen las restricciones de etiqueta. Para obtener más información, consulte Comprender las restricciones de las etiquetas.
-
-
Elija Save changes (Guardar cambios).
Para eliminar una etiqueta de una secuencia
-
Abra la consola de Kinesis Data Streams.
-
En el panel de navegación izquierdo, selecciona Flujos de datos.
-
En la página Flujos de datos, elija el flujo del que desee eliminar las etiquetas.
-
En la página de detalles de la transmisión, seleccione Configuración.
-
En la sección Etiquetas, elija Administrar etiquetas.
-
Busque el par de etiquetas, clave y valor que desee eliminar. Luego, seleccione Eliminar.
-
Seleccione Save changes (Guardar cambios).
Etiquete las transmisiones mediante el AWS CLI
Puede añadir, enumerar y eliminar etiquetas en sus transmisiones mediante 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.
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
-
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.
Etiquete a los consumidores mediante el AWS CLI
Puede añadir, enumerar y eliminar etiquetas de sus consumidores mediante el AWS CLI. Para ver ejemplos, consulte la documentación siguiente:
- register-stream-consumer
-
Registra un consumidor para una transmisión de datos de Kinesis con etiquetas.
- tag-resource
-
Añade o actualiza etiquetas para el recurso de Kinesis especificado.
- list-tags-for-resource
-
Muestra las etiquetas del recurso de Kinesis especificado.
- untag-resource
-
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
-
Registra un consumidor para una transmisión de datos de Kinesis con etiquetas.
- TagResource
-
Añade o actualiza etiquetas para el recurso de Kinesis especificado.
- ListTagsForResource
-
Muestra las etiquetas del recurso de Kinesis especificado.
- UntagResource
-
Elimina las etiquetas del recurso de Kinesis especificado.
