# Cómo agregar etiquetas a los recursos en DynamoDB
Puede asignar *etiquetas* a los recursos de Amazon DynamoDB. Las etiquetas le permiten categorizar los recursos de distintas maneras; por ejemplo, según su finalidad, propietario, entorno u otro criterio. Las etiquetas pueden ayudar a hacer lo siguiente:
+ Identificar rápidamente un recurso según las etiquetas que le haya asignado.
+ Consultar las facturas de AWS desglosadas por etiquetas.
**nota**
A los índices secundarios locales (LSI) y los índices secundarios globales (GSI) relacionados con las tablas etiquetadas se les asignan automáticamente las mismas etiquetas. En la actualidad, no se puede etiquetar el uso de DynamoDB Streams.
El etiquetado es compatible con servicios de AWS como Amazon EC2, Amazon S3, DynamoDB, entre otros. Un etiquetado eficiente puede ofrecerle información detallada sobre los costos, ya que le permite crear informes sobre los servicios que llevan una etiqueta determinada.
Para empezar a usar etiquetas, haga lo siguiente:
1. Comprender [Restricciones de etiquetado en DynamoDB](#TaggingRestrictions).
1. Crear etiquetas mediante [Recursos de etiquetado en DynamoDB](Tagging.Operations.md).
1. Usar [Uso de etiquetas de DynamoDB para crear informes de asignación de costos](#CostAllocationReports) para realizar el seguimiento de los costes de AWS según su etiqueta activa.
Por último, es conveniente seguir estrategias de etiquetado óptimas. Para obtener más información, consulte [Estrategias de etiquetado de AWS](https://d0.awsstatic.com/aws-answers/AWS_Tagging_Strategies.pdf).
## Restricciones de etiquetado en DynamoDB
Cada etiqueta consta de una clave y un valor, ambos definidos por el usuario. Se aplican las siguientes restricciones:
+ Cada tabla puede de DynamoDB solo puede tener una etiqueta con la misma clave. Si intenta agregar una etiqueta existente (con la misma clave), el valor de la etiqueta existente se actualiza con el valor nuevo.
+ Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas.
+ La longitud máxima de la clave es de 128 caracteres Unicode.
+ La longitud máxima del valor es de 256 caracteres Unicode.
+ Los caracteres permitidos son letras, espacios en blanco y números, además de los caracteres especiales siguientes: `+ - = . _ : /`
+ El número máximo de etiquetas por recurso es 50.
+ El tamaño máximo admitido para todas las etiquetas de una tabla es de 10 KB.
+ A los nombres y valores de etiquetas asignados por AWS se les asigna automáticamente el prefijo `aws:`, que no puede asignar. Los nombres de etiquetas asignados por AWS no cuentan para el límite de etiquetas de 50 o el límite de tamaño máximo de 10 KB. Los nombres de etiquetas asignados por el usuario presentan el prefijo `user:` en el informe de asignación de costos.
+ No es posible antedatar la aplicación de una etiqueta.
# Recursos de etiquetado en DynamoDB
Puede usar la consola de Amazon DynamoDB o la AWS Command Line Interface (AWS CLI) para añadir, enumerar, editar o eliminar etiquetas. A continuación, puede activar estas etiquetas definidas por el usuario de modo que aparezcan en la consola de Administración de facturación y costos de AWS y así poder usarlas para el seguimiento de asignación de costos. Para obtener más información, consulte [Uso de etiquetas de DynamoDB para crear informes de asignación de costos](Tagging.md#CostAllocationReports).
Para la edición en bloque, también puede usar Tag Editor en la Consola de administración de AWS. Para obtener más información, consulte [Uso de Tag Editor](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/tag-editor.html).
Para usar la API de DynamoDB en su lugar, consulte las siguientes operaciones en la [Referencia de la API de Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/):
+ [TagResource](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TagResource.html)
+ [UntagResource](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UntagResource.html)
+ [ListTagsOfResource](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ListTagsOfResource.html)
**Topics**
+ [Establecer permisos para filtrar por etiquetas](#Tagging.Operations.permissions)
+ [Añadir etiquetas a tablas nuevas o existentes (Consola de administración de AWS)](#Tagging.Operations.using-console)
+ [Añadir etiquetas a tablas nuevas o existentes (AWS CLI)](#Tagging.Operations.using-cli)
## Establecer permisos para filtrar por etiquetas
Para utilizar etiquetas a fin de filtrar la lista de tablas en la consola de DynamoDB, asegúrese de que las políticas del usuario incluyan acceso a las siguientes operaciones:
+ `tag:GetTagKeys`
+ `tag:GetTagValues`
Puede acceder a estas operaciones adjuntando una nueva política de IAM a su usuario siguiendo los pasos que se indican a continuación.
1. Ingrese a la [Consola de IAM](https://console.aws.amazon.com/iam/) con un usuario administrador.
1. Seleccione “Policies” (Políticas) en el menú de navegación izquierdo.
1. Seleccione “Create Policy” (Crear política).
1. Pegue la siguiente política en el editor JSON.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"tag:GetTagKeys",
"tag:GetTagValues"
],
"Resource": "*"
}
]
}
```
------
1. Complete el asistente y asigne un nombre a la política (por ejemplo, `TagKeysAndValuesReadAccess`).
1. Seleccione “Users” (Usuarios) en el menú de navegación izquierdo.
1. En la lista, seleccione el usuario que utiliza habitualmente para acceder a la consola de DynamoDB.
1. Seleccione “Add permissions” (Añadir permisos).
1. Seleccione “Attach existing policies directly” (Asociar directamente las políticas existentes).
1. En la lista, seleccione la política que ha creado previamente.
1. Complete el asistente.
## Añadir etiquetas a tablas nuevas o existentes (Consola de administración de AWS)
Puede usar la consola de DynamoDB para añadir etiquetas a tablas nuevas cuando las cree, o para añadir, editar o eliminar etiquetas de tablas existentes.
**Para etiquetar recursos al crearlos (consola)**
1. Inicie sesión en la Consola de administración de AWS y abra la consola de DynamoDB en [https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/).
1. En el panel de navegación, elija **Tablas** y, a continuación, seleccione **Crear tabla**.
1. En la página **Create DynamoDB table (Crear tabla de DynamoDB)**, proporcione un nombre y una clave principal. En la sección **Tags** (Etiquetas), elija **Add new tag** (Agregar nueva etiqueta) e ingrese las etiquetas que desee utilizar.
Para obtener más información sobre la estructura de las etiquetas, consulte [Restricciones de etiquetado en DynamoDB](Tagging.md#TaggingRestrictions).
Para obtener más información sobre cómo crear tablas, consulte [Operaciones básicas en tablas de DynamoDB](WorkingWithTables.Basics.md).
**Para etiquetar recursos existentes (consola)**
Abra la consola de DynamoDB en [https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/).
1. En el panel de navegación, elija **Tablas**.
1. Elija una tabla de la lista y, a continuación, elija la pestaña **Additional settings** (Configuración adicional). Puede agregar, editar o eliminar las etiquetas en la sección **Tags** (Etiquetas) en la parte inferior de la página.
## Añadir etiquetas a tablas nuevas o existentes (AWS CLI)
En los ejemplos siguientes se muestra cómo usar la AWS CLI para especificar etiquetas al crear tablas e índices, así como para etiquetar recursos existentes.
**Para etiquetar recursos al crearlos (AWS CLI)**
+ En el ejemplo siguiente se crea una nueva tabla de `Movies` y se añade la etiqueta `Owner` con un valor de `blueTeam`:
```
aws dynamodb create-table \
--table-name Movies \
--attribute-definitions AttributeName=Title,AttributeType=S \
--key-schema AttributeName=Title,KeyType=HASH \
--provisioned-throughput ReadCapacityUnits=5,WriteCapacityUnits=5 \
--tags Key=Owner,Value=blueTeam
```
**Para etiquetar recursos existentes (AWS CLI)**
+ En el ejemplo siguiente se añade la etiqueta `Owner` con un valor de `blueTeam` para la tabla `Movies`:
```
aws dynamodb tag-resource \
--resource-arn arn:aws:dynamodb:us-east-1:123456789012:table/Movies \
--tags Key=Owner,Value=blueTeam
```
**Para enumerar todas las etiquetas de una tabla (AWS CLI)**
+ En el ejemplo siguiente se muestran todas las etiquetas asociadas con la tabla `Movies`:
```
aws dynamodb list-tags-of-resource \
--resource-arn arn:aws:dynamodb:us-east-1:123456789012:table/Movies
```
## Uso de etiquetas de DynamoDB para crear informes de asignación de costos
AWS utiliza etiquetas para organizar los costos de los recursos en el informe de asignación de costos. AWS proporciona dos tipos de etiquetas de asignación de costos:
+ Una etiqueta generada por AWS. AWS define, crea y aplica esta etiqueta por usted.
+ Etiquetas definidas por el usuario. Puede definir, crear y aplicar estas etiquetas.
Debe activar ambos tipos de etiquetas por separado para que puedan aparecer en el Explorador de costos o en un informe de asignación de costos.
Para activar las etiquetas generadas por AWS:
1. Inicie sesión en la Consola de administración de AWS abra la consola de Billing and Cost Management en [https://console.aws.amazon.com/billing/home\$1/](https://console.aws.amazon.com/billing/home#/.).
1. En el panel de navegación, seleccione **Etiquetas de asignación de costos**.
1. En **Etiquetas de asignación de costos generada por AWS**, elija **Activar**.
Para activar las etiquetas definidas por el usuario:
1. Inicie sesión en la Consola de administración de AWS abra la consola de Billing and Cost Management en [https://console.aws.amazon.com/billing/home\$1/](https://console.aws.amazon.com/billing/home#/.).
1. En el panel de navegación, seleccione **Etiquetas de asignación de costos**.
1. En **Etiquetas de asignación de costos definidas por el usuario**, elija **Activar**.
Después de crear y activar las etiquetas, AWS genera un informe de asignación de costos con el uso y los costos agrupados según las etiquetas activas. El informe de asignación de costes incluye todos los costes de AWS para cada periodo de facturación. El informe incluye tanto recursos etiquetados como sin etiquetar, para que pueda organizar con claridad los cargos de los recursos.
**nota**
En la actualidad, los datos transferidos desde DynamoDB no se desglosan según las etiquetas en los informes de asignación de costos.
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).