Eliminación de almacén (DELETE almacén)

Descripción

Esta operación elimina un almacén. Amazon S3 Glacier (S3 Glacier) solamente eliminará un almacén si, según el último inventario, no hay ningún archivo y no se han escrito datos en el almacén desde el último inventario. Si no se cumple alguna de estas condiciones, la eliminación del almacén no se realiza correctamente (es decir, el almacén no se elimina) y S3 Glacier devuelve un error.

Puede utilizar la operación Descripción del almacén (GET almacén) que proporciona información sobre el almacén, incluido el número de archivos que contiene; sin embargo, esta información se basa en el último inventario de almacén que S3 Glacier ha generado.

Esta operación es idempotente.

nota

Cuando se elimina un almacén, la política de acceso a almacenes asociada al almacén también se elimina. Para obtener más información sobre las políticas de acceso a almacenes, consulte Políticas de acceso a almacenes.

Solicitudes

Para eliminar un almacén, envíe una solicitud DELETE al URI del recurso del almacén.

Sintaxis

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

nota

El valor AccountId es el ID de la Cuenta de AWS propietaria del almacén. Puede especificar un ID de Cuenta de AWS o, si lo desea, un solo carácter “-” (guion), en cuyo caso, Amazon S3 Glacier usa el ID de la Cuenta de AWS asociada con las credenciales empleadas para firmar la solicitud. Si usa un ID de cuenta, no incluya ningún guion (“-”) en el ID.

Parámetros de 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

Solicitud de ejemplo

En el siguiente ejemplo, se elimina un almacén llamado examplevault. La solicitud del ejemplo es una solicitud DELETE dirigida al URI del recurso (el almacén) que se va a eliminar.

DELETE /-/vaults/examplevault 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

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

Secciones relacionadas

• Creación de un almacén (almacén PUT)

• Enumeración de almacenes (GET almacenes)

• Inicialización de trabajos (POST trabajos)

• Administración de identidades y accesos para Amazon S3 Glacier

Véase también

Para obtener más información sobre el uso de esta API en uno de los SDK de Amazon específicos de idioma, consulte lo siguiente:

• AWS Command Line Interface