Deletes a folder.
Operation description
Before deleting a folder, ensure that the folder does not contain members or subfolders.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
resourcemanager:DeleteFolder |
delete |
*Folder
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| FolderId |
string |
Yes |
The folder ID. |
fd-ae1in7**** |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response result. |
||
| RequestId |
string |
The request ID. |
9B34724D-54B0-4A51-B34D-4512372FE1BE |
Examples
Success response
JSON format
{
"RequestId": "9B34724D-54B0-4A51-B34D-4512372FE1BE"
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | MissingParameter.FolderId | You must specify FolderId. | The FolderId parameter is not configured. Configure this parameter. |
| 400 | InvalidParameter.FolderId | The FolderId is invalid. | The value of the FolderId 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. |
| 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 account is not used to enable a resource directory. Use the account to enable a resource directory first. |
| 404 | EntityNotExists.Folder | The resource directory folder does not exist. | The specified folder does not exist. Create such a folder first. |
| 409 | DeleteConflict.Folder.SubFolder | This folder has sub folders. | The folder contains subfolders. Delete the subfolders first. |
| 409 | DeleteConflict.Folder.Account | This folder has accounts. | One or more members exist in the folder. Remove the members first. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.