CreateDirectory - Object Storage Service

CreateDirectory介面用於建立目錄（Directory）。只有開啟階層命名空間的Bucket支援調用此介面。

注意事項

要建立目錄，您必須有PutObject許可權。
建立目錄時，如果已存在同名目錄且使用者對該目錄具有存取權限，則OSS返回200 OK，但是不會執行建立目錄的操作。
建立目錄時，不支援傳入資料，目錄的Content-Length固定為0。
目錄的Content-Type固定為application/x-directory，無法修改。
建立目錄時，設定的目錄絕對路徑（DirectoryName）中不能出現連續的正斜線（/）。

請求文法

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

要求標頭

名稱

類型

是否必選

描述

Authorization

字串

否

表示請求本身已被授權。更多資訊，請參見RFC2616。

通常情況下Authorization是必選要求標頭，但如果採用了URL包含簽名，則不用攜帶該要求標頭。更多資訊，請參見在URL中包含簽名。

預設值：無

此介面還需要包含Host、Date等公用要求標頭。關於公用要求標頭的更多資訊，請參見公用要求標頭（Common Request Headers）。

回應標頭

此介面僅包含公用回應標頭。更多資訊，請參見公用回應標頭（Common Response Headers）。

樣本

請求樣本

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: OSS qn6q**************:77Dv****************

返回樣本

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

SDK

Java SDK：建立目錄

錯誤碼

錯誤碼

HTTP狀態代碼

描述

AccessDenied

403

返回此錯誤的可能原因如下：

建立目錄時，使用者對設定的Bucket沒有存取權限。
建立目錄時，已存在同名目錄但使用者對該目錄沒有存取權限。

FileAlreadyExists

409

建立目錄時，如果目前的目錄層級已存在同名檔案，則返回該錯誤。例如desktop目錄下已存在名為osstest的檔案，則在desktop目錄下無法再建立名為osstest的目錄。