全部產品
Search
文件中心

Object Storage Service:CreateDirectory

更新時間:Jun 19, 2024

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的目錄。