KDDIクラウドプラットフォームサービス ナレッジサイト

  • HOME
  • 開発者ガイドブック(APIリファレンス)
  • オブジェクトストレージ
  • サービス操作
  • オブジェクト操作
  • Delete Multiple Object

Delete Multiple Object

処理概要

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

リクエスト

リクエストパラメタ

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

リクエストヘッダー

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

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>
2024/09/15 2024/09/15