Eliminación de archivo (DELETE archivo) - Amazon S3 Glacier

Esta página es solo para los clientes actuales del servicio S3 Glacier que utilizan Vaults y la API de REST original de 2012.

Si busca soluciones de almacenamiento de archivos, se recomienda que utilice las clases de almacenamiento de S3 Glacier en Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval y S3 Glacier Deep Archive. Para obtener más información sobre estas opciones de almacenamiento, consulte Clases de almacenamiento de S3 Glacier y Almacenamiento de datos a largo plazo con clases de almacenamiento de S3 Glacier en la Guía del usuario de Amazon S3. Estas clases de almacenamiento utilizan la API de Amazon S3, están disponibles en todas las regiones y se pueden administrar en la consola de Amazon S3. Ofrecen funciones como el análisis de costes de almacenamiento, Lente de almacenamiento características avanzadas de cifrado opcionales y más.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Eliminación de archivo (DELETE archivo)

Descripción

Esta operación elimina un archivo de un almacén. Puede eliminar los archivos de uno en uno en un almacén. Para eliminar un archivo, debe proporcionar su ID en la solicitud de eliminación. Puede obtener el ID de archivo descargando el inventario correspondiente al almacén que contiene el archivo. Para obtener más información acerca de cómo descargar un inventario de almacén, consulte Descarga de un inventario de almacén en Amazon S3 Glacier.

Después de eliminar un archivo, podrá seguir realizando una solicitud correcta para iniciar un trabajo con el fin de recuperar el archivo eliminado, pero se producirá un error en el trabajo de recuperación de archivo.

Las recuperaciones de archivo que están en curso de un ID de archivo cuando se elimina el archivo podrían realizarse o no correctamente según los escenarios siguientes:

  • Si el trabajo de recuperación del archivo está preparando activamente los datos para su descarga cuando Amazon S3 Glacier (S3 Glacier) recibe la solicitud de eliminación del archivo, puede producirse un error en la operación de recuperación.

  • Si el trabajo de recuperación del archivo ya ha preparado correctamente el archivo para su descarga cuando S3 Glacier recibe la solicitud para eliminar el archivo, podrá descargar la salida.

Para obtener más información sobre la recuperación de archivos, consulte Descarga de un archivo en S3 Glacier.

Esta operación es idempotente. Si intenta eliminar un archivo que ya ha sido eliminado, no se producirá un error.

Solicitudes

Para eliminar un archivo, envíe una solicitud DELETE al URI del recurso del archivo.

Sintaxis

DELETE /AccountId/vaults/VaultName/archives/ArchiveID HTTP/1.1 Host: glacier.Region.amazonaws.com x-amz-Date: Date Authorization: SignatureValue x-amz-glacier-version: 2012-06-01

nota

El AccountId valor es el Cuenta de AWS identificador de la cuenta propietaria del almacén. Puede especificar un Cuenta de AWS ID o, si lo desea, un único - '' (guión), en cuyo caso Amazon S3 Glacier utilizará el Cuenta de AWS ID asociado a las credenciales utilizadas para firmar la solicitud. Si usa un ID de cuenta, no incluya ningún guion (“-”) en el ID.

Parámetros de la solicitud

Esta operación no usa parámetros de solicitud.

Encabezados de solicitud

Esta operación solo usa encabezados de solicitud que sean comunes para todas las operaciones. Para obtener información acerca de los encabezados de solicitudes comunes, consulte Encabezados de solicitudes comunes.

Cuerpo de la solicitud

Esta operación no tiene un cuerpo de la solicitud.

Respuestas

Sintaxis

HTTP/1.1 204 No Content x-amzn-RequestId: x-amzn-RequestId Date: Date

Encabezados de respuesta

Esta operación solo usa encabezados de respuesta que sean comunes a la mayoría de las respuestas. Para obtener información acerca de los encabezados de respuestas comunes, consulte Encabezados de respuesta comunes.

Cuerpo de respuesta

Esta operación no devuelve ningún cuerpo de respuesta.

Errores

Para obtener información acerca de los mensajes de error y las excepciones de Amazon S3 Glacier, consulte Respuestas de error.

Ejemplos

En el ejemplo siguiente, se muestra cómo se elimina un archivo de un almacén llamado examplevault.

Solicitud de ejemplo

El ID del archivo que se va a eliminar se especifica como un subrecurso de archives.

DELETE /-/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

Respuesta de ejemplo

Si la solicitud se realiza correctamente, S3 Glacier envía 204 No Content como respuesta para indicar que el archivo se ha eliminado.

HTTP/1.1 204 No Content x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT