この操作を呼び出して、ディレクトリを作成できます。 この操作は、階層型名前空間機能が有効になっているバケットにのみ適用できます。
注意事項
ディレクトリを作成するには、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: AliyunOSSOSS SDK
次のプログラミング言語の OSS SDK を使用して、CreateDirectory 操作を呼び出すことができます。
エラーコード
エラーコード | HTTP ステータスコード | 説明 |
AccessDenied | 403 | 考えられる原因:
|
FileAlreadyExists | 409 | 同じディレクトリレベルに同じ名前の既存のオブジェクトが存在するため、エラーメッセージが返されます。 例: desktop ディレクトリには、osstest という名前のオブジェクトが含まれています。 desktop ディレクトリに osstest という名前のディレクトリを作成することはできません。 |