Delete Multiple Objects#

複数のオブジェクトを削除します。

APIエンドポイント#

リージョン APIエンドポイント
西日本リージョン3の場合 https://objectstorage-s.jp-west-3.cloud.global.fujitsu.com
東日本リージョン3の場合 https://objectstorage-s.jp-east-3.cloud.global.fujitsu.com

HTTPメソッドとURI#

POST

/{bucket}?delete

HTTPステータスコード#

正常時:200

エラー時:400, 403, 404, 405, 409, 411, 412, 416, 422, 500, 501, 503

リクエストパラメータの説明#

名前 In Type デフォルト値
/必須指定
Description
Bucket path string 必須 バケット名
x-amz-content-sha256 header string 必須 ペイロード全体の計算されたSHA256チェックサム
x-amz-date header string 必須 リクエスト側で生成した現在日時
Authorization header string 必須 リクエスト認証に用いる文字列
Content-Length header string 必須 リクエストボディのバイト数
Content-MD5 header string 必須 リクエストボディのMD5ハッシュ値をbase64エンコードした文字列
delete body container 必須 リクエストのコンテナ
Object body container 必須 オブジェクトの削除要求を記述するコンテナ要素
Key body string 必須 削除するオブジェクト名
versionId body string 任意 バージョンID
バージョニング設定が有効なバケット内の特定バージョンのオブジェクトを削除する場合は必須
Quiet body boolean false
任意
リクエストに対してクワイエットモードを有効にするための要素
- true:有効
- false:無効

レスポンスヘッダーの説明#

名前 Type Description
Date string トランザクションが実行された日時
Content-Type header MIME仕様で定義されているコンテントの形式
Connection header 持続接続の状態を表示します。
x-amz-request-id header このリクエストに付与されるID
トラブルについて問い合わせる際に利用されます。
x-amz-id-2 string このリクエストに対する処理ID
トラブルについて問い合わせる際に利用されます。
x-ntap-sg-trace-id string このリクエストに対する処理ID
トラブルについて問い合わせる際に利用されます。
X-Fcx-Endpoint-Request header APIエンドポイントとしてリクエストを受け付けたことを示す番号

レスポンスボディ(正常系)の説明#

名前 Type Description
DeleteResult container レスポンスの要素となるコンテナ
Deleted container 削除に成功したオブジェクト情報を含むコンテナ
Key string 削除を行ったオブジェクトのキー

リクエスト例#

リクエストヘッダー

POST /general-bucket?delete HTTP/1.1
User-Agent: curl/7.29.0
Host: objectstorage-s.jp-east-3.cloud.global.fujitsu.com
Accept: */*
content-md5:d3fdf84MpyPVE5VQ+9RBVA==
x-amz-content-sha256:22a7b4d9d557f3b1437e44a96193aca6abbd988fb54d5fa7ff1b48a7015a4fdf
x-amz-date:20210507T081020Z
Authorization:AWS4-HMAC-SHA256 Credential=9O80W859T3K4XTITI015/20210507/jp-east-3/s3/aws4_request,SignedHeaders=content-length;content-md5;host;x-amz-content-sha256;x-amz-date,Signature=78a9dbae5467fce503f2743b3ac3c3636232a8df74b488759c19a4995d8e75f5
Content-Length: 89

リクエストボディ

<Delete>
  <Object>
    <Key>Object-1</Key>
  </Object>
  <Object>
    <Key>Object-2</Key>
  </Object>
</Delete>

レスポンス例#

レスポンスヘッダ

HTTP/1.1 200 OK
Date: Fri, 07 May 2021 08:10:20 GMT
Content-Type: application/xml
Transfer-Encoding: chunked
Connection: keep-alive
x-amz-request-id: 2015514999
x-amz-id-2: 12174498
x-ntap-sg-trace-id: 1affa0f9ec0ca4d3
X-Fcx-Endpoint-Request: EXECUTED_api3-rmp2.management.jp-east-3.local-28847-869499-1_200

レスポンスボディの例

<DeleteResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Deleted>
    <Key>Object-1</Key>
  </Deleted>
  <Deleted>
    <Key>Object-2</Key>
  </Deleted>
</DeleteResult>