# Agregación de una etiqueta a un bucket de tablas
<a name="table-bucket-tag-add"></a>



Puede agregar etiquetas a los buckets de tabla de Amazon S3 y modificar estas etiquetas. Para obtener más información sobre el etiquetado de buckets de tablas, consulte [Uso de etiquetas con buckets de tablas de S3](table-bucket-tagging.md).

## Permisos
<a name="table-bucket-tag-add-permissions"></a>

Para agregar una etiqueta a un bucket de tabla, debe contar con el siguiente permiso:
+ `s3tables:TagResource`

## Solución de errores
<a name="table-bucket-tag-add-troubleshooting"></a>

Si se produce un error al intentar agregar una etiqueta a un bucket de tabla, puede hacer lo siguiente: 
+ Compruebe que dispone de los [Permisos](#table-bucket-tag-add-permissions) necesarios para agregar una etiqueta a un bucket de tabla.
+ Si ha intentado agregar una clave de etiqueta que comience con el prefijo reservado de AWS `aws:`, cámbiela e inténtelo de nuevo. 
+ La clave de la etiqueta es necesaria. Además, asegúrese de que la clave de la etiqueta y el valor de la etiqueta no superen la longitud máxima de caracteres y no contengan caracteres restringidos. Para obtener más información, consulte [Etiquetado para la asignación de costos o el control de acceso basado en atributos (ABAC)](tagging.md).

## Steps
<a name="table-bucket-tag-add-steps"></a>

Puede agregar etiquetas a buckets de tabla mediante la consola de Amazon S3, la interfaz de la línea de comandos de AWS (CLI de AWS), la API de REST de Tablas de Amazon S3 y los AWS SDK.

## Uso de la consola de S3
<a name="table-bucket-tag-add-console"></a>

Para agregar etiquetas a un bucket de tablas con la consola de Amazon S3:

1. Inicie sesión en la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. En el panel de navegación izquierdo, elija **Buckets de tablas**.

1. Elija el nombre del bucket de tablas. 

1. Elija la pestaña **Propiedades**. 

1. Desplácese hasta la sección **Etiquetas** y elija **Agregar nueva etiqueta**. 

1. Esto abre la página **Agregar etiquetas**. Puede ingresar hasta 50 pares de clave valor de etiquetas. 

1. Si agrega una nueva etiqueta con el mismo nombre de clave que una etiqueta existente, el valor de la nueva etiqueta invalida el valor de la etiqueta existente.

1. Puede editar también los valores de las etiquetas existentes en esta página.

1. Una vez que haya agregado las etiquetas, elija **Guardar cambios**. 

## Uso de la API de REST
<a name="table-bucket-tag-add-api"></a>

Para obtener información sobre la compatibilidad con la API de REST de Amazon S3 para agregar etiquetas a un bucket de tablas, consulte la siguiente sección en la *Referencia de la API de Amazon Simple Storage Service*:
+ [TagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3Buckets_TagResource.html)

## Uso de AWS CLI
<a name="table-bucket-tag-add-cli"></a>

Para instalar la CLI de AWS, consulte [Instalación de la CLI de AWS](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) en la *Guía del usuario de AWS Command Line Interface*.

En el ejemplo de la CLI siguiente, se muestra cómo agregar etiquetas a un bucket de tabla mediante la AWS CLI. Para usar el comando, sustituya los *marcadores de posición de entrada del usuario* con su propia información.

**Solicitud:**

```
aws --region us-west-2 \
s3tables tag-resource \
--resource-arn arn:aws::s3tables:us-west-2:111122223333:bucket/amzn-s3-demo-table-bucket \
--tags '{"Department":"Engineering"}'
```