Creates a folder.

Note A maximum of five levels of folders can be created under the root folder.

In this example, a folder named rdFolder is created under the root folder.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes CreateFolder

The operation that you want to perform. Set the value to CreateFolder.

ParentFolderId String No r-b1****

The ID of the parent folder.

FolderName String Yes rdFolder

The name of the folder.

The name must be 1 to 24 characters in length and can contain letters, digits, underscores (_), periods (.),and hyphens (-).

For more information about common request parameters, see Common parameters.

Response parameters

Parameter Type Example Description
RequestId String C2CBCA30-C8DD-423E-B4AD-4FB694C9180C

The ID of the request.

Folder object

The information of the folder.

FolderId String fd-u8B321****

The ID of the folder.

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

The time when the folder was created.

ParentFolderId String r-b1****

The ID of the parent folder.

FolderName String rdFolder

The name of the folder.

Examples

Sample requests

https://resourcemanager.aliyuncs.com/?Action=CreateFolder
&FolderName=rdFolder
&<Common request parameters>

Sample success responses

XML format 

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 format 

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"
}

Error codes

Http status code Error code Error message Description
400 InvalidParameter.ParentFolderId The ParentFolderId is invalid. The error message returned because the value of the ParentFolderId parameter is invalid. The value must start with r- followed by 6 characters or start with fd- followed by 10 characters. Valid characters are letters and digits.
400 MissingParameter.Folder.Name You must specify the resource folder name. The error message returned because the folder name is not specified. Specify a folder name.
400 InvalidParameter.Folder.Name The Name of folder is invalid. The error message returned because the folder name is invalid. The folder name can contain only letters, digits, underscores (_), periods (.), and hyphens (-).
400 InvalidParameter.Folder.Name.Length The Name of folder exceeds the length limit. The error message returned because the length of the folder name has exceeded the upper limit. The name must be 1 to 24 characters in length.
400 InvalidParameter.Folder.Name.AlreadyUsed The name already exists under the same parent. Please change to another name. The error message returned because the folder name already exists under the same parent folder. Change the 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. The error message returned because the resource directory for the account is not enabled. Enable the resource directory for the account.
404 EntityNotExists.Folder The resource directory folder does not exist. The error message returned because the folder does not exist. Create the folder first.
409 LimitExceeded.Folder.Depth The folder depth exceeds the limit of 5. The error message returned because the maximum number of folder levels has been reached. A maximum of five levels of folders can be created under the root folder.
409 QuotaExceeded.Folder.Count The number of folders exceeds the quota. The error message returned because the maximum number of folders has been reached.

For a list of error codes, visit the API Error Center.