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
錯誤碼
錯誤碼 | HTTP狀態代碼 | 描述 |
AccessDenied | 403 | 返回此錯誤的可能原因如下:
|
FileAlreadyExists | 409 | 建立目錄時,如果目前的目錄層級已存在同名檔案,則返回該錯誤。例如desktop目錄下已存在名為osstest的檔案,則在desktop目錄下無法再建立名為osstest的目錄。 |