Delete Multiple Objects
処理概要
1回のリクエストで複数のオブジェクトを削除します。
バージョン管理
特定のバージョンのオブジェクトを削除するにはバージョンIDを指定します。
指定するパラメーター
| パラメーター | 説明 | 必須 |
|---|---|---|
| delete | 複数オブジェクト削除の識別パラメータ Type : なし |
○ |
指定するヘッダー
| パラメーター | 説明 | 必須 |
|---|---|---|
| Content-MD5 | Base64 エンコードしたリクエストペイロードの 128biy MD5ハッシュ値 Type : String |
○ |
| Content-Length | リクエストペイロードの長さ Type : String |
○ |
指定するボディ
| フィールド | 説明 | 必須 |
|---|---|---|
| Delete | Deleteリクエストコンテナ Type : Container Ancestor : なし Children : Quiet, Object |
○ |
| Quiet | 無言モードを有効にする要素。標準で無効。 Type : Boolean Ancestor : AccessControlPolicy Children : なし Default : false |
|
| Object | Object要素コンテナ Type : Container Ancestor : Delete Children : Key, VersionId |
○ |
| Key | 削除するオブジェクトのキー Type : String Ancestor : Object Children : なし |
○ |
| VersionId | 削除するオブジェクトのバージョンID Type : String Ancestor : Object Children : なし |
応答フィールド
| フィールド | 説明 |
|---|---|
| DeleteResult | レスポンスコンテナ Type : Container Ancestor : なし Children : Deleted, Error |
| Deleted | 削除に成功したオブジェクトのコンテナ Type : Container Ancestor : DeleteResult Children : Key, VersionId |
| Key | 削除するオブジェクトのキー Type : String Ancestor : Deleted, or Error Children : なし |
| VersionId | 削除するオブジェクトのバージョンID Type : String Ancestor : Deleted, or Error Children : なし |
| DeleteMarker | バージョニングが有効又は停止状態のオブジェクトに対するDeleteMarker の作成又は削除の成功 Type : Boolean Ancestor : Deleted Children : なし |
| DeleteMarkerVersionId | 作成/削除に成功したDeleteMarkerのバージョンID Type : String Ancestor : Deleted Children : なし |
| Error | 削除に失敗したオブジェクトのコンテナ Type : Container Ancestor : DeleteResultr Children : Key, VersionId, Code, Message |
| Code | 削除失敗のステータスコード Type : String Ancestor :Error Children : なし |
| Message | エラーの詳細 Type : String Ancestor : Error Children : なし |
リクエストサンプル（versionId指定なし）
POST /?delete= HTTP/1.1
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
Date: Wed, 29 Jun 2016 12:00:00 GMT
Content-MD5: ysiBzLdqO0j5teuCvSwhXw==
Content-Length: 171
Authorization: AWS 07cbb45fc128390123f4:+o4vgswyoIOkWpopqhXJRzUD4EQ=
<Delete xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Object>
<Key>object1</Key>
</Object>
<Object>
<Key>object3</Key>
</Object>
<Object>
<Key>object5</Key>
</Object>
</Delete>
応答サンプル
HTTP/1.1 200 OK
x-amz-request-id: 33a3999d-b011-37d2-8a5e-2a750c2287df
Content-Length: 226
<?xml version="1.0" encoding="UTF-8"?>
<DeleteResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Deleted>
<Key>object1</Key>
</Deleted>
<Deleted>
<Key>object3</Key>
</Deleted>
<Deleted>
<Key>object5</Key>
</Deleted>
</DeleteResult>
リクエストサンプル（versionId指定あり）
POST /?delete= HTTP/1.1
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
Date: Wed, 29 Jun 2016 12:00:00 GMT
Content-MD5: wMVoboys8VldzyDBgKFpDA==
Content-Length: 242
Authorization: AWS 07cbb45fc128390123f4:+o4vgswyoIOkWpopqhXJRzUD4EQ=
<Delete xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Object>
<VersionId>xDGL9F4rCvRWtde5gbOQEtJvjuk.OrU</VersionId>
<Key>object6</Key>
</Object>
<Object>
<VersionId>Gjn24E2Nx0Dir3GBoRrGKbkOGPnYR</VersionId>
<Key>object8</Key>
</Object>
</Delete>
応答サンプル
HTTP/1.1 200 OK
x-amz-request-id: 33a3999d-b011-37d2-8a5e-2a750c2287df
Content-Length: 295
<?xml version="1.0" encoding="UTF-8"?>
<DeleteResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Deleted>
<Key>object6</Key>
<VersionId>xDGL9F4rCvRWtde5gbOQEtJvjuk.OrU</VersionId>
</Deleted>
<Deleted>
<Key>object8</Key>
<VersionId>Gjn24E2Nx0Dir3GBoRrGKbkOGPnYR</VersionId>
</Deleted>
</DeleteResult>
