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.storage.api.nifcloud.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.storage.api.nifcloud.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>