# Etiquetado de recursos de archivos de S3
<a name="s3-files-tagging"></a>

Para ayudarlo a administrar los recursos de archivos de S3, puede asignar sus propios metadatos a cada recurso en forma de etiquetas. Con las etiquetas, puede clasificar los recursos de AWS de diversas maneras, por ejemplo, según su finalidad, propietario o entorno. Esta categorización resulta útil cuando se tienen muchos recursos del mismo tipo, ya que puede identificar rápidamente un recurso específico en función de las etiquetas que se le hayan asignado. Puede etiquetar recursos de punto de acceso y de sistemas de archivos de S3 que ya existan en la cuenta. En este tema se describe qué son las etiquetas y cómo crearlas.

## Restricciones de las etiquetas
<a name="s3-files-tagging-restrictions"></a>

Se aplican las siguientes restricciones básicas a las etiquetas:
+ Número máximo de etiquetas por recurso: 50
+ Para cada recurso, cada clave de etiqueta debe ser única y solo puede tener un valor.
+ Longitud máxima de la clave: 128 caracteres Unicode en UTF-8
+ Longitud máxima del valor: 256 caracteres Unicode en UTF-8
+ Los caracteres permitidos son: letras, números y espacios representables en UTF-8, además de los siguientes caracteres: `+ - = . _ : / @`.
+ Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas.
+ El prefijo `aws:` se reserva para uso de AWS. Si la etiqueta tiene una clave de etiqueta con este prefijo, no puede editar ni eliminar la clave o el valor de la etiqueta. Las etiquetas que tengan el prefijo `aws:` no cuentan para el límite de etiquetas por recurso.

No puede actualizar ni eliminar un recurso basándose únicamente en sus etiquetas; debe especificar el identificador del recurso. Por ejemplo, para eliminar sistemas de archivos que se etiquetaron con una clave de etiqueta llamada `DeleteMe`, debe utilizar la acción `DeleteFileSystem` con los identificadores de recursos del sistema de archivos, como el ID del sistema de archivos.

Cuando etiqueta recursos públicos o compartidos, las etiquetas que asigne solo están disponibles para la cuenta de AWS. Ninguna otra cuenta de AWS tendrá acceso a esas etiquetas. Para el control de acceso a recursos compartidos basado en etiquetas, cada cuenta de AWS debe asignar su propio conjunto de etiquetas para controlar el acceso al recurso.

## Uso de la consola de S3
<a name="s3-files-tagging-console"></a>

Puede usar la consola de archivos de S3 para administrar etiquetas en los recursos.
+ Abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3](https://console.aws.amazon.com/s3/).
+ En la barra de navegación de la parte superior de la página, compruebe que se encuentra en la región de AWS deseada.
+ En el panel de navegación, elija **Sistemas de archivos**.
+ Puede especificar etiquetas para un recurso al crear dicho recurso, como un sistema de archivos de S3 o un punto de acceso. O bien, puede agregar, modificar o eliminar etiquetas después de crearlas accediendo a las propiedades del recurso.

## Uso de AWS CLI
<a name="s3-files-tagging-cli"></a>

Si utiliza la API de archivos de S3, la AWS CLI o un AWS SDK, puede usar la acción de la API de archivos de S3 `TagResource` para aplicar etiquetas a los recursos existentes. Además, algunas acciones de creación de recursos permiten especificar etiquetas para un recurso al crear dicho recurso, como cuando crea un sistema de archivos.

Los comandos de la AWS CLI para administrar etiquetas y las acciones de la API de archivos de S3 equivalentes se indican en la siguiente tabla.


| Command de la CLI | Descripción | Operación de la API equivalente | 
| --- | --- | --- | 
| tag-resource | Añadir nuevas etiquetas o actualizar etiquetas existentes | TagResource | 
| list-tags-for-resource | Recuperar etiquetas existentes | ListTagsForResource | 
| untag-resource | Eliminar etiquetas existentes | UntagResource |