DeleteObjects
Esta operação permite excluir vários objetos de um bucket usando uma única solicitação HTTP. Se você conhece as chaves do objeto que deseja excluir, esta operação fornece uma alternativa adequada ao envio de solicitações de exclusão individuais, reduzindo a sobrecarga por solicitação.
Request Syntax
POST /?delete HTTP/1.1 Host: bucket-name.bigfile.brascloud.com.br:443 x-amz-mfa: MFA x-amz-request-payer: RequestPayer x-amz-bypass-governance-retention: BypassGovernanceRetention <?xml version="1.0" encoding="UTF-8"?> <Delete xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Object> <Key>string</Key> <VersionId>string</VersionId> </Object> ... <Quiet>boolean</Quiet> </Delete>
Response Syntax
HTTP/1.1 200 x-amz-request-charged: RequestCharged <?xml version="1.0" encoding="UTF-8"?> <DeleteObjectsOutput> <Deleted> <DeleteMarker>boolean</DeleteMarker> <DeleteMarkerVersionId>string</DeleteMarkerVersionId> <Key>string</Key> <VersionId>string</VersionId> </Deleted> ... <Error> <Code>string</Code> <Key>string</Key> <Message>string</Message> <VersionId>string</VersionId> </Error> ... </DeleteObjectsOutput>
Exemplos
Este exemplo ilustra uma solicitação de exclusão de vários objetos para excluir objetos que resultam em sucesso misto e resposta a erros. A solicitação a seguir exclui dois objetos de um bucket ( bucket
). Neste exemplo, o solicitante não tem permissão para excluir o objeto sample2.txt
.
Request
POST /?delete HTTP/1.1 Host: bucket.bigfile.brascloud.com.br:443 Accept: */* x-amz-date: Wed, 30 Nov 2011 03:39:05 GMT Content-MD5: p5/WA/oEr30qrEEl21PAqw== Authorization: AWS AKIAIOSFODNN7EXAMPLE:W0qPYCLe6JwkZAD1ei6hp9XZIee= Content-Length: 125 Connection: Keep-Alive <Delete> <Object> <Key>sample1.txt</Key> </Object> <Object> <Key>sample2.txt</Key> </Object> </Delete>
Response
HTTP/1.1 200 OK x-amz-id-2: 5h4FxSNCUS7wP5z92eGCWDshNpMnRuXvETa4HH3LvvH6VAIr0jU7tH9kM7X+njXx x-amz-request-id: A437B3B641629AEE Date: Fri, 02 Dec 2011 01:53:42 GMT Content-Type: application/xml Server: bigfile Content-Length: 251 <?xml version="1.0" encoding="UTF-8"?> <DeleteResult xmlns="http://bigfile.brascloud.com.br:443/doc/2006-03-01/"> <Deleted> <Key>sample1.txt</Key> </Deleted> <Error> <Key>sample2.txt</Key> <Code>AccessDenied</Code> <Message>Access Denied</Message> </Error> </DeleteResult>