Object Storage Service:DeleteDirectory

使用上の注意

• ディレクトリを削除するには、次のいずれかの方法を使用します。
  • 再帰的削除: すべてのオブジェクトとサブディレクトリがディレクトリから削除されます。
  • 非再帰的削除: ディレクトリが空の場合、ディレクトリを削除できます。
• 異なる削除方法を使用する場合は、異なる権限が必要です。
  • 再帰的削除メソッドを使用してディレクトリを削除する場合は、そのディレクトリと、このディレクトリ内のすべてのオブジェクトおよびサブディレクトリに対するDeleteObjectアクセス許可が必要です。

    たとえば、デスクトップディレクトリからossディレクトリを再帰的に削除するには、desktop/osstestディレクトリおよびdesktop/osstestディレクトリ内のすべてのオブジェクトおよびサブディレクトリに対するDeleteObject権限が必要です。

  • 非再帰的削除を使用してディレクトリを削除するには、そのディレクトリに対するDeleteObject権限が必要です。

    再帰的でない削除を使用してデスクトップディレクトリからdirディレクトリを削除するには、desktop/dirディレクトリに対するDeleteObject権限が必要です。

• 再帰的削除メソッドを使用して、バケットのルートディレクトリを削除することはできません。
• 再帰的削除メソッドを使用してディレクトリを削除する場合、同時にディレクトリにデータを書き込む要求が送信されると、ディレクトリの削除に失敗することがあります。

リクエストの構造

POST /objectName?x-oss-delete HTTP/1.1
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue 

リクエストヘッダー

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

レスポンスヘッダー

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

レスポンス要素

例

• 非再帰的削除を使用してディレクトリを削除する
  POST /desktop/osstest/a?x-oss-delete HTTP/1.1のサンプルリクエスト

  
  ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
  日付: 4月29日木曜日05:21:12 GMT 2021
  承認: OSS qn6qrrqxo2oawuk53otfjbyc:CTkuxpLAi4XZ + WwIfNm0Fmgb **** 

  成功応答

  のサンプルHTTP/1.1 200 OK
  x-oss-request-id: 559CC9BDC755F95A64485981
  日付: 4月29日木曜日05:21:12 GMT 2021
  接続: キープアライブ
  サーバー: AliyunOSS
  <DeleteDirectoryResult>
      <DirectoryName>desktop/osstest/a</DirectoryName>
      <DeleteNumber>1</DeleteNumber>
  </DeleteDirectoryResult> 

• ディレクトリを再帰的に削除する

  リクエストの例

  POST /desktop/osstest/a?x-oss-delete HTTP/1.1
  ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
  日付: 4月29日木曜日05:21:12 GMT 2021
  承認: OSS qn6qrrqxo2oawuk53otfjbyc:CTkuxpLAi4XZ + WwIfNm0Fmgb ****
  x-oss-delete-recursive: true 

  成功応答

  のサンプルHTTP/1.1 200 OK
  x-oss-request-id: 559CC9BDC755F95A64485981
  日付: 4月29日木曜日05:21:12 GMT 2021
  接続: キープアライブ
  サーバー: AliyunOSS
  <DeleteDirectoryResult>
      <DirectoryName>desktop/osstest/a</DirectoryName>
      <DeleteNumber>100</DeleteNumber>
      <NextDeleteToken>CgJiYw --</NextDeleteToken>
  </DeleteDirectoryResult> 

SDK

OSS SDK for Java: ディレクトリの削除

エラーコード