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 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:
+ Clústeres
+ instancias
+ Instantáneas
+ Instantáneas del clúster
+ Grupos de parámetros
+ Grupos de parámetros de clústeres
+ Grupos de seguridad
+ Grupos de subredes
## 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](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) 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 Consola de administración de AWS 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 los nombres de recursos de Amazon DocumentDB () ARNs](documentdb-arns.md).
## Restricciones de las etiquetas
Se aplican las siguientes restricciones de Amazon DocumentDB a las etiquetas:
+ Cantidad máxima de etiquetas por recurso: 10
+ Longitud máxima de la **clave**: 128 caracteres Unicode
+ Longitud máxima del **valor**: 256 caracteres Unicode
+ Caracteres válidos para la **clave** y **valor**: letras mayúsculas y minúsculas del juego de caracteres UTF-8, números, espacios y los siguientes caracteres: `_ . : / = + -` y `@` (expresión regular de Java: `"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$"`)
+ Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas.
+ El prefijo `aws:` no se puede usar para las claves o valores de una etiqueta; está reservado para AWS.
## Agregación y actualización de etiquetas en un recurso de Amazon DocumentDB
Puede agregar hasta 10 etiquetas a un recurso mediante la Consola de administración de AWS o la AWS CLI.
------
#### [ Using the Consola de administración de AWS ]
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 Consola de administración de AWS y abra la consola de Amazon DocumentDB en [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. En el panel de navegación, seleccione **clusters (clústeres)**.
1. Seleccione el nombre del clúster al que desea añadir etiquetas.
1. Desplácese hacia abajo hasta la sección **Tags (Etiquetas)** y, a continuación, elija **Edit (Editar)**.
1. 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)**.
1. Para asignar a la etiqueta un valor nuevo o actualizado, escriba un valor para la etiqueta en el cuadro **Value (Valor)**.
1. 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 AWS CLI de la `add-tags-to-resource` 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`
**Example**
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 Consola de administración de AWS o la AWS CLI para obtener una lista de las etiquetas de un recurso de Amazon DocumentDB.
------
#### [ Using the Consola de administración de AWS ]
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](https://console.aws.amazon.com/docdb).
1. En el panel de navegación, seleccione **clusters (clústeres)**.
1. Seleccione el nombre del clúster para el que desea mostrar las etiquetas.
1. 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 AWS CLI de la `list-tags-for-resource` con estos parámetros.
**Parámetros**
+ **--resource-name**: obligatorio. El ARN del recurso Amazon DocumentDB del que desea ver las etiquetas.
**Example**
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 Consola de administración de AWS o la AWS CLI para eliminar etiquetas de recursos de Amazon DocumentDB.
------
#### [ Using the Consola de administración de AWS ]
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](https://console.aws.amazon.com/docdb).
1. En el panel de navegación, seleccione **clusters (clústeres)**.
1. Seleccione el nombre del clúster cuyas etiquetas desea eliminar.
1. Desplácese hacia abajo hasta la sección **Tags (Etiquetas)** y, a continuación, elija **Edit (Editar)**.
1. 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)**.
1. Elija **Remove (Eliminar)** en la misma fila que la clave de etiqueta.
1. 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 AWS CLI de la `remove-tags-from-resource` 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.
**Example**
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`.
------