# Etiquetado de los recursos de Amazon Aurora y Amazon RDS Una etiqueta de Amazon RDS es un par nombre-valor que define y asocia a un recurso de Amazon RDS, como una instancia de base de datos o una instantánea de base de datos. El nombre es la clave. Opcionalmente, puede proporcionar un valor para la clave. Puede utilizar la Consola de administración de AWS, la AWS CLI o la API de Amazon RDS para agregar, enumerar y eliminar etiquetas de recursos de Amazon RDS. Si utiliza la CLI de o la API, asegúrese de proporcionar el nombre de recurso de Amazon (ARN) correspondiente al recurso de 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](USER_Tagging.ARN.Constructing.md). Puede utilizar etiquetas para agregar metadatos a sus recursos de Aurora y Amazon RDS. Puede utilizar las etiquetas para agregar sus propias notaciones sobre instancias de base de datos, instantáneas, Aurora clústeres, etc. Si lo hace, puede ayudarlo a documentar sus recursos de Aurora y Amazon RDS. También puede utilizar las etiquetas con procedimientos de mantenimiento automatizados. En concreto, puede utilizar estas etiquetas con las políticas de IAM. Puede utilizarlas para administrar el acceso a los recursos de Aurora y Amazon RDS y controlar qué acciones se pueden aplicar a estos recursos. También puede utilizar estas etiquetas para realizar un seguimiento de los costos al agrupar los gastos de recursos etiquetados de forma similar. Puede etiquetar los siguientes recursos de Aurora y Amazon RDS: + Instancias de base de datos + Clústeres de base de datos + Clústeres globales de Aurora + Puntos de conexión de 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 bases de datos + Grupos de subred de base de datos + Proxies de RDS Proxy + Puntos de enlace de RDS Proxy + Implementaciones azul/verde + Integraciones sin ETL + Copias de seguridad automatizadas + Copias de seguridad automatizadas del clúster **nota** Al etiquetar una instancia de base de datos, Aurora aplica automáticamente esas etiquetas a los recursos de información de rendimiento asociados. Actualmente, no puede etiquetar los proxies de RDS ni los puntos de conexión de proxies de RDS mediante la Consola de administración de AWS. **Topics** + [¿Por qué usar etiquetas de recursos de Amazon RDS?](#Tagging.Purpose) + [Funcionamiento de las etiquetas de recursos de Amazon RDS](#Overview.Tagging) + [Prácticas recomendadas para el etiquetado de los recursos de Amazon RDS](#Tagging.best-practices) + [Copia de etiquetas a instantáneas de clúster de base de datos](#USER_Tagging.CopyTagsCluster) + [Etiquetado de los recursos de copia de seguridad automatizada](#USER_Tagging.AutomatedBackups) + [Añadido y eliminación de etiquetas en Amazon RDS](#Tagging.HowTo) + [Tutorial: Uso de etiquetas para especificar qué clústeres de base de datos de Aurora se deben detener](Tagging.Aurora.Autostop.md) ## ¿Por qué usar etiquetas de recursos de Amazon RDS? Puede usar etiquetas para hacer lo siguiente: + Clasifique sus recursos de RDS por aplicación, proyecto, departamento, entorno, etc. Por ejemplo, puede usar una clave de etiqueta para definir una categoría en la que el valor de la etiqueta sea un elemento dentro de esa categoría. Podría crear la etiqueta `environment=prod`. También podría definir una clave de etiqueta de `project` y un valor de etiqueta de `Salix` para indicar que se ha asignado un recurso de Amazon RDS al proyecto Salix. + Automatice las tareas de administración de recursos. Por ejemplo, podría crear una ventana de mantenimiento para las instancias etiquetadas con `environment=prod` que sea diferente de la ventana para las instancias etiquetadas con `environment=test`. También puede configurar instantáneas de bases de datos automáticas para las instancias etiquetadas con `environment=prod`. + Controle el acceso a los recursos de RDS dentro de una política de IAM. Para ello, utilice la clave de condición `aws:ResourceTag/tag-key` global. Por ejemplo, una política podría permitir que solo los usuarios del grupo `DBAdmin` modifiquen las instancias de base de datos etiquetadas con `environment=prod`. Para obtener más información sobre la administración del acceso a los recursos etiquetados con políticas de IAM, consulte [Administración de la identidad y el acceso en Amazon Aurora](UsingWithRDS.IAM.md) y [Control del acceso a los recursos de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources) en la *Guía del usuario de AWS Identity and Access Management*. + Supervise los recursos en función de una etiqueta. Por ejemplo, puede crear un panel de Amazon CloudWatch para instancias de base de datos etiquetadas con `environment=prod`. + Realice un seguimiento de los costos agrupando los gastos por recursos con etiquetas similares. Por ejemplo, si etiqueta los recursos de RDS asociados al proyecto de Salix con `project=Salix`, puede generar informes de costos y asignar los gastos a este proyecto. Para obtener más información, consulte [Funcionamiento de la facturación de AWS con etiquetas en Amazon RDS](#Tagging.Billing). ## Funcionamiento de las etiquetas de recursos de Amazon RDS AWS no aplica ningún significado semántico a las etiquetas. Las etiquetas se interpretan estrictamente como cadenas de caracteres. **Topics** + [Conjuntos de etiquetas en Amazon RDS](#Overview.Tagging.Sets) + [Estructura de etiquetas en Amazon RDS](#Overview.Tagging.Structure) + [Recursos de Amazon RDS aptos para el etiquetado](#Overview.Tagging.Resources) + [Funcionamiento de la facturación de AWS con etiquetas en Amazon RDS](#Tagging.Billing) ### Conjuntos de etiquetas en Amazon RDS Cada recurso de Amazon RDS tiene un contenedor denominado conjunto de etiquetas. El contenedor incluye todas las etiquetas asignadas al recurso. Un recurso tiene exactamente un conjunto de etiquetas. Un conjunto de etiquetas contiene de 0 a 50 etiquetas. Si agrega una etiqueta a un recurso de RDS con la misma clave que una etiqueta existente, el nuevo valor sobrescribirá al antiguo. ### Estructura de etiquetas en Amazon RDS La estructura de una etiqueta de RDS es la siguiente: **Clave de etiqueta** La clave de la etiqueta es el nombre obligatorio de la etiqueta. El valor de la cadena debe tener una longitud de entre 1 y 128 caracteres Unicode y no puede llevar el prefijo `aws:` ni `rds:`. La cadena puede contener únicamente el conjunto de letras Unicode, dígitos, espacio en blanco, `_`, `.`, `:`, `/`, `=`, `+`, `-` y `@`. La expresión regular de Java es `"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$"`. Las claves de etiqueta distinguen entre mayúsculas y minúsculas. Por lo tanto, las claves `project` y `Project` son distintas. Una clave es única en un conjunto de etiquetas. Por ejemplo, en un conjunto de etiquetas no puede haber claves iguales pero con valores diferentes, como `project=Trinity` y `project=Xanadu`. **Valor de etiqueta** El valor es un valor de cadena opcional en la etiqueta. El valor de la cadena debe tener una longitud de entre 1 y 256 caracteres Unicode. La cadena puede contener únicamente el conjunto de letras Unicode, dígitos, espacio en blanco, `_`, `.`, `:`, `/`, `=`, `+`, `-` y `@`. La expresión regular de Java es `"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$"`. Los valores distinguen entre mayúsculas y minúsculas. Por lo tanto, los valores `prod` y `Prod` son distintos. Los valores no tienen que 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`. ### Recursos de Amazon RDS aptos para el etiquetado Puede etiquetar los siguientes recursos de Amazon RDS: + Instancias de base de datos + Clústeres de base de datos + Puntos de conexión de 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 bases de datos + Grupos de subred de base de datos + Proxies de RDS Proxy + Puntos de enlace de RDS Proxy **nota** Actualmente, no puede etiquetar los proxies de RDS ni los puntos de conexión de proxies de RDS mediante la Consola de administración de AWS. + Implementaciones azul/verde + Integraciones sin ETL (versión preliminar) + Copias de seguridad automatizadas + Copias de seguridad automatizadas del clúster ### Funcionamiento de la facturación de AWS con etiquetas en Amazon RDS Puede usar etiquetas para organizar la factura de AWS de modo que refleje su propia estructura de costos. Para ello, inscríbase para obtener una factura de 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 [Uso de etiquetas de asignación de costos](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) en la *Guía del usuario de AWS Billing*. #### Funcionamiento de las etiquetas de asignación de costos con las instantáneas de clústeres de bases de datos Puede añadir una etiqueta a una instantánea de clúster de base de datos. Sin embargo, la factura no reflejará esta agrupación. Para que las etiquetas de asignación de costos se apliquen a las instantáneas de clúster de base de datos, se deben cumplir las siguientes condiciones: + Las etiquetas se deben asociar a la instancia de base de datos principal. + La instancia de base de datos principal debe existir en la misma Cuenta de AWS que la instantánea del clúster de base de datos. + La instancia de base de datos principal debe existir en la misma Región de AWS que la instantánea del clúster de base de datos. Las instantáneas del clúster de base de datos se consideran huérfanas si no existen en la misma región que la instancia de base de datos principal, o bien si la instancia de base de datos principal se elimina. Las instantáneas de bases de datos huérfanas no admiten etiquetas de asignación de costos. Los costos de las instantáneas huérfanas se agregan en un único elemento de línea sin etiquetar. Las instantáneas de clústeres de bases de datos entre cuentas no se consideran huérfanas cuando se cumplen las siguientes condiciones: + Existen en la misma región que la instancia de base de datos principal. + La instancia de base de datos principal es propiedad de la cuenta de origen. **nota** Si la instancia de base de datos principal pertenece a una cuenta diferente, las etiquetas de asignación de costos no se aplican a las instantáneas entre cuentas de la cuenta de destino. ## Prácticas recomendadas para el etiquetado de los recursos de Amazon RDS Al utilizar etiquetas, le sugerimos que siga las siguientes prácticas recomendadas: + Documente las convenciones sobre el uso de etiquetas que siguen todos los equipos de su organización. En concreto, asegúrese de que los nombres sean descriptivos y coherentes. Por ejemplo, estandarice el formato `environment:prod` en lugar de etiquetar algunos recursos con `env:production`. **importante** No almacene información de identificación personal (PII) ni otra información confidencial en las etiquetas. + Automatice el etiquetado para garantizar la coherencia. Por ejemplo, puede utilizar las siguientes técnicas: + Incluya etiquetas en una plantilla de CloudFormation. Al crear recursos con la plantilla, los recursos se etiquetan automáticamente. + Defina y aplique etiquetas mediante funciones de AWS Lambda. + Cree un documento SSM que incluya los pasos para añadir etiquetas a sus recursos de RDS. + Use las etiquetas solo cuando sea necesario. Puede añadir hasta 50 etiquetas para un único recurso de RDS, pero se recomienda evitar la complejidad y la proliferación innecesarias de etiquetas. + Revise las etiquetas periódicamente para comprobar su relevancia y precisión. Elimine o modifique las etiquetas obsoletas según sea necesario. + Plantéese la posibilidad de crear etiquetas con el editor de etiquetas de AWS en la Consola de administración de AWS. Puede utilizar el editor de etiquetas para añadir etiquetas a varios recursos de AWS compatibles, incluidos los recursos de RDS, al mismo tiempo. Para obtener más información, consulte el [Editor de etiquetas](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) en la *Guía del usuario de grupos de recursos de AWS*. ## Copia de etiquetas a instantáneas de clúster de base de datos Al crear o restaurar un clúster de base de datos, puede especificar que las etiquetas del clúster se copien en instantáneas del clúster de base de datos. La copia de las etiquetas garantiza que los metadatos para las instantáneas coincidan con los del clúster de base de datos de origen. Además, garantiza que cualquier política de acceso para las instantáneas de base de datos también coincida con las del clúster 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 un clúster de base de datos + Restauración de un clúster de base de datos + Creación de una réplica de lectura + Copia de una instantánea de clúster de base de datos **nota** En algunos casos, puede incluir un valor para el parámetro `--tags` del comando [create-db-snapshot](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-snapshot.html) de la AWS CLI. O puede proporcionar al menos una etiqueta a la operación de la API [CreateDBSnapshot](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBSnapshot.html). En estos casos, RDS no copia las etiquetas de la instancia de base de datos de origen a 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`) activada. 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. Este enfoque evita añadir etiquetas que no se apliquen a la nueva instancia de base de datos. La instantánea de base de datos se crea mediante el comando `create-db-snapshot` de AWS CLI (o la operación de la API `CreateDBSnapshot` RDS). Después de crear la instantánea de la base de datos, puede añadir etiquetas como se describe más adelante en este tema. ## Etiquetado de los recursos de copia de seguridad automatizada Los recursos de copia de seguridad automatizada se crean cuando el período de retención de copias de seguridad se establece entre 0 y un valor superior a 0. Puede etiquetar los recursos de copia de seguridad automatizada de la instancia o el clúster durante su creación mediante el parámetro `--tag-specifications`. ### Parámetro tag-specifications Las API que admiten el parámetro de solicitud `--tag-specifications` (como [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html), [restore-db-instance-from-db-snapshot](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-db-snapshot.html), [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html), etc.) pueden etiquetar las copias de seguridad automatizadas (tipo de recurso: `auto-backup` o `cluster-auto-backup`) durante su creación. #### Etiquetado de copias de seguridad automatizadas del clúster Use `--tag-specifications` con `ResourceType=cluster-auto-backup` al crear clústeres de base de datos que tengan habilitadas las copias de seguridad automatizadas. **nota** Las etiquetas de copia de seguridad automatizada son independientes de las etiquetas de instancia de base de datos de origen, las etiquetas de clúster de base de datos o las etiquetas de instantánea de base de datos. ## Añadido y eliminación de etiquetas en Amazon RDS Se puede hacer lo siguiente: + Cree etiquetas al crear un recurso, por ejemplo, al ejecutar el comando `create-db-instance` de la AWS CLI. + Añada etiquetas a un recurso existente con el comando `add-tags-to-resource`. + Enumere las etiquetas asociadas a un recurso específico con el comando `list-tags-for-resource`. + Actualice las etiquetas con el comando `add-tags-to-resource`. + Elimine las etiquetas de un recurso con el comando `remove-tags-from-resource`. Los procedimientos siguientes muestran cómo realizar operaciones de etiquetado típicas en recursos relacionados con instancias de base de datos y clústeres de base de datos de Aurora. Tenga en cuenta que las etiquetas se almacenan en caché con fines de autorización. Por este motivo, al añadir o actualizar etiquetas en los recursos de Amazon RDS, pueden pasar varios minutos hasta que las modificaciones estén disponibles. ### Consola 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/](https://console.aws.amazon.com/rds/). 1. 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. 1. Seleccione el nombre de la instancia de base de datos que desea etiquetar para mostrar sus detalles. 1. En la sección de detalles, desplácese hasta la sección **Tags** (Etiquetas). 1. Elija **Add (Añadir)**. Aparece la ventana **Add tags** (Añadir etiquetas). ![\[Ventana para añadir etiquetas\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/AuroraUserGuide/images/RDSConsoleTagging5.png) 1. Escriba un valor para **Tag key (Clave de etiqueta)** y **Value (Valor)**. 1. 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. 1. Elija **Add (Añadir)**. **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/](https://console.aws.amazon.com/rds/). 1. 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. 1. Seleccione el nombre de la instancia de base de datos para mostrar sus detalles. 1. En la sección de detalles, desplácese hasta la sección **Tags** (Etiquetas). 1. Elija la etiqueta desea eliminar. ![\[Sección de etiquetas\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/AuroraUserGuide/images/RDSConsoleTagging6.png) 1. Elija **Delete (Eliminar)** y después elija **(Eliminar)** en la ventana **Delete tags (Eliminar etiquetas)**. ### AWS CLI Puede utilizar la para agregar, listar o eliminar etiquetas de una instancia de base de dato AWS CLI. + Para agregar una o más etiquetas a un recurso de Amazon RDS, utilice el comando [https://docs.aws.amazon.com/cli/latest/reference/rds/add-tags-to-resource.html](https://docs.aws.amazon.com/cli/latest/reference/rds/add-tags-to-resource.html) de la AWS CLI. + Para ver una lista de las etiquetas de un recurso de Amazon RDS, utilice el comando [https://docs.aws.amazon.com/cli/latest/reference/rds/list-tags-for-resource.html](https://docs.aws.amazon.com/cli/latest/reference/rds/list-tags-for-resource.html) de la AWS CLI. + Para eliminar una o más etiquetas de un recurso de Amazon RDS, utilice el comando [https://docs.aws.amazon.com/cli/latest/reference/rds/remove-tags-from-resource.html](https://docs.aws.amazon.com/cli/latest/reference/rds/remove-tags-from-resource.html) 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](USER_Tagging.ARN.Constructing.md). ### API de 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 [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_AddTagsToResource.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_AddTagsToResource.html). + Para ver una lista de las etiquetas asignadas a un recurso de Amazon RDS, utilice [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ListTagsForResource.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ListTagsForResource.html). + Para eliminar etiquetas de un recurso de Amazon RDS, utilice la operación [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RemoveTagsFromResource.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RemoveTagsFromResource.html). Para obtener más información acerca de cómo crear el ARN requerido, consulte [Creación de un nombre ARN para Amazon RDS](USER_Tagging.ARN.Constructing.md). Cuando se trabaja con XML mediante la API de Amazon RDS, las etiquetas utilizan el esquema siguiente: ``` 1. 2. 3. 4. Project 5. Trinity 6. 7. 8. User 9. Jones 10. 11. 12. ``` La tabla siguiente proporciona una lista de las etiquetas XML permitidas y sus características. Los valores de `Key` y `Value` distinguen entre mayúsculas y minúsculas. Por ejemplo, `project=Trinity` y `PROJECT=Trinity` son dos etiquetas diferentes. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html) # Tutorial: Uso de etiquetas para especificar qué clústeres de base de datos de Aurora se deben detener Supongamos que crea una serie de clústeres de Aurora base de datos en un entorno de desarrollo o prueba. Necesita conservar todos estos clústeres durante varios días. Algunos de los clústeres ejecutan pruebas durante la noche. Otros clústeres se pueden detener durante la noche y comenzar de nuevo al día siguiente. En el ejemplo siguiente se muestra cómo asignar una etiqueta a los clústeres adecuados para detenerse durante la noche. A continuación, el ejemplo muestra cómo un script puede detectar qué clústeres tienen esa etiqueta y, entonces, detenerlos. En este ejemplo, la parte del valor del par clave-valor no importa. La presencia de la `stoppable` etiqueta significa que el clúster tiene esta propiedad definida por el usuario. **Para especificar qué clústeres de base de datos de Aurora se deben detener** 1. Determine el ARN de un clúster que queremos designar como detenible. Los comandos y las API para etiquetar funcionan con los ARN. De esta forma, pueden funcionar sin problemas en regiones de AWS, cuentas de AWS y diferentes tipos de recursos que pueden tener nombres cortos idénticos. Puede especificar el ARN en lugar del ID de clúster en los comandos CLI que operan en clústeres. Sustituya el nombre de su propio clúster por *dev-test-clúster*. En comandos posteriores que utilicen parámetros ARN, sustituya el ARN de su propio clúster. El ARN incluye el propio ID de cuenta de AWS y el nombre de la región de AWS donde se encuentra el clúster. ``` $ aws rds describe-db-clusters --db-cluster-identifier dev-test-cluster \ --query "*[].{DBClusterArn:DBClusterArn}" --output text arn:aws:rds:us-east-1:123456789:cluster:dev-test-cluster ``` 1. Agregue la etiqueta `stoppable` a este clúster. Usted elige el nombre de esta etiqueta. Este enfoque significa que puede evitar diseñar una convención de nomenclatura que codifique toda la información relevante en los nombres. En una convención de este tipo, puede codificar la información en el nombre de la instancia de base de datos o en los nombres de otros recursos. Dado que en este ejemplo se trata la etiqueta como un atributo presente o ausente, se omite la `Value=` parte del `--tags` parámetro. ``` $ aws rds add-tags-to-resource \ --resource-name arn:aws:rds:us-east-1:123456789:cluster:dev-test-cluster \ --tags Key=stoppable ``` 1. Confirme que la etiqueta está presente en el clúster. Estos comandos recuperan la información de etiqueta para el clúster en formato JSON y en texto plano separado por tabulaciones. ``` $ aws rds list-tags-for-resource \ --resource-name arn:aws:rds:us-east-1:123456789:cluster:dev-test-cluster { "TagList": [ { "Key": "stoppable", "Value": "" } ] } $ aws rds list-tags-for-resource \ --resource-name arn:aws:rds:us-east-1:123456789:cluster:dev-test-cluster --output text TAGLIST stoppable ``` 1. Para detener todos los clústeres designados como `stoppable`, prepare una lista de todos los clústeres. Recorra la lista y compruebe si cada clúster está etiquetado con el atributo correspondiente. Este ejemplo de Linux utiliza scripts shell a fin de guardar la lista de las ARN de clúster en un archivo temporal y, a continuación, ejecutar comandos de CLI para cada clúster. ``` $ aws rds describe-db-clusters --query "*[].[DBClusterArn]" --output text >/tmp/cluster_arns.lst $ for arn in $(cat /tmp/cluster_arns.lst) do match="$(aws rds list-tags-for-resource --resource-name $arn --output text | grep 'TAGLIST\tstoppable')" if [[ ! -z "$match" ]] then echo "Cluster $arn is tagged as stoppable. Stopping it now." # Note that you can specify the full ARN value as the parameter instead of the short ID 'dev-test-cluster'. aws rds stop-db-cluster --db-cluster-identifier $arn fi done Cluster arn:aws:rds:us-east-1:123456789:cluster:dev-test-cluster is tagged as stoppable. Stopping it now. { "DBCluster": { "AllocatedStorage": 1, "AvailabilityZones": [ "us-east-1e", "us-east-1c", "us-east-1d" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "dev-test-cluster", ... ``` Puede ejecutar un script como este al final de cada día para asegurarse de que los clústeres no esenciales se detienen. También puede programar un trabajo al usar una utilidad como `cron` para realizar dicha comprobación cada noche. Por ejemplo, puede hacer esto en caso de que algunos clústeres de base de datos siguieran ejecutándose por error. Aquí, puede ajustar el comando que prepara la lista de clústeres para comprobar. El siguiente comando produce una lista de los clústeres, pero sólo los que están en `available` estado. El script puede ignorar los clústeres que ya están detenidos, porque tendrán valores de estado diferentes, como `stopped` o `stopping`. ``` $ aws rds describe-db-clusters \ --query '*[].{DBClusterArn:DBClusterArn,Status:Status}|[?Status == `available`]|[].{DBClusterArn:DBClusterArn}' \ --output text arn:aws:rds:us-east-1:123456789:cluster:cluster-2447 arn:aws:rds:us-east-1:123456789:cluster:cluster-3395 arn:aws:rds:us-east-1:123456789:cluster:dev-test-cluster arn:aws:rds:us-east-1:123456789:cluster:pg2-cluster ``` **sugerencia** Puede utilizar la asignación de etiquetas y la búsqueda de clústeres con esas etiquetas para reducir costos de otras maneras. Por ejemplo, veamos este escenario con clústeres de base de datos de Aurora utilizadas para el desarrollo y las pruebas. En este caso puede designar algunos clústeres para que se eliminen al final de cada día o que solo se eliminen las instancias de base de datos de lector. O puede designar algunos para que sus instancias de base de datos se cambien a clases de instancias de base de datos pequeñas durante los períodos de uso escaso previsto.