Política de acesso de exclusão do cofre (DELETE access-policy)

Descrição

Essa operação exclui a política de acesso associada ao cofre especificado. A operação acaba sendo consistente, ou seja, pode levar algum tempo até o Amazon S3 Glacier (S3 Glacier) remover completamente a política de acesso, e você ainda poderá ver o efeito da política por um curto período depois de enviar a solicitação de exclusão.

Essa operação é idempotente. Você poderá invocar a exclusão várias vezes, mesmo se não houver política associada ao cofre. Para obter mais informações sobre políticas de acesso ao cofre, consulte Políticas de acesso ao cofre.

Solicitações

Para excluir a política de acesso ao cofre atual, envie uma solicitação DELETE HTTP para o URI do sub-recurso access-policy do cofre.

Sintaxe

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

O valor de AccountId é o ID de Conta da AWS da conta proprietária do cofre. Você pode especificar um ID de Conta da AWS ou, de forma opcional, um '-' (hífen) único; nesse caso, o Amazon S3 Glacier usa o ID de Conta da AWS associado às credenciais usadas para assinar a solicitação. Se você usar um ID de conta, não inclua nenhum hífen ('-') no ID.

Parâmetros de solicitação

Essa operação não usa parâmetros de solicitação.

Cabeçalhos de solicitação

Essa operação usa somente os cabeçalhos de solicitação que são comuns a todas as operações. Para informações sobre os cabeçalhos de solicitação comuns, consulte Cabeçalhos de solicitação comuns.

Corpo da solicitação

Essa operação não tem um corpo de solicitação.

Respostas

Em resposta, o S3 Glacier retornará 204 No Content, se a política for excluída com êxito.

Sintaxe

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

Cabeçalhos de resposta

Essa operação usa somente os cabeçalhos de resposta que são comuns a maioria das respostas. Para informações sobre os cabeçalhos de resposta comuns, consulte Cabeçalhos de resposta comuns.

Corpo da resposta

Essa operação não retorna um corpo de resposta.

Erros

Para obter informações sobre exceções e mensagens de erro do Amazon S3 Glacier, consulte Respostas de erro.

Exemplos

O exemplo a seguir demonstra como excluir uma política de acesso ao cofre.

Exemplo de solicitação

Neste exemplo, uma solicitação DELETE é enviada para o sub-recurso access-policy do cofre chamado 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

Exemplo de resposta

Em resposta, se a política for excluída com êxito, o S3 Glacier retornará um 204 No Content conforme mostrado no exemplo a seguir.

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

Seções relacionadas

• Get Vault Access Policy (GET access-policy)

• Set Vault Access Policy (PUT access-policy)

Consulte também

Para obter mais informações sobre como usar essa API em um dos Amazon SDKs específicos de linguagem, consulte o seguinte:

• AWS Command Line Interface