Etiquetado de recursos de Amazon RDS - Amazon Relational Database Service

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.

Etiquetado de recursos de Amazon RDS

Puede utilizar etiquetas de Amazon RDS para agregar metadatos a los recursos de Amazon RDS. Además, estas etiquetas se pueden utilizar junto con políticas de IAM para gestionar el acceso a los recursos de Amazon RDS y para controlar qué acciones se pueden aplicar a los recursos de Amazon RDS. Por último, estas etiquetas se pueden utilizar para hacer un seguimiento de costos, agrupando los gastos correspondientes a recursos con etiqueta similar.

Todos los recursos de Amazon RDS pueden etiquetarse

  • Instancias de base de datos

  • Clústeres de base de datos

  • Réplicas de lectura

  • Instantáneas de base de datos

  • Instantáneas de clúster de base de datos

  • Instancias de base de datos reservadas

  • Suscripciones de eventos

  • Grupos de opciones de base de datos

  • Grupos de parámetros de base de datos

  • Grupos de parámetros de clúster de base de datos

  • Grupos de seguridad de base de datos

  • Grupos de subred de base de datos

Para obtener más información sobre la administración del acceso a recursos etiquetados con políticas de IAM, consulte Administración de identidades y accesos en Amazon RDS.

Información general de las etiquetas de recursos de Amazon RDS

Las etiquetas de Amazon RDS son pares nombre-valor que el usuario define y asocia a un recurso de Amazon RDS. El nombre es la clave. Si lo desea puede proporcionar un valor para la clave o no. También puede usar etiquetas para asignar información arbitraria a un recurso de Amazon RDS. Puede usar claves de etiqueta, por ejemplo, para definir una categoría, y el valor de la etiqueta puede ser un elemento dentro de esa categoría. Por ejemplo, puede definir una clave de etiqueta "proyecto" y un valor de etiqueta "Salix" para indicar que el recurso de Amazon RDS va asignado al proyecto Salix. Asimismo, puede utilizar etiquetas para designar recursos de Amazon RDS para pruebas o para producción mediante una clave como environment=test o environment=production. Se recomienda utilizar un conjunto coherente de claves de etiqueta que facilite el seguimiento de los metadatos asociados a los recursos de Amazon RDS.

Use etiquetas para organizar sus facturas de AWS de manera que reflejen su propia estructura de costos. Para ello, regístrese para obtener una factura de su cuenta de AWS que incluya valores de clave de etiquetas. A continuación, para ver los costos de los recursos combinados, organice la información de facturación de acuerdo con los recursos con los mismos valores de clave de etiquetas. Por ejemplo, puede etiquetar varios recursos con un nombre de aplicación específico y luego organizar su información de facturación para ver el costo total de la aplicación en distintos servicios. Para obtener más información, consulte Cost Allocation and Tagging en About AWS Billing and Cost Management.

Cada recurso de Amazon RDS tiene un conjunto de etiquetas con todas las etiquetas asignadas a ese recurso de Amazon RDS. Un conjunto de etiquetas puede contener hasta 50 etiquetas, y también puede estar vacío. Si agrega una etiqueta a un recurso de Amazon RDS con la misma clave que una etiqueta existente en el recurso, el nuevo valor sobrescribirá al antiguo.

AWS no aplica ningún significado semántico a las etiquetas, que se interpretan estrictamente como cadenas de caracteres. Amazon RDS puede definir etiquetas en una instancia de base de datos u otros recursos de Amazon RDS, con arreglo a la configuración utilizada al crear el recurso. Por ejemplo, Amazon RDS podría agregar una etiqueta en la que se indica que una instancia de base de datos es para producción o para la realización de pruebas.

  • La clave de la etiqueta es el nombre obligatorio de la etiqueta. El valor de la cadena puede tener una longitud de entre 1 y 128 caracteres Unicode y no puede llevar los prefijos "aws:" ni "rds:". La cadena puede contener únicamente el conjunto de letras, dígitos y espacio en blanco, '_', '.', ':', '/', '=', '+', '-', '@' (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$").

  • El valor de etiqueta es un valor de cadena optativo en la etiqueta. El valor de cadena puede tener una longitud de entre 1 y 256 caracteres Unicode y no puede llevar el prefijo "aws:". La cadena puede contener únicamente el conjunto de letras, dígitos y espacio en blanco, '_', '.', ':', '/', '=', '+', '-', '@' (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$").

    Los valores no deben ser únicos dentro de un conjunto de etiquetas y también pueden ser nulos. Por ejemplo, es posible tener en un conjunto de etiquetas los pares clave-valor project=Trinity y cost-center=Trinity.

nota

Puede añadir una etiqueta a una instantánea, pero la factura no reflejará esta agrupación.

Puede utilizar la Consola de administración de AWS, la interfaz de línea de comandos o la API de Amazon RDS para agregar, listar y eliminar etiquetas de recursos de Amazon RDS. Si utiliza la interfaz de línea de comandos o la API de Amazon RDS, deberá proporcionar el nombre de recurso de Amazon (ARN) correspondiente al recurso de Amazon RDS con el que desee trabajar. Para obtener más información sobre cómo crear un ARN, consulte Creación de un nombre ARN para Amazon RDS.

Las etiquetas se almacenan en caché con fines de autorización. Por este motivo, cuando se actualizan o se agregan valores a las etiquetas de recursos de Amazon RDS, pueden tardar varios minutos en estar disponibles.

Copia de etiquetas

Cuando crea o restaura una instancia de base de datos, puede especificar que las etiquetas de dicha instancia se copien en instantáneas de la instancia de base de datos. La copia de las etiquetas garantiza que los metadatos para las instantáneas de base de datos coincidan con los de la instancia de base de datos de origen y que cualquier política de acceso para la instantánea de base de datos también coincida con la de la instancia de base de datos de origen. Las etiquetas no se copian de forma predeterminada.

Puede especificar que las etiquetas se copien en las instantáneas de base de datos para las siguientes acciones:

  • Creación de una instancia de base de datos.

  • Restauración de una instancia de base de datos.

  • Creación de una réplica de lectura.

  • Copia de una instantánea de base de datos.

nota

Si incluye un valor para el parámetro --tag-key del comando create-db-snapshot de la AWS CLI (o proporciona al menos una etiqueta a la operación CreateDBSnapshot de la API), RDS no copia las etiquetas de la instancia de base de datos de origen en la nueva instantánea de base de datos. Esta funcionalidad se aplica incluso si la instancia de base de datos de origen tiene la opción --copy-tags-to-snapshot (CopyTagsToSnapshot) habilitada. Si adopta este enfoque, puede crear una copia de una instancia de base de datos a partir de una instantánea de base de datos y evitar tener que agregar etiquetas que no se aplican a la instancia de base de datos nueva. Una vez que haya creado su instantánea de base de datos mediante el comando de la AWS CLI create-db-snapshot (o la operación CreateDBSnapshot de la API de Amazon RDS), puede agregar etiquetas tal y como se describe más adelante en este tema.

El proceso para etiquetar un recurso de Amazon RDS es similar para todos los recursos. El siguiente procedimiento muestra cómo etiquetar una instancia de base de datos de Amazon RDS.

Para agregar una etiqueta a una instancia de base de datos

  1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon RDS en https://console.aws.amazon.com/rds/.

  2. En el panel de navegación, seleccione Databases (Bases de datos).

    nota

    Para filtrar la lista de instancias de base de datos en el panel Databases (Bases de datos), escriba una cadena de texto para Filter databases (Filtrar bases de datos). Solo aparecen instancias de base de datos que contienen la cadena.

  3. Seleccione el nombre de la instancia de base de datos que desea etiquetar para mostrar sus detalles.

  4. En la sección de detalles, desplácese hasta la sección Tags (Etiquetas).

  5. Elija Add. Aparece la ventana Add tags (Añadir etiquetas).

    
						Ventana para añadir etiquetas
  6. Escriba un valor para Tag key (Clave de etiqueta) y Value (Valor).

  7. Para añadir otra etiqueta, puede elegir Add another Tag (Añadir otra etiqueta) y escribir un valor para Tag key (Clave de etiqueta) y Value (Valor).

    Repita este paso tantas veces como sea necesario.

  8. Elija Add.

Para eliminar una etiqueta de una instancia de base de datos

  1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon RDS en https://console.aws.amazon.com/rds/.

  2. En el panel de navegación, seleccione Databases (Bases de datos).

    nota

    Para filtrar la lista de instancias de base de datos en el panel Databases (Bases de datos), escriba una cadena de texto en el cuadro Filter databases (Filtrar bases de datos). Solo aparecen instancias de base de datos que contienen la cadena.

  3. Seleccione el nombre de la instancia de base de datos para mostrar sus detalles.

  4. En la sección de detalles, desplácese hasta la sección Tags (Etiquetas).

  5. Elija la etiqueta desea eliminar.

    
					Sección de etiquetas
  6. Elija Delete (Eliminar) y después elija (Eliminar) en la ventana Delete tags (Eliminar etiquetas).

Puede utilizar la AWS CLI para agregar, listar o eliminar etiquetas de una instancia de base de datos.

  • Para añadir una o más etiquetas a un recurso de Amazon RDS, utilice el comando add-tags-to-resource de la AWS CLI.

  • Para ver una lista de las etiquetas de un recurso de Amazon RDS, utilice el comando list-tags-for-resource de la AWS CLI.

  • Para eliminar una o más etiquetas de un recurso de Amazon RDS, utilice el comando remove-tags-from-resource de la AWS CLI.

Para obtener más información acerca de cómo crear el ARN requerido, consulte Creación de un nombre ARN para Amazon RDS.

Puede utilizar la API de Amazon RDS para agregar, listar o eliminar etiquetas de una instancia de base de datos.

  • Para añadir una etiqueta a un recurso de Amazon RDS, utilice la operación AddTagsToResource.

  • Para ver una lista de las etiquetas asignadas a un recurso de Amazon RDS, utilice ListTagsForResource.

  • Para eliminar etiquetas de un recurso de Amazon RDS, utilice la operación RemoveTagsFromResource.

Para obtener más información acerca de cómo crear el ARN requerido, consulte Creación de un nombre ARN para Amazon RDS.

Cuando se trabaja con XML mediante la API de Amazon RDS, las etiquetas utilizan el esquema siguiente:

<Tagging> <TagSet> <Tag> <Key>Project</Key> <Value>Trinity</Value> </Tag> <Tag> <Key>User</Key> <Value>Jones</Value> </Tag> </TagSet> </Tagging>

La tabla siguiente proporciona una lista de las etiquetas XML permitidas y sus características. Los valores de clave y de valor distinguen entre mayúsculas y minúsculas. Por ejemplo, proyecto=Trinity y PROYECTO=Trinity son dos etiquetas diferentes.

Elemento de etiquetado Descripción
TagSet Los conjuntos de etiquetas contienen todas las etiquetas asignadas a un recurso de Amazon RDS. Solo puede haber un conjunto de etiquetas por recurso. Solo puede trabajar con conjuntos de etiquetas a través de la API de Amazon RDS.
Tag Las etiquetas son pares clave-valor que define el usuario. En un conjunto de etiquetas puede haber entre 1 y 50 etiquetas.
Key

La clave es el nombre obligatorio de la etiqueta. El valor de la cadena puede tener una longitud de entre 1 y 128 caracteres Unicode y no puede llevar los prefijos "rds:" ni "aws:". La cadena solo puede contener el conjunto de letras, dígitos y espacio en blanco Unicode, '_', '.', '/', '=', '+', '-' (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$").

Las claves deben ser únicas dentro de un conjunto de etiquetas. Por ejemplo, en un conjunto de etiquetas no puede haber claves iguales pero con valores diferentes, como proyecto/Trinity y proyecto/Xanadu.

Value

El valor es la parte opcional de la etiqueta. El valor de la cadena puede tener una longitud de entre 1 y 256 caracteres Unicode y no puede llevar los prefijos "rds:" ni "aws:". La cadena solo puede contener el conjunto de letras, dígitos y espacio en blanco Unicode, '_', '.', '/', '=', '+', '-' (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$").

Los valores no deben ser únicos dentro de un conjunto de etiquetas y también pueden ser nulos. Por ejemplo, puede tener un par clave-valor en un conjunto de etiquetas en proyecto/Trinity y centro-de-costos/Trinity.