# Etiquetado de los recursos de 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 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 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 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 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, Amazon RDS 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 base de datos ](#USER_Tagging.CopyTags) + [ ## 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: especificar qué instancias de base de datos se deben detener mediante etiquetas ](Tagging.RDS.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 RDS](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 de bases de datos Puede añadir una etiqueta a una instantánea de 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 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 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 de base de datos. Las instantáneas 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 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 base de datos 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 coincidan con los de la instancia 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 la de la instancia de base de datos de origen. 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 Para copiar las etiquetas de las acciones anteriores, elija **Copiar etiquetas a las instantáneas** en la Consola de administración de AWS, o especifique `--copy-tags-to-snapshot` en la AWS CLI. Al copiar una instantánea de base de datos, solo puede copiar las etiquetas asociadas si copia la instantánea de base de datos en la misma cuenta. No puede copiar etiquetas al copiar una instantánea de base de datos entre cuentas. En la mayoría de los casos, las etiquetas no se copian de forma predeterminada. Sin embargo, al restaurar una instancia de base de datos desde una instantánea de base de datos, RDS verifica si se especifican nuevas etiquetas. En caso afirmativo, las nuevas etiquetas se agregan a la instancia de base de datos restaurada. Si no hay etiquetas nuevas y la instantánea de base de datos está en la misma cuenta que la instancia de base de datos de origen, RDS agrega las etiquetas de la instancia de base de datos de origen al crear la instantánea de la instancia de base de datos restaurada. RDS no agrega etiquetas desde la instancia de base de datos de origen si la instantánea de base de datos se copia en otra cuenta y se restaura en ella. Para evitar que se agreguen etiquetas desde instancias de base de datos de origen a instancias de base de datos restauradas, le recomendamos que especifique nuevas etiquetas al restaurar una instancia de base de datos. **nota** En algunos casos, puede incluir un valor para el`--tags` parámetro delAWS CLI comando [create-db-snapshot](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-snapshot.html). 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 de la instancia Use `--tag-specifications` con `ResourceType=auto-backup` al crear o modificar instancias de base de datos que tengan habilitadas las copias de seguridad automatizadas. #### 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. #### Etiquetado de copias de seguridad automatizadas al modificar la instancia de base de datos Solo puede etiquetar las copias de seguridad automatizadas mediante `--tag-specifications` al establecer la retención de copias de seguridad entre 0 y un valor superior a 0. Si ya existen copias de seguridad automatizadas, utilice la API [AddTagsToResource](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_AddTagsToResource.html) en su lugar. **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. 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/UserGuide/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/UserGuide/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/UserGuide/USER_Tagging.html) # Tutorial: especificar qué instancias de base de datos se deben detener mediante etiquetas Este tutorial supone que tiene varias instancias de base de datos en un entorno de desarrollo o prueba. Debe mantener todas estas instancias de base de datos durante varios días. Algunas instancias de base de datos puede ejecutar pruebas por la noche, mientras que otras se pueden detener durante la noche y volver a iniciarse al día siguiente. El siguiente tutorial muestra cómo asignar una etiqueta a instancias de base de datos que son adecuadas para detenerse durante la noche. El tutorial muestra cómo un script puede detectar qué instancias de base de datos tienen esa etiqueta y, a continuación, detener esas instancias de base de datos. En este ejemplo, la parte del valor del par clave-valor no importa. La presencia de la `stoppable` etiqueta significa que la instancia de base de datos tiene esta propiedad definida por el usuario. En el siguiente tutorial, los comandos y las API de etiquetado funcionan con ARN, lo que permite a RDS 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 instancia de base de datos en los comandos CLI que operan en instancias de base de datos. **Para especificar qué instancias de base de datos se deben detener** 1. Determine el ARN de una instancia de base de datos que queremos designar como detenible. En el siguiente ejemplo, sustituya el nombre de las propias instancias de base de datos por *dev-test-db-instance*. En comandos posteriores que utilicen parámetros ARN, sustituya el ARN de la propia instancia de base de datos. El ARN incluye el propio ID de cuenta de AWS y el nombre de la región de AWS donde se encuentra la instancia de base de datos. ``` $ aws rds describe-db-instances --db-instance-identifier dev-test-db-instance \ --query "*[].{DBInstance:DBInstanceArn}" --output text arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance ``` 1. Agregue la etiqueta `stoppable` a esta instancia de base de datos. Usted elige el nombre de esta etiqueta. Dado que en este ejemplo se trata la etiqueta como un atributo presente o ausente, se omite la `Value=` parte del `--tags` parámetro. 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. ``` $ aws rds add-tags-to-resource \ --resource-name arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance \ --tags Key=stoppable ``` 1. Confirme que la etiqueta está presente en la instancia de base de datos. Los siguientes comandos recuperan la información de etiqueta para la instancia de base de datos en formato JSON y en texto sin formato separado por tabulaciones. ``` $ aws rds list-tags-for-resource \ --resource-name arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance { "TagList": [ { "Key": "stoppable", "Value": "" } ] } aws rds list-tags-for-resource \ --resource-name arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance --output text TAGLIST stoppable ``` 1. Detenga todas las instancias de base de datos designadas como `stoppable`. En el siguiente ejemplo, se crea un archivo de texto que enumera todas las instancias de base de datos. El comando de intérprete de comandos recorre la lista y comprueba si cada instancia de base de datos está etiquetada con el atributo correspondiente y ejecuta el comando `aws rds stop-db-instance` para cada instancia de base de datos. ``` $ aws rds describe-db-instances --query "*[].[DBInstanceArn]" --output text >/tmp/db_instance_arns.lst $ for arn in $(cat /tmp/db_instance_arns.lst) do match="$(aws rds list-tags-for-resource --resource-name $arn --output text | grep stoppable)" if [[ ! -z "$match" ]] then echo "DB instance $arn is tagged as stoppable. Stopping it now." # Note that you need to get the DB instance identifier from the ARN. dbid=$(echo $arn | sed -e 's/.*://') aws rds stop-db-instance --db-instance-identifier $dbid fi done DB instance arn:arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance is tagged as stoppable. Stopping it now. { "DBInstance": { "DBInstanceIdentifier": "dev-test-db-instance", "DBInstanceClass": "db.t3.medium", ... ``` Puede ejecutar un script como el anterior al final de cada día para asegurarse de que se detienen las instancias de base de datos no esenciales. 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 algunas instancias de base de datos siguieran ejecutándose por error. Aquí, puede ajustar el comando que prepara la lista de instancias de base de datos para comprobar. El siguiente comando produce una lista de las instancias de base de datos, pero sólo las que están en `available` estado. El script puede ignorar las instancias de base de datos que ya están detenidas, porque tendrán valores de estado diferentes, como `stopped` o `stopping`. ``` $ aws rds describe-db-instances \ --query '*[].{DBInstanceArn:DBInstanceArn,DBInstanceStatus:DBInstanceStatus}|[?DBInstanceStatus == `available`]|[].{DBInstanceArn:DBInstanceArn}' \ --output text arn:aws:rds:us-east-1:123456789102:db:db-instance-2447 arn:aws:rds:us-east-1:123456789102:db:db-instance-3395 arn:aws:rds:us-east-1:123456789102:db:dev-test-db-instance arn:aws:rds:us-east-1:123456789102:db:pg2-db-instance ``` **sugerencia** Puede utilizar la asignación de etiquetas y la búsqueda de instancias de base de datos con esas etiquetas para reducir costos de otras maneras. Por ejemplo, veamos este escenario con instancias de base de datos utilizadas para el desarrollo y las pruebas. En este caso, puede designar algunas instancias de base de datos para que se eliminen al final de cada día. O puede designarlos 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.