---
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}
```
```
```
## レスポンス
レスポンス形式を説明します。
### レスポンスヘッダ
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
```