All Products
Search
Document Center

Resource Management:UpdateResourceGroup

Last Updated:Aug 28, 2026

Updates the basic information of a resource group.

Operation description

This example changes the display name of resource group rg-9gLOoK**** to project.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

ResourceGroupId

string

Yes

The ID of the resource group.

Call the ListResourceGroups operation to obtain the ID.

rg-9gLOoK****

NewDisplayName

string

Yes

The display name of the resource group.

The name must be 1 to 50 characters in length.

project

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

Response elements

Element

Type

Description

Example

object

RequestId

string

The ID of the request.

04F0F334-1335-436C-A1D7-6C044FE73368

ResourceGroup

object

The resource group details.

DisplayName

string

The display name of the resource group.

project

AccountId

string

The ID of the Alibaba Cloud account to which the resource group belongs.

123456789****

Name

string

The unique identifier of the resource group.

my-project

CreateDate

string

The time when the resource group was created. The time is displayed in UTC.

2015-01-23T12:33:18+08:00

Id

string

The ID of the resource group.

rg-9gLOoK****

Examples

Success response

JSON format

{
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  "ResourceGroup": {
    "DisplayName": "project",
    "AccountId": "123456789****",
    "Name": "my-project",
    "CreateDate": "2015-01-23T12:33:18+08:00",
    "Id": "rg-9gLOoK****"
  }
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidParameter.ResourceGroupId The ResourceGroupId is invalid. The resource group ID is invalid.
400 InvalidParameter.DisplayName The DisplayName is invalid. The DisplayName is invalid.
400 MissingParameter.DisplayName You must specify DisplayName. You must specify the parameter DisplayName.
400 InvalidParameter.DisplayName.Length The maximum length of DisplayName is exceeded. The maximum length of DisplayName is exceeded.
404 EntityNotExists.ResourceGroup The specified resource group does not exist. You must first create a resource group. The specified resource group does not exist. You must first create a resource group.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.