Etiquetar recursos de Amazon Kinesis Data Streams - Amazon Kinesis Data Streams
Revisar los conceptos básicos de etiquetasSeguir costos mediante etiquetadoComprender las restricciones de las etiquetasEtiquetar flujos mediante la consola de Kinesis Data StreamsEtiquetar flujos con la AWS CLIEtiquetar flujos mediante las API de Kinesis Data StreamsEtiquete a los consumidores mediante la AWS CLIEtiquete los consumidores mediante las API de Kinesis Data Streams

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

Los recursos de Kinesis Data Streams que se pueden etiquetar integran los flujos de datos y consumidores con distribución ramificada mejorada. Utilice la consola de Kinesis Data Streams, la AWS CLI 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. Si desea aplicar etiquetas a los consumidores, utilice AWS CLI o la API 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 puede utilizar el permiso kinesis:TagResource para etiquetar flujos mientras se crean.

  • Para agregar etiquetas durante el registro de un consumidor, debe incluir los permisos kinesis:TagResource y kinesis:RegisterStreamConsumer.

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 Kinesis Data Streams, 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 (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 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.

  • 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, 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 administración de AWS y abra la consola de Kinesis en https://console.aws.amazon.com/kinesis.

  2. En el panel de navegación izquierdo, elija Data streams (Flujos de datos).

  3. En la página Data streams (Flujos de datos), seleccione el flujo que desea etiquetar.

  4. En la página de detalles de Stream, seleccione Configuration (Configuración).

  5. En la sección Tags (Etiquetas), consulte las etiquetas aplicadas al flujo.

Crear un flujo de datos con una etiqueta

  1. Abra la consola de Kinesis Data Streams.

  2. En el panel de navegación izquierdo, elija Data streams (Flujos de datos).

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

  4. En la página Create data stream (Crear flujo de datos), escriba un nombre para su flujo de datos.

  5. En Data stream capacity (Capacidad del flujo de datos), elija el modo de capacidad On-demand (Bajo demanda) o Provisioned (Aprovisionado).

    Para obtener más información acerca de los modos de capacidad, consulte Elegir el modo correcto para el flujo.

  6. En la sección Etiquetas, haga lo siguiente:

    1. Elija Añadir nueva etiqueta.

    2. En Key (Clave), ingrese la etiqueta y seleccione, de manera opcional, un valor en el campo Value (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.

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

  2. En el panel de navegación izquierdo, elija Data streams (Flujos de datos).

  3. En la página Data streams (Flujos de datos), elija el flujo al que desee agregar o actualizar las etiquetas.

  4. En la página de detalles de Stream, seleccione Configuration (Configuración).

  5. En la sección Etiquetas, elija Administrar etiquetas.

  6. En Tags (Etiquetas), elija una de las siguientes opciones:

    • Para agregar una etiqueta, elija Add new tag (Agregar nueva etiqueta) y, a continuación, ingrese la clave Key de la etiqueta y los datos del valor Value. 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 Value (Valor) de la clave Key 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.

  7. Elija Save changes (Guardar cambios).

Para eliminar una etiqueta de una secuencia

  1. Abra la consola de Kinesis Data Streams.

  2. En el panel de navegación izquierdo, elija Data streams (Flujos de datos).

  3. En la página Data streams (Flujos de datos), elija el flujo del que desea eliminar etiquetas.

  4. En la página de detalles de Stream, seleccione Configuration (Configuración).

  5. En la sección Etiquetas, elija Administrar etiquetas.

  6. Busque el par de etiqueta Key (Clave) y Value (Valor) que desea eliminar. Luego, seleccione Eliminar.

  7. Seleccione Save changes (Guardar cambios).

Etiquetar flujos con la 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

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 las API de Kinesis Data Streams

Puede agregar, enumerar y eliminar etiquetas de los flujos con las 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.

Etiquete a los consumidores mediante la 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

Registra un consumidor para un flujo de datos de Kinesis con etiquetas

tag-resource

Agrega o actualiza las etiquetas para el recurso de Kinesis especificado

list-tags-for-resource

Muestra una lista de las etiquetas del recurso de Kinesis especificado

untag-resource

Elimina las etiquetas del recurso de Kinesis especificado

Etiquete los consumidores mediante las API de Kinesis Data Streams

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

RegisterStreamConsumer

Registra un consumidor para un flujo de datos de Kinesis con etiquetas

TagResource

Agrega o actualiza las etiquetas para el recurso de Kinesis especificado

ListTagsForResource

Muestra una lista de las etiquetas del recurso de Kinesis especificado

UntagResource

Elimina las etiquetas del recurso de Kinesis especificado