処理概要

Multi Object Deleteは、１度のHTTPリクエストで複数のobjectを削除することができます。削除したいobjectのキー名毎に発生する個別のDelete Objectによるオーバーヘッドを軽減します。

リクエスト

リクエストパラメタ

Multi Object Deleteは、ほかのbucketに対するPOSTメソッドと区別するためにdeleteパラメタを１つだけ必要とします。

リクエストヘッダー

このオペレーションはすべての操作に共通するリクエストヘッダのみを使用しています。詳細については、一般的なリクエストヘッダを参照してください。

Name	Type	Description	Required
Content-MD5	string	base64でエンコードされた128ビットのパーツデータのMD5ダイジェスト。このヘッダは、パーツデータが最初に送信された同一のデータであること を確認するチェックに使用することができます。これはオプションですが、我々は、エンドツーエンドの整合性チェックなどのContent- MD5メカニズムを使用することをお勧めします。詳細については、 RFC 1864を参照してください。	Yes
Content-Length	string	RFC 2616に定義されたcontentサイズ	Yes
x-amz-mfa	–	使用不可	–

リクエストボディ

Name	Type	Description	Required
Delete	container	リクエストのコンテナ	Yes
Quiet	boolean	レスポンスを、削除に失敗したobjectのエラーのみにしたい場合は、この要素にtrueを設定すること。	No
Object	container	削除したいobjectのコンテナ	Yes
Key	string	削除したいobjectのキー名	Yes
VersionId	–	利用不可	–

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<Delete xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Quiet>Boolean</Quiet>
    <Object>
        <Key>string</Key>
    </Object>
</Delete>

リクエストサンプル

POST /?delete HTTP/1.1
Host: bucketname.S3.amazonaws.com
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

POST /sample-bucket?delete HTTP/1.1
Host: 192.168.0.1
Content-Length: 174
Connection: keep-alive
Date: Tue, 01 Sep 2015 10:00:00 +0000
Content-md5: Ot32zpJZ+vxx/2jk8VVNKg==
Authorization: AWS EXAMPLEjU2So5By3H5v2:EXAMPLEAjwlAvEi2cPLfQaM588ROWW90so7LwfPr

<?xml version="1.0" encoding="UTF-8"?>
<Delete>
  <Object>
    <Key>sample-object-1.txt</Key>
  </Object>
  <Object>
    <Key>sample-object-2.txt</Key>
  </Object>
</Delete>

レスポンス

レスポンスヘッダ

このオペレーションはすべての操作に共通するレスポンスヘッダのみを使用しています。詳細については、一般的なレスポンスヘッダを参照してください。

レスポンスボディ

Name	Type	Description
DeleteResult	container	レスポンスのコンテナ
Deleted	container	削除が成功したobjectのコンテナ
Key	string	削除が成功したobjectのキー名
VersionId	–	利用不可
DeleteMarker	–	利用不可
DeleteMarkerVersionId	–	利用不可
Error	container	削除しようとしたobjectのエラー発生結果を記述します。削除失敗のコンテナ。
Key	string	削除しようとしたobjectのキー名
VersionId	–	利用不可
Code	string	削除の失敗結果のステータスコード
Message	string	エラー記述

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<DeleteResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Deleted>
        <Key>string</Key>
    </Deleted>
    <Error>
        <Key>string</Key>
        <Code>string</Code>
        <Message>string</Message>
    </Error>
</DeleteResult>

レスポンスサンプル

HTTP/1.1 200 OK
Date: Tue, 01 Sep 2015 10:00:00 GMT
X-Clv-Request-Id: 01234567-89ab-cdef-0123-456789abcdef
Accept-Ranges: bytes
Server: Cleversafe/3.5.1.0
X-Clv-S3-Version: 2.4
x-amz-request-id: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/xml
Content-Length: 230

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DeleteResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Deleted>
        <Key>sample-object-1.txt</Key>
    </Deleted>
    <Deleted>
        <Key>sample-object-2.txt</Key>
    </Deleted>
</DeleteResult>