調用CreateFolder創建資源夾。

說明 最多支持創建5級資源夾。

本文將提供一個示例,在Root資源夾下,創建一個名為rdFolder的資源夾。

調試

您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String CreateFolder

要執行的操作。取值:CreateFolder。

ParentFolderId String r-b1****

父資源夾ID。

FolderName String rdFolder

資源夾名稱。

長度為1~24個字符或漢字,可包含漢字、英文字母、數字、下劃線(_)、半角句號(.)和短劃線(-)。

關于公共請求參數的詳情,請參見公共參數

返回數據

名稱 類型 示例值 描述
RequestId String C2CBCA30-C8DD-423E-B4AD-4FB694C9180C

請求ID。

Folder object

資源夾信息。

FolderId String fd-u8B321****

資源夾ID。

CreateTime String 2019-02-19T09:34:50.757Z

資源夾創建時間。

ParentFolderId String r-b1****

父資源夾ID。

FolderName String rdFolder

資源夾名稱。

示例

請求示例

https://resourcemanager.aliyuncs.com/?Action=CreateFolder
&FolderName=rdFolder
&<公共請求參數>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<CreateFolderResponse>
        <Folder>
            <FolderName>rdFolder</FolderName> 
            <ParentFolderId>r-b1****</ParentFolderId>
            <FolderId>fd-u8B321****</FolderId>
            <CreateTime>2019-02-19T09:34:50.757Z</CreateTime>
        </Folder>
        <RequestId>C2CBCA30-C8DD-423E-B4AD-4FB694C9180C</RequestId>
</CreateFolderResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Folder" : {
    "FolderName" : "rdFolder",
    "ParentFolderId" : "r-b1****",
    "FolderId" : "fd-u8B321****",
    "CreateTime" : "2019-02-19T09:34:50.757Z"
  },
  "RequestId" : "C2CBCA30-C8DD-423E-B4AD-4FB694C9180C"
}

錯誤碼

HttpCode 錯誤碼 錯誤信息 描述
400 InvalidParameter.ParentFolderId The ParentFolderId is invalid. 父資源夾ID無效,資源夾ID應以“r-”開頭+6位數字或英文字母或以“fd-”開頭+10位數字或英文字母。
400 MissingParameter.Folder.Name You must specify the resource folder name. 資源夾名稱缺失,請指定資源夾名稱。
400 InvalidParameter.Folder.Name The Name of folder is invalid. 資源夾名稱無效。請輸入字符或漢字,可包含英文字母、“_”、“.”、“-”或數字。
400 InvalidParameter.Folder.Name.Length The Name of folder exceeds the length limit. 資源夾名稱長度超出限制,長度為1~24個字符或漢字。
400 InvalidParameter.Folder.Name.AlreadyUsed The name already exists under the same parent. Please change to another name. 相同父級下已存在該名稱,請更換。
404 EntityNotExists.ResourceDirectory The resource directory for the account is not enabled. We recommend that you first enable the resource directory for the account. 當前賬號未啟用資源目錄,請先啟用資源目錄。
404 EntityNotExists.Folder The resource directory folder does not exist. 資源夾不存在,請先創建資源夾。
409 LimitExceeded.Folder.Depth The folder depth exceeds the limit of 5. 資源夾層級超出限制,除了根資源夾最多只能創建5個層級。
409 QuotaExceeded.Folder.Count The number of folders exceeds the quota. 資源夾數量超出限制。

訪問錯誤中心查看更多錯誤碼。