--- title: "DeleteObjects" slug: "ncloudstorage-deleteobjects" updated: 2026-09-17T09:58:30Z published: 2026-09-17T09:58:30Z canonical: "api.ncloud-docs.com/ncloudstorage-deleteobjects" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # DeleteObjects Classic/VPC環境で利用できます。 Ncloud Storageバケットに保存されている2つ以上のオブジェクトを一括削除します。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | POST | - | ### リクエストヘッダ リクエストヘッダの説明は次の通りです。 参考 Ncloud Storage APIで共通して使用されるヘッダの詳細は、[Ncloud Storageのリクエストヘッダ](/docs/ja/storage-ncloudstorage#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 | フィールド | 必須の有無 | 説明 | | --- | --- | --- | | `Content-MD5` | Conditional | MD5ハッシュ値 - `x-amz-checksum-*`を入力しなかった場合、必ず入力 | | `x-amz-checksum-*` | Conditional | チェックサムのハッシュ値 - キーの`*`にサポートするアルゴリズムを入力 - サポートアルゴリズム: `crc32` \| `crc32c` \| `sha1` \| `sha256` \| `crc64nvme` - `Content-MD5`を入力しなかった場合、必ず入力 | | `x-amz-bypass-governance-retention` | Optional | GOVERNANCEモードのリテンションをバイパスするか - `true`に指定すると GOVERNANCEリテンションが設定されたオブジェクトバージョンを削除 - 別途のバイパス権限が必要 | ### リクエストクエリパラメータ リクエストクエリパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `delete` | String | Required | オブジェクト削除リクエスト - 値なしでキーだけ入力 | ### リクエストボディ リクエストボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `Delete` | Object | Required | オブジェクトリスト | | `Delete.Object` | Array | Required | [オブジェクト情報](/docs/ja/ncloudstorage-deleteobjects#DeleteObject) | | `Delete.Quiet` | Boolean | Optional | レスポンスの詳細情報を省略するかどうか - `true`: 省略 (有効値) | #### `Delete.Object` `Delete.Object`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `Key` | String | Required | オブジェクト名 - [ListObjectsV2](/docs/ja/ncloudstorage-listobjectsv2)を参照 | | `VersionId` | String | Optional | オブジェクトバージョン ID - [ListObjectVersions](/docs/ja/ncloudstorage-listobjectversions)を参照 - バージョン管理が設定されたバケットでオブジェクトの特定のバージョンを削除する場合、入力 | | `ETag` | String | Optional | オブジェクトの固有 ID(Entity Tag) - [ListObjectsV2](/docs/ja/ncloudstorage-listobjectsv2)を参照 | | `LastModifiedTime` | Integer | Optional | 最終更新日時 - [ListObjectsV2](/docs/ja/ncloudstorage-listobjectsv2)を参照 - Unix Timestamp形式 | | `Size` | Integer | Optional | オブジェクトのサイズ(Byte) - [ListObjectsV2](/docs/ja/ncloudstorage-listobjectsv2)を参照 | ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` POST /?delete HTTP/1.1 Host: {Bucket}.kr.ncloudstorage.com Content-MD5: {Content-MD5} ``` ``` Data1.xlsx 89f83309-****-****-****-9cc2c468d0e9 Data2.xlsx ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスヘッダ Ncloud Storage APIで共通して使用されるヘッダの詳細は、[Ncloud Storageのレスポンスヘッダ](/docs/ja/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94)をご参照ください。 ### レスポンスボディ レスポンスボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `DeleteResult` | Object | - | 削除リクエストオブジェクト情報 | | `DeleteResult.Deleted` | Array | - | [削除成功オブジェクトリスト](/docs/ja/ncloudstorage-deleteobjects#DeleteResultDeleted) | | `DeleteResult.Error` | Array | - | [削除失敗オブジェクトリスト](/docs/ja/ncloudstorage-deleteobjects#DeleteResultError) | #### `DeleteResult.Deleted` `DeleteResult.Deleted`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `Key` | String | - | オブジェクト名 | | `VersionId` | String | - | オブジェクトのバージョン ID - リクエストに`VersionId`を入力した場合、表示 | | `DeleteMarker` | Boolean | - | 削除マーカーかどうか - `true` \| `false` - `true`: 削除マーカー - `false`: 削除マーカーではない | | `DeleteMarkerVersionId` | String | - | 削除マーカーのバージョン ID - バージョン管理が設定されたバケットで削除をキャンセルする場合、次のリクエストの`VersionId`にこの値を入力 | #### `DeleteResult.Error` `DeleteResult.Error`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `Key` | String | - | オブジェクト名 | | `VersionId` | String | - | オブジェクトバージョン ID | | `Code` | String | - | エラーコード | | `Message` | String | - | エラーメッセージ | ### レスポンスステータスコード Ncloud Storage APIで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud Storageのレスポンスステータスコード](/docs/ja/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 レスポンスのサンプルコードは次の通りです。 #### 全削除が成功した場合 全削除が成功した場合のレスポンスのサンプルコードは次の通りです。 ``` HTTP/1.1 200 OK Data1.xlsx true b253ab10-****-****-****-9cc2c468d0e9 Date2.xlsx true b253aad9-****-****-****-9cc2c468d0e9 ``` 参考 リクエストボディのオブジェクト情報がコンソールに登録した情報と一致しない場合、`Content-MD5`または`x-amz-checksum-*`ヘッダ値がリクエストボディと一致して200 OKが返されてもそのオブジェクトは削除されない場合があります。そのため、APIの呼び出し後、コンソールでオブジェクトが正常に削除されたことを確認してください。 #### 一部削除のみ成功した場合 一部削除のみ成功した場合のレスポンスのサンプルコードは次の通りです。 ``` HTTP/1.1 200 OK Data2.xlsx true f201de46-****-****-****-9cc2c468d0e9 Data1.xlsx 89f83309-****-****-****-9cc2c468d0e9 InvalidArgument Invalid version id specified ```