--- title: "DeleteObjects" slug: "ncloudstorage-deleteobjects" updated: 2026-09-17T10:12:27Z published: 2026-09-17T10:12:27Z 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 Available in Classic and VPC Bulk delete 2 or more objects stored in a Ncloud Storage bucket at the same time. ## Request This section describes the request format. The method and URI are as follows: | Method | URI | | --- | --- | | POST | - | ### Request headers The following describes the request headers. Note For information about the headers common to all Ncloud Storage APIs, see [Ncloud Storage request headers](/docs/en/storage-ncloudstorage#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94). | Field | Required | Description | | --- | --- | --- | | `Content-MD5` | Conditional | MD5 hash value - Required if `x-amz-checksum-*` is not entered | | `x-amz-checksum-*` | Conditional | Checksum hash value - Enter the supported algorithm in `*` of the key. - Supported algorithm: `crc32` \| `crc32c` \| `sha1` \| `sha256` \| `crc64nvme` - Required if `Content-MD5` is not entered. | | `x-amz-bypass-governance-retention` | Optional | Whether to bypass GOVERNANCE mode retention - Delete the object version for which GOVERNANCE retention is enabled when set to `true`. - Separate bypass permission is required. | ### Request query parameters You can use the following query parameters with your request: | Field | Type | Required | Description | | --- | --- | --- | --- | | `delete` | String | Required | Request object deletion. - Enter only keys without values. | ### Request body You can include the following data in the body of your request: | Field | Type | Required | Description | | --- | --- | --- | --- | | `Delete` | Object | Required | Object list | | `Delete.Object` | Array | Required | [Object information](/docs/en/ncloudstorage-deleteobjects#DeleteObject) | | `Delete.Quiet` | Boolean | Optional | Whether to omit response details - `true`: Omit (valid value) | #### `Delete.Object` The following describes `Delete.Object`. | Field | Type | Required | Description | | --- | --- | --- | --- | | `Key` | String | Required | Object name - See [ListObjectsV2](/docs/en/ncloudstorage-listobjectsv2). | | `VersionId` | String | Optional | Object version ID - See [ListObjectVersions](/docs/en/ncloudstorage-listobjectversions). - Enter when deleting a specific version of an object from a bucket with version control enabled. | | `ETag` | String | Optional | Unique object identifier (entity tag) - See [ListObjectsV2](/docs/en/ncloudstorage-listobjectsv2). | | `LastModifiedTime` | Integer | Optional | Last modification date and time - See [ListObjectsV](/docs/en/ncloudstorage-listobjectsv2). - Unix timestamp format. | | `Size` | Integer | Optional | Object size (byte) - See [ListObjectsV2](/docs/en/ncloudstorage-listobjectsv2). | ### Request example The request example is as follows: ``` POST /?delete HTTP/1.1 Host: {Bucket}.kr.ncloudstorage.com Content-MD5: {Content-MD5} ``` ``` Data1.xlsx 89f83309-****-****-****-9cc2c468d0e9 Data2.xlsx ``` ## Response This section describes the response format. ### Response headers For information about the headers common to all Ncloud Storage APIs, see [Ncloud Storage response headers](/docs/en/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94). ### Response body The response body includes the following data: | Field | Type | Required | Description | | --- | --- | --- | --- | | `DeleteResult` | Object | - | Deletion request object information | | `DeleteResult.Deleted` | Array | - | [List of successfully deleted objects](/docs/en/ncloudstorage-deleteobjects#DeleteResultDeleted) | | `DeleteResult.Error` | Array | - | [List of objects failed to be deleted](/docs/en/ncloudstorage-deleteobjects#DeleteResultError) | #### `DeleteResult.Deleted` The following describes `DeleteResult.Deleted`. | Field | Type | Required | Description | | --- | --- | --- | --- | | `Key` | String | - | Object name | | `VersionId` | String | - | Object version ID - Display if `VersionId` is entered in the request. | | `DeleteMarker` | Boolean | - | Whether it is a deletion marker - `true` \| `false` - `true`: Deletion marker - `false`: Not deletion marker | | `DeleteMarkerVersionId` | String | - | Deletion marker version ID - When canceling deletion in a bucket with version control enabled, enter the corresponding value in `VersionId` of the next request. | #### `DeleteResult.Error` The following describes `DeleteResult.Error`. | Field | Type | Required | Description | | --- | --- | --- | --- | | `Key` | String | - | Object name | | `VersionId` | String | - | Object version ID | | `Code` | String | - | Error code | | `Message` | String | - | Error message | ### Response status codes For information about the HTTP status codes common to all Ncloud Storage APIs, see [Common Ncloud Storage response status codes](/docs/en/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C). ### Response example The response example is as follows: #### If complete deletion is successful The following is a sample response when complete deletion is successful. ``` HTTP/1.1 200 OK Data1.xlsx true b253ab10-****-****-****-9cc2c468d0e9 Date2.xlsx true b253aad9-****-****-****-9cc2c468d0e9 ``` Note If the object information in the request body does not match the information registered in the console, the object may not be deleted even if the `Content-MD5` or `x-amz-checksum-*` header value matches the request body and a 200 OK response is returned. Therefore, check in the console after the API call to confirm that the object has been deleted correctly. #### If only partial deletion is successful The following is a sample response when only partial deletion is successful. ``` HTTP/1.1 200 OK Data2.xlsx true f201de46-****-****-****-9cc2c468d0e9 Data1.xlsx 89f83309-****-****-****-9cc2c468d0e9 InvalidArgument Invalid version id specified ```