Cómo etiquetar las transmisiones de Firehose en Amazon Data Firehose - Amazon Data Firehose

Amazon Data Firehose se conocía anteriormente como Amazon Kinesis Data Firehose

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.

Cómo etiquetar las transmisiones de Firehose en Amazon Data Firehose

Puede asignar sus propios metadatos a las transmisiones de Firehose que cree en Amazon Data Firehose 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.

Conceptos básicos de etiquetas

Puede utilizar la API Amazon Data Firehose para realizar las siguientes tareas:

  • Añade etiquetas a una transmisión de Firehose.

  • Haz una lista de las etiquetas de tus transmisiones de Firehose.

  • Quita las etiquetas de una transmisión de Firehose.

Puedes usar etiquetas para categorizar tus transmisiones de Firehose. Por ejemplo, puede clasificar las transmisiones Firehose por propósito, 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, puedes definir un conjunto de etiquetas que te ayuden a rastrear las transmisiones de Firehose por propietario y aplicación asociada.

A continuación, se muestran varios ejemplos de etiquetas:

  • Project: Project name

  • Owner: Name

  • Purpose: Load testing

  • Application: Application name

  • Environment: Production

Si especifica etiquetas en la CreateDeliveryStream acción, Amazon Data Firehose realiza una autorización adicional sobre la firehose:TagDeliveryStream acción para comprobar si los usuarios tienen permisos para crear etiquetas. Si no concedes este permiso, las solicitudes para crear nuevos flujos de entrega de Firehose con etiquetas de recursos de IAM fallarán con un resultado AccessDeniedException como el siguiente.

AccessDeniedException User: arn:aws:sts::x:assumed-role/x/x is not authorized to perform: firehose:TagDeliveryStream on resource: arn:aws:firehose:us-east-1:x:deliverystream/x with an explicit deny in an identity-based policy.

El siguiente ejemplo muestra una política que permite a los usuarios crear un flujo de entrega y aplicar etiquetas.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "firehose:CreateDeliveryStream", "Resource": "*", } }, { "Effect": "Allow", "Action": "firehose:TagDeliveryStream", "Resource": "*", } } ] }

Seguimiento de costos utilizando el etiquetado

Puede usar etiquetas para categorizar y realizar un seguimiento de sus AWS costos. Cuando aplicas etiquetas a tus AWS recursos, incluidas las transmisiones de Firehose, tu informe de asignación de AWS costos incluye el uso y los costos agregados por etiquetas. Si aplica etiquetas que representen categorías de negocio (por ejemplo, centros de costos, nombres de aplicaciones o propietarios), puede 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

Las siguientes restricciones se aplican a las etiquetas de Amazon Data Firehose.

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 transmisiones de Firehose mediante la API Firehose de Amazon Data

Puedes especificar etiquetas al invocar CreateDeliveryStreampara crear una nueva transmisión de Firehose. Para las secuencias de entrega existentes, puede añadir, mostrar y eliminar etiquetas con las siguientes tres operaciones: