调用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. | 资源夹数量超出限制。 |
访问错误中心查看更多错误码。