すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:CreateDirectory

最終更新日:May 08, 2025

この操作を呼び出して、ディレクトリを作成できます。 この操作は、階層型名前空間機能が有効になっているバケットにのみ適用できます。

注意事項

  • ディレクトリを作成するには、PutObject 権限が必要です。

  • ディレクトリを作成するときに、作成するディレクトリの名前が既存のディレクトリと同じ名前で、既存のディレクトリにアクセスする権限を持っている場合、OSS は 200 OK を返します。 ただし、OSS は作成操作を実行しません。

  • ディレクトリを作成するときに、ディレクトリにデータをインポートすることはできません。 ディレクトリの Content-Length 値は 0 のみに設定できます。

  • ディレクトリの Content-Type 値は application/x-directory のみに設定でき、変更できません。

  • ディレクトリを作成するときに、ディレクトリの絶対パスに連続するスラッシュ(/)を含めることはできません。

構文

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

リクエストヘッダー

ヘッダー

タイプ

必須

説明

Authorization

String

いいえ

リクエストが承認されていることを指定します。 詳細については、「RFC 2616」をご参照ください。

Authorization ヘッダーはほとんどの場合必須です。 ただし、リクエストで署名付き URL を使用する場合、このヘッダーは必須ではありません。 詳細については、「署名付き URL を生成する」をご参照ください。

デフォルト値: null

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

レスポンスヘッダー

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

リクエストの例

POST /desktop/oss?x-oss-dir 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
Last-Modified: Wed, 24 Feb 2021 06:07:48 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS

OSS SDK

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

エラーコード

エラーコード

HTTP ステータスコード

説明

AccessDenied

403

考えられる原因:

  • ディレクトリを作成するときに、指定されたバケットにアクセスする権限がありません。

  • ディレクトリを作成するときに、作成するディレクトリの名前が既存のディレクトリと同じ名前ですが、既存のディレクトリにアクセスする権限がありません。

FileAlreadyExists

409

同じディレクトリレベルに同じ名前の既存のオブジェクトが存在するため、エラーメッセージが返されます。 例: desktop ディレクトリには、osstest という名前のオブジェクトが含まれています。 desktop ディレクトリに osstest という名前のディレクトリを作成することはできません。