Etiquetado de recursos de la base de datos global de Amazon Aurora - Amazon Aurora
Ejemplos de la AWS CLI de etiquetado para bases de datos globales

Etiquetado de recursos de la base de datos global de Amazon Aurora

Con la característica de la base de datos global de Aurora, puede aplicar etiquetas de RDS a los recursos en distintos niveles de una base de datos global. Si no está familiarizado con el uso de las etiquetas de AWS o los recursos de Aurora, consulte Etiquetado de los recursos de Amazon Aurora y Amazon RDS antes de aplicar etiquetas en su base de datos global.

nota

Como los datos de las etiquetas de los procesos de AWS forman parte de sus mecanismos de elaboración de informes de costes, no incluya ningún dato confidencial ni información de identificación personal (PII) en los nombres o valores de las etiquetas.

Puede aplicar etiquetas a los siguientes tipos de recursos de una base de datos global:

  • El objeto contenedor de toda la base de datos global. Este recurso se conoce como clúster global.

    Después de crear el clúster global mediante la operación Agregar región de AWS en la consola, puede agregar etiquetas mediante la página de detalles del clúster global. En la pestaña Etiquetas de la página de detalles del clúster global, puede agregar, eliminar o modificar las etiquetas y sus valores asociados seleccionando Administrar etiquetas.

    Con la API de RDS y la AWS CLI, puede agregar etiquetas al clúster global al mismo tiempo que lo crea. También puede agregar, eliminar o modificar etiquetas para un clúster global existente.

  • El clúster principal. Aquí se utilizan los mismos procedimientos para trabajar con etiquetas que para los clústeres de Aurora independientes. Puede configurar las etiquetas antes de convertir el clúster de Aurora original en una base de datos global. Puede agregar, eliminar o modificar las etiquetas y sus valores asociados seleccionando Administrar etiquetas en la pestaña Etiquetas de la página de detalles del clúster de base de datos global.

  • Cualquier clúster secundario. Aquí se utilizan los mismos procedimientos para trabajar con etiquetas que para los clústeres de Aurora independientes. Puede configurar las etiquetas al mismo tiempo que crea un clúster de Aurora secundario mediante la acción Agregar región de AWS en la consola. Puede agregar, eliminar o modificar las etiquetas y sus valores asociados seleccionando Administrar etiquetas en la pestaña Etiquetas de la página de detalles del clúster de base de datos global.

  • Instancias de bases de datos individuales dentro de los clústeres principal o secundario. Aquí se utilizan los mismos procedimientos para trabajar con etiquetas que para las instancias de base de datos de Aurora o RDS. Puede configurar las etiquetas al mismo tiempo que agrega una nueva instancia de base de datos al clúster de Aurora secundario mediante la acción Agregar lector en la consola. Puede agregar, eliminar o modificar las etiquetas y sus valores asociados seleccionando Administrar etiquetas en la pestaña Etiquetas de la página de detalles de la instancia de base de datos.

Estos son algunos ejemplos de los tipos de etiquetas que puede asignar en una base de datos global:

  • Puede agregar etiquetas al clúster global para registrar información general sobre su aplicación, como identificadores anónimos que representen a los propietarios y contactos de su organización. Puede utilizar etiquetas para representar las propiedades de la aplicación que utiliza la base de datos global.

  • Puede agregar etiquetas al clúster principal y a los clústeres secundarios para realizar un seguimiento de los costos de la aplicación a nivel de la región de AWS. Para obtener información acerca del procedimiento, consulte Funcionamiento de la facturación de AWS con etiquetas en Amazon RDS.

  • Puede agregar etiquetas a instancias de base de datos específicas con los clústeres de Aurora para indicar su propósito especial. Por ejemplo, dentro del clúster principal, es posible que tenga una instancia del lector con una prioridad de conmutación por error baja que se utilice exclusivamente para la generación de informes. Una etiqueta puede distinguir esta instancia de base de datos de uso especial de otras instancias dedicadas a la alta disponibilidad dentro del clúster principal.

  • Puede utilizar etiquetas en todos los niveles de los recursos de su base de datos global para controlar el acceso mediante las políticas de IAM. Para obtener más información, consulte Control del acceso a recursos de AWS en la Guía del usuario de AWS Identity and Access Management.

    sugerencia

    En la AWS Management Console, agregue etiquetas al contenedor del clúster global como un paso independiente después de crearlo. Si desea evitar cualquier intervalo de tiempo en el que el clúster global exista sin etiquetas de control de acceso, puede aplicar las etiquetas durante la operación CreateGlobalCluster creando ese recurso mediante la AWS CLI, la API de RDS o una plantilla de AWS CloudFormation.

  • Puede usar etiquetas a nivel de clúster, o para el clúster global, para registrar información sobre el control de calidad y las pruebas de su aplicación. Por ejemplo, puede especificar una etiqueta en un clúster de base de datos para registrar la última vez que realizó una transición a ese clúster. Puede especificar una etiqueta en el clúster global para registrar la hora del último simulacro de recuperación ante desastres de toda la aplicación.

Ejemplos de la AWS CLI de etiquetado para bases de datos globales

Los siguientes ejemplos de la AWS CLI muestran cómo puede especificar y examinar las etiquetas de todos los tipos de recursos de Aurora de su base de datos global.

Puede especificar etiquetas para el contenedor de clústeres global con el comando create-global-cluster. En el siguiente ejemplo se crea un clúster global y se le asignan dos etiquetas. Las etiquetas tienen claves tag1 y tag2. 

$  aws rds create-global-cluster --global-cluster-identifier my_global_cluster_id \
  --engine aurora-mysql --tags Key=tag1,Value=val1 Key=tag2,Value=val2

Puede enumerar las etiquetas en el contenedor de clústeres global con el comando describe-global-clusters. Cuando se trabaja con etiquetas, se suele ejecutar primero este comando para recuperar el nombre de recurso de Amazon (ARN) del clúster global. El ARN se utiliza como parámetro en los siguientes comandos para trabajar con etiquetas. El siguiente comando muestra la información de etiqueta del atributo TagList. También muestra el ARN, que se utiliza como parámetro en los ejemplos posteriores. 

$  aws rds describe-global-clusters --global-cluster-identifier my_global_cluster_id
{
    "GlobalClusters": [
        {
            "Status": "available",
            "Engine": "aurora-mysql",
            "GlobalClusterArn": "my_global_cluster_arn",
            ...
            "TagList": [
                {
                    "Value": "val1",
                    "Key": "tag1"
                },
                {
                    "Value": "val2",
                    "Key": "tag2"
                }
            ]
        }
    ]
}

Puede agregar etiquetas nuevas con el comando add-tags-to-resource. Con este comando, se especifica el nombre de recurso de Amazon (ARN) del clúster global en lugar de su identificador. Si agrega una etiqueta con el mismo nombre que una etiqueta existente, se sobrescribirá el valor de esa etiqueta. Si incluye espacios o caracteres especiales en los valores de las etiquetas, cite los valores según corresponda para su sistema operativo o intérprete de comandos. En el siguiente ejemplo se modifican las etiquetas del clúster global del ejemplo anterior. Originalmente, el clúster tenía etiquetas con claves tag1 y tag2. Una vez finalizado el comando, el clúster global tiene una nueva etiqueta con clave tag3 y la etiqueta con clave tag1 tiene un valor diferente. 

$  aws rds add-tags-to-resource --resource-name my_global_cluster_arn \
  --tags Key=tag1,Value="new value for tag1" Key=tag3,Value="entirely new tag"

$  aws rds describe-global-clusters --global-cluster-identifier my_global_cluster_id
{
    "GlobalClusters": [
        {
            "Status": "available",
            "Engine": "aurora-mysql",
            ...
            "TagList": [
                {
                    "Value": "new value for tag1",
                    "Key": "tag1"
                },
                {
                    "Value": "val2",
                    "Key": "tag2"
                },
                {
                    "Value": "entirely new tag",
                    "Key": "tag3"
                }
            ]
        }
    ]
}

Puede eliminar una etiqueta del clúster global con el comando remove-tags-from-resource. Con este comando, solo se especifica un conjunto de claves de etiqueta, sin ningún valor de etiqueta. En el siguiente ejemplo se modifican las etiquetas del clúster global del ejemplo anterior. Originalmente, el clúster tenía etiquetas con claves tag1, tag2 y tag3. Una vez finalizado el comando, solo queda la etiqueta con la clave tag1. 

$  aws rds remove-tags-from-resource --resource-name my_global_cluster_arn --tag-keys tag2 tag3

$  aws rds describe-global-clusters --global-cluster-identifier my_global_cluster_id
{
    "GlobalClusters": [
        {
            "Status": "available",
            "Engine": "aurora-mysql",
            ...
            "TagList": [
                {
                    "Value": "new value for tag1",
                    "Key": "tag1"
                }
            ]
        }
    ]
}