ニフクラAPI (オブジェクトストレージサービス: DeleteMultipleObjects)

DeleteMultipleObjects

処理概要

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

リクエストURL

POST /{Bucket}?delete

指定するパラメーター

ヘッダーパラメーター

パラメーター	型	説明	必須
x-amz-content-sha256	string	ペイロード全体の計算されたSHA256チェックサム	○
x-amz-date	string	リクエスト側で生成した現在日時	○
Authorization	string	リクエスト認証に用いる文字列	○
Content-Length	string	オブジェクトのバイト数	○
Content-MD5	string	リクエストボディのMD5ハッシュ値をbase64エンコードした文字列	○

パスパラメーター

パラメーター	型	説明	必須
Bucket	string	バケット名	○

リクエストボディ

パラメーター	型	説明	必須
Delete	structure	リクエストのコンテナ	○
␣Object	list	オブジェクトの削除要求を記述するコンテナ要素	○
␣␣Key	string	削除するオブジェクト名	○
␣␣VersionId	string	バージョンID バージョニング設定が有効なバケット内の特定バージョンのオブジェクトを削除する場合は必須
␣␣Quiet	boolean	リクエストに対してクワイエットモードを有効にするための要素 - true：有効 - false：無効 値: true (有効) false (無効) Default: false

応答フィールド

レスポンスヘッダー

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

レスポンスボディ

フィールド (項目)	型	説明
DeleteResult	structure	レスポンスの要素となるコンテナ
␣Deleted	list	削除に成功したオブジェクト情報を含むコンテナ
␣␣Key	string	削除を行ったオブジェクトのキー
␣␣VersionId	string	オブジェクトのバージョンID

リクエストサンプル

    POST /general-bucket?delete HTTP/1.1
User-Agent: curl/7.29.0
Host: jp-east-1.storage.api.nifcloud.com
Accept: */*
content-md5:d3fdf84MpyPVE5VQ+9RBVA==
x-amz-content-sha256:22a7b4d9d557f3b1437e44a96193aca6abbd988fb54d5fa7ff1b48a7015a4fdf
x-amz-date:20210507T081020Z
Authorization:AWS4-HMAC-SHA256 Credential=9O80W859T3K4XTITI015/20210507/jp-east-1/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-1.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>