Etiquetado de recursos de Amazon QLDB

Una etiqueta es un atributo personalizado que usted o AWS asignan a un recurso de AWS. Cada etiqueta tiene dos partes:

• Una clave de etiqueta (por ejemplo, CostCenter, Environment o Project). Las claves de etiqueta distinguen entre mayúsculas y minúsculas.

• Un campo opcional denominado valor de etiqueta (por ejemplo, 111122223333 o Production). Omitir el valor de etiqueta es lo mismo que utilizar una cadena vacía. Al igual que las claves de etiqueta, los valores de etiqueta distinguen entre mayúsculas y minúsculas.

Las etiquetas le ayudan a hacer lo siguiente:

• Identificar y organizar sus recursos de AWS. Muchos Servicios de AWS admiten el etiquetado, por lo que puede asignar la misma etiqueta a los recursos de diferentes servicios para indicar que los recursos están relacionados. Por ejemplo, puede asignar la misma etiqueta a un libro mayor de Amazon QLDB que se asigna a un bucket de Amazon S3.

• Realizar un seguimiento de los costos de AWS. Estas etiquetas se activan en el panel de AWS Billing and Cost Management. AWS usa las etiquetas para clasificar los costos y enviar un informe mensual de asignación de costos. Para obtener más información, consulte Uso de etiquetas de asignación de costos en la Guía del usuario de AWS Billing.

• Controle el acceso a los recursos de AWS con AWS Identity and Access Management (IAM). Para obtener más información, consulte Control de acceso basado en atributos (ABAC) con QLDB en esta guía para desarrolladores, y control de acceso mediante etiquetas de IAM en la Guía del usuario de IAM.

Para obtener sugerencias acerca del uso de etiquetas, consulte la publicación sobre Estrategias de etiquetado de AWS en el blog de respuestas de AWS.

En las siguientes secciones, se ofrece más información sobre las etiquetas de Amazon QLDB.

Recursos admitidos en Amazon QLDB

Los siguientes recursos de Amazon QLDB admiten el etiquetado:

• libro mayor

• tabla

• secuencia del diario

Para obtener información acerca de cómo añadir y administrar etiquetas, consulte Administración de etiquetas.

Convenciones de nomenclatura y uso de las etiquetas

Las siguientes convenciones básicas de nomenclatura y uso se aplican al uso de etiquetas con recursos de Amazon QLDB:

• Cada recurso puede tener un máximo de 50 etiquetas.

• Para cada recurso, cada clave de etiqueta debe ser única y solo puede tener un valor.

• La longitud máxima de la clave de etiqueta es de 128 caracteres Unicode en UTF-8.

• La longitud máxima del valor de etiqueta es de 256 caracteres Unicode en UTF-8.

• Los caracteres permitidos son letras, números y espacios representables en UTF-8, además de los siguientes caracteres: . : + = @ _ / - (guion).

• Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas. Como práctica recomendada, decida una estrategia de uso de mayúsculas y minúsculas en las etiquetas e implemente esa estrategia sistemáticamente en todos los tipos de recursos. Por ejemplo, decida si se va a utilizar Costcenter, costcenter o CostCenter y utilice la misma convención para todas las etiquetas. Procure no utilizar etiquetas similares con un tratamiento de mayúsculas y minúsculas incoherente.

• El prefijo aws: se reserva para uso de AWS. No puede editar ni eliminar la clave o el valor de una etiqueta cuando la etiqueta tiene una clave de etiqueta con el prefijo aws:. Las etiquetas que tengan este prefijo no cuentan para el límite de etiquetas por recurso.

Administración de etiquetas

Las etiquetas se componen de las propiedades Key y Value de un recurso. Puede usar la consola de Amazon QLDB, la AWS CLI o la API de QLDB para agregar, editar o eliminar los valores de estas propiedades. También puede utilizar el editor de etiquetas de AWS Resource Groups para administrar etiquetas.

Para obtener información sobre cómo trabajar con etiquetas, consulte las siguientes operaciones de la API:

• ListTagsForResource en la Referencia de la API de Amazon QLDB

• TagResource en la Referencia de la API de Amazon QLDB

• UntagResource en la Referencia de la API de Amazon QLDB

Para utilizar el panel de etiquetado QLDB (consola)

1. Inicie sesión en la AWS Management Console y abra la consola de Amazon QLDB en https://console.aws.amazon.com/qldb.

2. En el panel de navegación, seleccione Libros mayores.

3. En la lista de libros mayores, seleccione el nombre del libro mayor cuyas etiquetas desee administrar.

4. En la página de detalles del libro mayor, localice la tarjeta Etiquetas y seleccione Administrar etiquetas.

5. En la página Administrar etiquetas, puede añadir, editar o eliminar cualquier etiqueta que considere adecuada para su libro mayor. Una vez que las claves y valores de etiqueta sean los deseados, seleccione Guardar.

Etiquetado de recursos durante la creación

Para los recursos de QLDB que admiten el etiquetado, puede definir etiquetas mientras crea el recurso mediante la AWS Management Console, la AWS CLI o la API de QLDB. Al etiquetar los recursos en el momento de su creación, ya no es necesario ejecutar scripts de etiquetado personalizados después de la creación del recurso.

Una vez etiquetada una tabla, puede controlar el acceso a la tabla en función de esas etiquetas. Por ejemplo, puede conceder acceso total solo a los recursos de la tabla que tengan una etiqueta específica. Para ver una política de ejemplo JSON, consulte Acceso completo a todas las acciones basadas en las etiquetas de las tablas.

nota

Los recursos de secuencia no heredan las etiquetas de su recurso de libro mayor raíz.

También puede definir etiquetas de tabla especificándolas en una instrucción CREATE TABLE de PartiQL. Para obtener más información, consulte Etiquetar tablas.