对象存储 OSS：DeleteDirectory

注意事项

• 目录支持如下删除方式，请根据实际选择。
  • 递归删除（Recursively Delete）：清空目录中的所有文件和目录。
  • 非递归删除：只能删除空目录。
• 使用的删除方式不同时需要的权限不同。
  • 使用递归删除方式删除目录时，您必须有目录以及该目录下所有文件和目录的DeleteObject权限。

    例如要递归删除desktop目录下osstest目录，您必须有desktop/osstest和desktop/osstest/*的DeleteObject权限。

  • 使用非递归删除方式删除目录时，您必须有目录的DeleteObject权限。

    例如要非递归删除desktop目录下的dir目录，您必须有desktop/dir的DeleteObject权限。

• 使用递归删除方式删除目录时，如果同时存在向目录的并发写请求，则可能导致目录删除失败。

请求语法

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

请求头

此接口还需要包含Host、Date等公共请求头。关于公共请求头的更多信息，请参见公共请求头（Common Request Headers）。

响应头

此接口只包含公共响应头。关于公共响应头的更多信息，请参见公共响应头（Common Response Headers）。

响应元素

示例

• 非递归删除目录
  请求示例

  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 qn6qrrqxo2oawuk53otfjbyc:CTkuxpLAi4XZ+WwIfNm0Fmgb****

  返回示例

  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>

• 递归删除目录

  请求示例

  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 qn6qrrqxo2oawuk53otfjbyc:CTkuxpLAi4XZ+WwIfNm0Fmgb****
  x-oss-delete-recursive: true

  返回示例

  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>Cg9kZXNrdG9wL29zcy9hLzk-</NextDeleteToken>
  </DeleteDirectoryResult>

SDK

Java SDK：删除目录

错误码