

# Edición de metadatos de objeto en la consola de Amazon S3
<a name="add-object-metadata"></a>

Puede utilizar la consola de Amazon S3 para editar metadatos de objetos de S3 existentes mediante la acción **Copiar**. Para editar los metadatos, se copian los objetos en el mismo destino y se especifican los nuevos metadatos que se deseen aplicar, que sustituirán a los metadatos anteriores del objeto. Algunos metadatos son configurados por Amazon S3 cuando carga el objeto. Por ejemplo, `Content-Length` y `Last-Modified` son campos de metadatos de objetos definidos por el sistema que un usuario no puede modificar.

También puede configurar los metadatos definidos por el usuario cuando cargue el objeto y sustituirlo a medida que cambien las necesidades. Por ejemplo, es posible que tenga un conjunto de objetos que almacene inicialmente en la clase de almacenamiento `STANDARD`. Con el tiempo, puede que ya no necesite que estos datos estén altamente disponibles. Por lo tanto, puede cambiar la clase de almacenamiento a `GLACIER` mediante la sustitución del valor de la clave `x-amz-storage-class` de `STANDARD` a `GLACIER`.

**nota**  
Tenga en cuenta lo siguiente cuando sustituya metadatos de objeto en Amazon S3:  
Debe especificar los metadatos existentes que desee retener, los metadatos que desee agregar y los metadatos que desee editar.
Si el objeto ocupa menos de 5 GB, puede utilizar la acción **Copiar** en la consola de S3 para sustituir los metadatos del objeto. Si el objeto ocupa más de 5 GB, puede sustituir los metadatos del objeto al copiar un objeto con una carga multiparte mediante la [AWS CLI](mpu-upload-object.md#UsingCLImpUpload) o los [AWS SDK](CopyingObjectsMPUapi.md). Para obtener más información, consulte [Copiar un objeto con la carga multiparte](CopyingObjectsMPUapi.md).
Para obtener una lista de los permisos adicionales necesarios para sustituir los metadatos, consulte [Permisos necesarios para las operaciones de la API de Amazon S3](using-with-s3-policy-actions.md). Para ver políticas de ejemplo que conceden estos permisos, consulte [Ejemplos de políticas basadas en identidad para Amazon S3](example-policies-s3.md).
Esta acción crea una *copia* del objeto con la configuración actualizada y la fecha de última modificación. Si el control de versiones de S3 está activado, se crea una nueva versión del objeto y el objeto existente se convierte en una versión anterior. Si el control de versiones de S3 no está habilitado, una nueva copia del objeto reemplaza al objeto original. La Cuenta de AWS con el rol de IAM que cambia la propiedad también se convierte en la propietaria del nuevo objeto o (versión del objeto).
La edición de metadatos sustituye los valores de los nombres de clave existentes.
Los objetos cifrados con claves de cifrado proporcionadas por el cliente (SSE-C) no se pueden copiar con la consola. Debe utilizar la AWS CLI, el SDK de AWS o la API de REST de Amazon S3.
Al copiar un objeto utilizando la consola de Amazon S3, puede recibir el mensaje de error “Copied metadata can't be verified”. La consola utiliza encabezados para recuperar y establecer metadatos para el objeto. Si la configuración de la red o del navegador modifica las solicitudes de red, este comportamiento podría hacer que se escriban metadatos no deseados (como encabezados `Cache-Control` modificados) en el objeto copiado. Amazon S3 no puede verificar estos metadatos no deseados.  
Para solucionar este problema, compruebe la configuración de la red y del navegador para asegurarse de que no modifica encabezados, como `Cache-Control`. Para obtener más información, consulte [Modelo de responsabilidad compartida](https://docs.aws.amazon.com/whitepapers/latest/applying-security-practices-to-network-workload-for-csps/the-shared-responsibility-model.html).

**aviso**  
Al sustituir metadatos para carpetas, espere a que finalice la acción **Copiar** antes de agregar nuevos objetos a la carpeta. De lo contrario, también se podrían editar objetos nuevos.

En los temas siguientes se describe cómo sustituir metadatos de un objeto mediante la acción **Copiar** en la consola de Amazon S3.

## Sustitución de metadatos definidos por el sistema
<a name="add-object-metadata-system"></a>

Puede sustituir algunos metadatos definidos por el sistema para un objeto de S3. Para obtener una lista de metadatos definidos por el sistema y valores que puede modificar, consulte [Metadatos de objetos definidos por el sistema](UsingMetadata.md#SysMetadata).

**Sustitución de metadatos definidos por el sistema de un objeto**

1. Inicie sesión en la Consola de administración de AWS y abra 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 uso general** o **Buckets de directorio**.

1. En la lista de buckets, elija el nombre del bucket que contiene los objetos que desea cambiar.

1. Seleccione la casilla de verificación de los objetos que desea cambiar.

1. En el menú **Actions (Acciones)**, elija **Copy (Copiar)** en la lista de opciones que aparece.

1. Para especificar la ruta de destino, elija **Examinar S3**, desplácese hasta el mismo destino que los objetos de origen y seleccione la casilla de verificación de destino. Seleccione **Elegir destino** en la esquina inferior derecha. 

   También puede escribir la ruta de destino. 

1. Si *no* tiene habilitado el control de versiones de bucket, verá una advertencia en la que se le recomendará que lo habilite para evitar que se sobrescriban o eliminen objetos de forma no intencionada. Si quiere mantener todas las versiones de los objetos en este bucket, seleccione **Enable Bucket Versioning** (Habilitar control de versiones de bucket). También puede consultar las propiedades predeterminadas de cifrado y de bloqueo de objetos en **Detalles de destino**.

1. En **Configuración de copia adicional**, elija **Especificar configuración** para especificar la configuración de los **Metadatos**.

1. Desplácese hasta la sección **Metadatos** y, a continuación, elija **Sustituir todos los metadatos**.

1. Elija **Agregar metadatos**.

1. Para el metadato **Tipo**, seleccione **Definidos por el sistema**.

1. Especifique una **Clave** única y el metadato **Valor**.

1. Para editar metadatos adicionales, elija **Agregar metadatos**. También puede elegir **Eliminar** para eliminar un conjunto de valores de clave de tipo.

1. Elija **Copiar**. Amazon S3 guarda los cambios en los metadatos.

## Sustitución de los metadatos definidos por el usuario
<a name="add-object-metadata-user-defined"></a>

Puede sustituir metadatos definidos por el usuario de un objeto mediante la combinación del prefijo de metadatos, `x-amz-meta-` y un nombre que elija para crear una clave personalizada. Por ejemplo, si añade el nombre personalizado `alt-name`, la clave de los metadatos será `x-amz-meta-alt-name`. 

Los metadatos definidos por el usuario pueden tener un tamaño total de hasta 2 KB. Para calcular el tamaño total de los metadatos definidos por el usuario, sume el número de bytes en la codificación UTF-8 para cada clave y valor. Tanto las claves como sus valores deben cumplir los estándares del American Standard Code for Information Interchange (ASCII, Código Estándar Estadounidense para el Intercambio de Información) de los EE. UU. Para obtener más información, consulte [Metadatos de objetos definidos por el usuario](UsingMetadata.md#UserMetadata).

**Sustitución de metadatos definidos por el usuario de un objeto**

1. Inicie sesión en la Consola de administración de AWS y abra 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, elija **Buckets** y, a continuación, elija la pestaña **Buckets de uso general** o **Buckets de directorio**. Desplácese hasta el bucket o la carpeta de Amazon S3 que contiene los objetos que desea cambiar.

1. Seleccione la casilla de verificación de los objetos que desea cambiar.

1. En el menú **Actions (Acciones)**, elija **Copy (Copiar)** en la lista de opciones que aparece.

1. Para especificar la ruta de destino, elija **Examinar S3**, desplácese hasta el mismo destino que los objetos de origen y seleccione la casilla de verificación de destino. Elija **Choose destination (Elegir destino)**. 

   También puede escribir la ruta de destino. 

1. Si *no* tiene habilitado el control de versiones de bucket, verá una advertencia en la que se le recomendará que lo habilite para evitar que se sobrescriban o eliminen objetos de forma no intencionada. Si quiere mantener todas las versiones de los objetos en este bucket, seleccione **Enable Bucket Versioning** (Habilitar control de versiones de bucket). También puede consultar las propiedades predeterminadas de cifrado y de bloqueo de objetos en **Detalles de destino**.

1. En **Configuración de copia adicional**, elija **Especificar configuración** para especificar la configuración de los **Metadatos**.

1. Desplácese hasta la sección **Metadatos** y, a continuación, elija **Sustituir todos los metadatos**.

1. Elija **Agregar metadatos**.

1. Para el metadato **Type (Tipo)**, elija **User-defined (Definidos por el usuario)**.

1. Escriba una **Key (Clave)** única y personalizada después de `x-amz-meta-`. Introduzca también un metadato **Value (Valor)**.

1. Para agregar metadatos adicionales, elija **Agregar metadatos**. También puede elegir **Eliminar** para eliminar un conjunto de valores de clave de tipo. 

1. Elija **Copiar**. Amazon S3 guarda los cambios en los metadatos.