Cómo evitar que un objeto se sobrescriba con escrituras condicionales

Mediante las escrituras condicionales, puede agregar un encabezado adicional a las solicitudes WRITE para especificar condiciones previas a la operación de Amazon S3. Para escribir objetos de forma condicional, agregue el encabezado HTTP If-None-Match o If-Match.

El encabezado If-None-Match evita sobrescribir datos existentes al validar que no haya un objeto con el mismo nombre de clave ya en el bucket.

De forma alternativa, puede agregar el encabezado If-Match para verificar la etiqueta de entidad (ETag) de un objeto antes de escribirlo. Con este encabezado, Amazon S3 compara el valor de ETag proporcionado con el valor de ETag del objeto en S3. Si los valores de ETag no coinciden, se produce un error en la operación.

Los propietarios de buckets pueden utilizar políticas de bucket para aplicar escrituras condicionales a los objetos cargados. Para obtener más información, consulte Aplicación de escrituras condicionales en buckets de Amazon S3.

Cómo evitar sobrescrituras de objetos basadas en nombres de clave

Puede utilizar el encabezado condicional HTTP If-None-Match para comprobar si un objeto ya existe en el bucket especificado en función del nombre de clave antes de crearlo. Cuando cargue un objeto en Amazon S3, especifique el nombre de clave: un identificador único que distinga entre mayúsculas y minúsculas de un objeto en un bucket. Sin el encabezado HTTP If-None-Match, si carga un objeto con un nombre de clave idéntico en un bucket sin versión o con versiones suspendidas, el objeto se sobrescribe. En un bucket con versiones, el objeto cargado más recientemente se convierte en la versión actual del objeto. Las escrituras condicionales con el encabezado HTTP If-None-Match comprobarán la existencia de un objeto durante la operación WRITE. Si se encuentra un nombre de clave idéntico en el bucket, la operación producirá un error. Para obtener más información sobre el uso de nombres de clave, consulte Denominación de objetos de Amazon S3.

Para realizar escrituras condicionales con el encabezado HTTP If-None-Match, debe tener el permiso s3:PutObject. Esto permite a la persona que llama comprobar la presencia de objetos en el bucket. El encabezado If-None-Match espera el valor * (asterisco).

Puede utilizar el encabezado If-None-Match con las siguientes API:

aws s3api put-object --bucket amzn-s3-demo-bucket --key dir-1/my_images.tar.bz2 --body my_images.tar.bz2 --if-none-match "*"       

Cómo evitar sobrescrituras si el objeto ha cambiado

La ETag de un objeto es una cadena que es única para el objeto y refleja un cambio en el contenido del objeto. Puede utilizar el encabezado If-Match para comparar el valor de ETag de un objeto en un bucket de Amazon S3 con uno que proporcione durante la operación WRITE. Si los valores de ETag no coinciden, se produce un error en la operación. Para obtener más información sobre las ETag, consulte Uso de Content-MD5 y ETag para verificar los objetos cargados.

Para realizar escrituras condicionales con un encabezado HTTP If-Match, debe tener los permisos s3:PutObject y s3:GetObject. Esto permite al intermediario comprobar la ETag y verificar el estado de los objetos en el bucket. El encabezado If-Match espera el valor de la ETag en forma de cadena.

Puede utilizar el encabezado If-Match con las siguientes API:

aws s3api put-object --bucket amzn-s3-demo-bucket --key dir-1/my_images.tar.bz2 --body my_images.tar.bz2 --if-match "6805f2cfc46c0f04559748bb039d69ae"       

Comportamiento de escritura condicional

Escenarios de escritura condicional

Tenga en cuenta los siguientes escenarios en los que dos clientes ejecutan operaciones en el mismo bucket.

Escrituras condicionales durante las cargas multiparte

Las escrituras condicionales no consideran ninguna solicitud de cargas multiparte en curso, ya que aún no se trata de objetos completamente escritos. Considere el siguiente ejemplo en el que el cliente 1 carga un objeto mediante la carga multiparte. Durante la carga multiparte, el cliente 2 puede escribir correctamente el mismo objeto con la operación de escritura condicional. Posteriormente, cuando el cliente 1 intenta completar la carga multiparte mediante una escritura condicional, la carga produce un error.

Eliminaciones simultáneas durante las cargas multiparte

Si una solicitud de eliminación se realiza correctamente antes de que se complete una solicitud de escritura condicional, Amazon S3 devuelve una respuesta 409 Conflict o 404 Not Found para la operación de escritura. Esto se debe a que la solicitud de eliminación que se inició antes tiene prioridad sobre la operación de escritura condicional. En esos casos, debe iniciar una nueva carga multiparte.