All Products
Search
Document Center

Resource Management:UpdateFolder

Last Updated:Jun 25, 2024

Changes the name of a folder.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
FolderIdstringYes

The ID of the folder.

fd-u8B321****
NewFolderNamestringYes

The new name of the folder.

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

rdFolder

Response parameters

ParameterTypeDescriptionExample
object

The returned result.

RequestIdstring

The ID of the request.

C2CBCA30-C8DD-423E-B4AD-4FB694C9180C
Folderobject

The information about the folder.

FolderIdstring

The ID of the folder.

fd-u8B321****
CreateTimestring

The time when the folder was created.

2019-02-19T09:34:50.757Z
ParentFolderIdstring

The ID of the parent folder.

r-b1****
FolderNamestring

The name of the folder.

rdFolder

Examples

Sample success responses

JSONformat

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

Error codes

HTTP status codeError codeError messageDescription
400MissingParameter.Folder.NameYou must specify the resource folder name.No folder name is specified. Specify a folder name.
400InvalidParameter.Folder.NameThe Name of folder is invalid.The folder name is invalid. The name can contain only letters, digits, underscores (_), periods (.), and hyphens (-).
400InvalidParameter.Folder.Name.LengthThe Name of folder exceeds the length limit.The length of the folder name exceeds the upper limit. The name must be 1 to 24 characters in length.
400MissingParameter.FolderIdYou must specify FolderId.The FolderId parameter is not configured. Configure this parameter.
400InvalidParameter.FolderIdThe 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.
400InvalidParameter.Folder.Name.AlreadyUsedThe name already exists under the same parent. Please change to another name.The folder name already exists in the same parent folder. Change the name.
404EntityNotExists.ResourceDirectoryThe 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.
404EntityNotExists.FolderThe resource directory folder does not exist.The specified folder does not exist. Create such a folder first.
409LimitExceeded.Folder.DepthThe folder depth exceeds the limit of 5.The maximum number of folder levels is reached. A maximum of five levels of folders can be created in the Root folder.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history