Eliminación de la política de acceso del almacén (DELETE política-acceso)

Descripción

Esta operación elimina la política de acceso asociada al almacén especificado. La operación tiene coherencia final; es decir, Amazon S3 Glacier (S3 Glacier) puede tardar un tiempo en quitar por completo la política de acceso, por lo que los efectos de esta política podrían verse durante un breve periodo de tiempo después de que envíe la solicitud de eliminación.

Esta operación es idempotente. La eliminación se puede invocar varias veces, incluso aunque no haya ninguna política asociada al almacén. Para obtener más información sobre las políticas de acceso a almacenes, consulte Políticas de acceso a almacenes.

Solicitudes

Para eliminar la política de acceso a almacenes actual, envíe una solicitud HTTP DELETE al URI del subrecurso access-policy del almacén.

Sintaxis

DELETE /AccountId/vaults/vaultName/access-policy 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

En respuesta, S3 Glacier devuelve 204 No Content si la política se elimina correctamente.

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 una política de acceso a almacenes.

Solicitud de ejemplo

En este ejemplo, se envía una solicitud DELETE al subrecurso access-policy del almacén denominado examplevault.

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

Respuesta de ejemplo

En respuesta, si la política se elimina correctamente, S3 Glacier devuelve 204 No Content, tal y como se muestra en el siguiente ejemplo.

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

Secciones relacionadas

• Obtención de la política de acceso del almacén (GET política-acceso)

• Configuración de la política de acceso al almacén (PUT access-policy)

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