Object Storage Service:ディレクトリの削除

注意事項

• ディレクトリを削除するには、次のいずれかの方法を使用します。

  • 再帰的削除: すべてのオブジェクトとサブディレクトリがディレクトリから削除されます。

  • 非再帰的削除: ディレクトリが空の場合、ディレクトリを削除できます。

• 異なる削除方法を使用する場合、異なる権限が必要です。

  • 再帰的削除方法を使用してディレクトリを削除する場合、ディレクトリ、およびこのディレクトリ内のすべてのオブジェクトとサブディレクトリに対する DeleteObject 権限が必要です。

    たとえば、desktop ディレクトリから oss ディレクトリを再帰的に削除するには、 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

リクエストヘッダー

この API 操作には、Host や Date などの共通リクエストヘッダーも含める必要があります。共通リクエストヘッダーの詳細については、「共通リクエストヘッダー」をご参照ください。

レスポンスヘッダー

この API 操作に関連するレスポンスヘッダーには、共通レスポンスヘッダーのみが含まれます。この API 操作に関連する共通レスポンスヘッダーの詳細については、「共通レスポンスヘッダー」をご参照ください。

レスポンス要素

例

• 非再帰的削除を使用してディレクトリを削除する

  リクエスト例

  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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

  成功レスポンスの例

  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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  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>

OSS SDK

以下のプログラミング言語の OSS SDK を使用して、DeleteDirectory 操作を呼び出すことができます。

• Java

• Python

• Node.js

• PHP

• Browser.js

• C++

エラーコード