Etiquetado de recursos de Amazon DocumentDB

Puede utilizar etiquetas de Amazon DocumentDB (con compatibilidad con MongoDB) para agregar metadatos a los recursos de Amazon DocumentDB. Estas etiquetas se pueden utilizar junto con políticas de AWS Identity and Access Management (IAM) para administrar el acceso a los recursos de Amazon DocumentDB y para controlar qué acciones se pueden aplicar a los recursos. También puede utilizar etiquetas para hacer un seguimiento de los costos, agrupando los gastos correspondientes en recursos con etiquetas similares.

Puede etiquetar los siguientes recursos de Amazon DocumentDB:

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

Las etiquetas de Amazon DocumentDB son pares nombre-valor que el usuario define y asocia a un recurso de Amazon DocumentDB. 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 DocumentDB. 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 project y un valor de etiqueta de Salix para indicar que el recurso de Amazon DocumentDB se asigna al proyecto Salix. Asimismo, puede utilizar etiquetas para designar recursos de Amazon DocumentDB 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 DocumentDB.

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 los costos totales de la aplicación en distintos servicios. Para obtener más información, consulte Uso de etiquetas de asignación de costos en la AWSGuía del usuario de Administración de facturación y costos.

Cada recurso de Amazon DocumentDB tiene un conjunto de etiquetas que contiene todas las etiquetas asignadas a ese recurso. Un conjunto de etiquetas puede contener hasta 10 etiquetas, y también puede estar vacío. Si agrega una etiqueta a un recurso de Amazon DocumentDB 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 DocumentDB puede definir etiquetas en una instancia u otros recursos de Amazon DocumentDB, según la configuración utilizada al crear el recurso. Por ejemplo, Amazon DocumentDB podría añadir una etiqueta que indique que una instancia es para producción o para la realización de pruebas.

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

Puede utilizar la AWS Management Console o la AWS CLI para añadir, mostrar y eliminar etiquetas de los recursos de Amazon DocumentDB. Si utiliza la AWS CLI, deberá proporcionar el nombre de recurso de Amazon (ARN) correspondiente al recurso con el que desee trabajar. Para obtener más información acerca de los ARN de Amazon DocumentDB, consulte Descripción de nombres de recurso de Amazon (ARN) en Amazon DocumentDB.

Restricciones de las etiquetas

Se aplican las siguientes restricciones de Amazon DocumentDB a las etiquetas:

Agregación y actualización de etiquetas en un recurso de Amazon DocumentDB

Puede agregar hasta 10 etiquetas a un recurso mediante la AWS Management Console o la AWS CLI.

Using the AWS Management Console

El proceso para añadir una etiqueta a un recurso es similar independientemente de a qué recurso añada la etiqueta. En este ejemplo, se añade una etiqueta a un clúster.

Para añadir o actualizar etiquetas a un clúster utilizando la consola

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

2. En el panel de navegación, seleccione clusters (clústeres).

3. Seleccione el nombre del clúster al que desea añadir etiquetas.

4. Desplácese hacia abajo hasta la sección Tags (Etiquetas) y, a continuación, elija Edit (Editar).

5. Para cada etiqueta que desee añadir a este recurso, haga lo siguiente:

   1. Para añadir una nueva etiqueta, escriba el nombre de la etiqueta en el cuadro Key (Clave). Para cambiar el valor de una etiqueta, busque el nombre de la etiqueta en la columna Key (Clave).

   2. Para asignar a la etiqueta un valor nuevo o actualizado, escriba un valor para la etiqueta en el cuadro Value (Valor).

   3. Si desea añadir más etiquetas, elija Add (Añadir). En caso contrario, cuando haya terminado, elija Save (Guardar).

Using the AWS CLI

El proceso para añadir una etiqueta a un recurso es similar independientemente de a qué recurso añada etiquetas. En este ejemplo, se añaden tres etiquetas a un clúster. La segunda etiqueta, key2, no tiene ningún valor.

Utilice la operación add-tags-to-resource de la AWS CLI con estos parámetros.

Parámetros

• --resource-name: el ARN del recurso Amazon DocumentDB al que desea agregar etiquetas.

• --tags: una lista de etiquetas (par clave-valor) que desea agregar a este recurso en el formato. Key=key-name,Value=tag-value

Para Linux, macOS o Unix:

aws docdb add-tags-to-resource \
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
    --tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3

Para Windows:

aws docdb add-tags-to-resource ^
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
    --tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3

La operación add-tags-to-resource no produce ningún resultado. Para ver los resultados de la operación, utilice la operación list-tags-for-resource.

Lista de etiquetas en un recurso de Amazon DocumentDB

Puede utilizar la AWS Management Console o la AWS CLI para obtener una lista de las etiquetas de un recurso de Amazon DocumentDB.

Using the AWS Management Console

El proceso para mostrar las etiquetas de un recurso es similar independientemente de a qué recurso añada la etiqueta. En este ejemplo, se muestran las etiquetas de un clúster.

Para mostrar las etiquetas en un clúster mediante la consola

1. Abra la consola de Amazon DocumentDB en https://console.aws.amazon.com/docdb.

2. En el panel de navegación, seleccione clusters (clústeres).

3. Seleccione el nombre del clúster para el que desea mostrar las etiquetas.

4. Para ver una lista de las etiquetas de este recurso, desplácese hacia abajo hasta la sección Tags (Etiquetas).

Using the AWS CLI

El proceso para mostrar las etiquetas de un recurso es similar independientemente del recurso cuyas etiquetas vaya a mostrar. En este ejemplo, se muestran las etiquetas de un clúster.

Utilice la operación list-tags-for-resource de la AWS CLI con estos parámetros.

Parámetros

• --resource-name: obligatorio. El ARN del recurso Amazon DocumentDB del que desea ver las etiquetas.

Para Linux, macOS o Unix:

aws docdb list-tags-for-resource \
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster

Para Windows:

aws docdb list-tags-for-resource ^
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster

La salida de esta operación será similar a lo que se indica a continuación (formato JSON).

{
    "TagList": [
        {
            "Key": "key1",
            "Value": "value1"
        },
        {
            "Key": "key2",
            "Value": ""
        },
        {
            "Key": "key3",
            "Value": "value3"
        }
    ]
}

Eliminación de etiquetas de un recurso de Amazon DocumentDB

Puede usar la AWS Management Console o la AWS CLI para eliminar etiquetas de recursos de Amazon DocumentDB.

Using the AWS Management Console

El proceso para eliminar etiquetas de un recurso es similar independientemente del recurso que vaya a eliminar. En este ejemplo, se eliminan las etiquetas de un clúster.

Para eliminar las etiquetas de un clúster mediante la consola

1. Abra la consola de Amazon DocumentDB en https://console.aws.amazon.com/docdb.

2. En el panel de navegación, seleccione clusters (clústeres).

3. Seleccione el nombre del clúster cuyas etiquetas desea eliminar.

4. Desplácese hacia abajo hasta la sección Tags (Etiquetas) y, a continuación, elija Edit (Editar).

5. Si desea eliminar todas las etiquetas de este recurso, seleccione Remove all (Eliminar todas). De lo contrario, para cada etiqueta que desee eliminar de este recurso, haga lo siguiente:

   1. Localice el nombre de la etiqueta en la columna Key (Clave).

   2. Elija Remove (Eliminar) en la misma fila que la clave de etiqueta.

   3. Cuando termine, elija Guardar.

Using the AWS CLI

El proceso para eliminar una etiqueta de un recurso es similar independientemente del recurso del que vaya a eliminar una etiqueta. En este ejemplo, se elimina una etiqueta de un clúster.

Utilice la operación remove-tags-from-resource de la AWS CLI con estos parámetros.

• --resource-name: obligatorio. El ARN del recurso Amazon DocumentDB del que desea eliminar las etiquetas.

• --tag-keys: obligatorio. Una lista de las claves de etiqueta que desea quitar de este recurso.

Para Linux, macOS o Unix:

aws docdb remove-tags-from-resource \
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
    --tag-keys key1 key3

Para Windows:

aws docdb remove-tags-from-resource ^
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
    --tag-keys key1 key3

La operación removed-tags-from-resource no produce ningún resultado. Para ver los resultados de la operación, utilice la operación list-tags-for-resource.