Object Storage Service:DeleteDirectory

Usage notes

• To delete a directory, use one of the following methods:

  • Recursive delete: All objects and subdirectories are deleted from the directory.

  • Non-recursive delete: The directory can be deleted if the directory is empty.

• Different permissions are required when a different deletion method is used.

  • When you use the recursive delete method to delete a directory, you must have the DeleteObject permission on the directory and all objects and subdirectories in this directory.

    For example, to recursively delete the oss directory from the desktop directory, you must have the DeleteObject permission on the desktop/osstest directory and all objects and subdirectories in the desktop/osstest directory.

  • To use non-recursive delete to delete a directory, you must have the DeleteObject permission on the directory.

    To use non-recursive delete to delete the dir directory from the desktop directory, you must have the DeleteObject permission on the desktop/dir directory.

• You cannot use the recursive delete method to delete the root directory of a bucket.

• When you use the recursive delete method to delete a directory, the directory may fail to be deleted if concurrent requests are sent to write data to the directory at the same time.

Request structure

POST /objectName?x-oss-delete HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Request headers

This API operation must also include common request headers such as Host and Date. For more information about common request headers, see Common request headers.

Response headers

The response headers involved in this API operation contain only common response headers. For more information about common response headers involved in this API operation, see Common response headers.

Response elements

Examples

• Use non-recursive delete to delete a directory

  Sample requests

  POST /desktop/osstest/a?x-oss-delete HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Date: Thu, 29 Apr 2021 05:21:12 GMT
  Authorization: qn6q**************:77Dv****************

  Sample success responses

  HTTP/1.1 200 OK
  x-oss-request-id: 559CC9BDC755F95A64485981
  Date: Thu, 29 Apr 2021 05:21:12 GMT
  Connection: keep-alive
  Server: AliyunOSS
  <DeleteDirectoryResult>
      <DirectoryName>desktop/osstest/a</DirectoryName>
      <DeleteNumber>1</DeleteNumber>
  </DeleteDirectoryResult>

• Recursively delete a directory

  Sample requests

  POST /desktop/osstest/a?x-oss-delete HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Date: Thu, 29 Apr 2021 05:21:12 GMT
  Authorization: OSS qn6q**************:77Dv****************
  x-oss-delete-recursive: true

  Sample success responses

  HTTP/1.1 200 OK
  x-oss-request-id: 559CC9BDC755F95A64485981
  Date: Thu, 29 Apr 2021 05:21:12 GMT
  Connection: keep-alive
  Server: AliyunOSS
  <DeleteDirectoryResult>
      <DirectoryName>desktop/osstest/a</DirectoryName>
      <DeleteNumber>100</DeleteNumber>
      <NextDeleteToken>CgJiYw--</NextDeleteToken>
  </DeleteDirectoryResult>

SDK

OSS SDK for Java: Delete directories

Error codes