全部产品
Search
文档中心

资源管理:CreateResourceGroup - 创建资源组

更新时间:Aug 28, 2026

调用CreateResourceGroup创建资源组。

接口说明

说明

一个阿里云账号下最多创建 30 个资源组。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

Name

string

资源组唯一标识。

长度为 2~50 个字符,可包含英文字母、数字和短划线(-)。必须以英文字母开头。

my-project

DisplayName

string

资源组显示名称。

长度为 1~50 个字符或汉字。

my-project

Tag

array<object>

标签。

object

标签。

Key

string

标签键。

最多支持 128 个字符,不能以aliyunacs:开头,不能包含http://或者https://

k1

Value

string

标签值。

最多支持 128 个字符,不能以aliyunacs:开头,不能包含http://或者https://

v1

返回参数

名称

类型

描述

示例值

object

返回结果。

RequestId

string

请求 ID。

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

ResourceGroup

object

资源组信息。

AccountId

string

资源组所属的阿里云账号 ID。

151266687691****

CreateDate

string

资源组创建时间(UTC 时间)。

2021-06-05T14:39:13+08:00

DisplayName

string

资源组显示名称。

my-project

Id

string

资源组 ID。

rg-9gLOoK****

Name

string

资源组唯一标识。

my-project

RegionStatuses

object

RegionStatus

array<object>

各个地域的资源组状态。

object

各个地域的资源组状态。

RegionId

string

地域 ID。

cn-qingdao

Status

string

资源组状态。取值:

  • Creating:创建中。

  • OK:创建成功。

Creating

Status

string

资源组状态。取值:

  • Creating:创建中。

  • OK:创建成功。

Creating

示例

正常返回示例

JSON格式

{
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  "ResourceGroup": {
    "AccountId": "151266687691****",
    "CreateDate": "2021-06-05T14:39:13+08:00",
    "DisplayName": "my-project",
    "Id": "rg-9gLOoK****",
    "Name": "my-project",
    "RegionStatuses": {
      "RegionStatus": [
        {
          "RegionId": "cn-qingdao",
          "Status": "Creating"
        }
      ]
    },
    "Status": "Creating"
  }
}

错误码

HTTP status code

错误码

错误信息

描述

400 InvalidParameter.Name.InvalidChars The Name is invalid. 参数Name无效。
400 InvalidParameter.Name.Length The maximum length of Name is exceeded. 参数Name长度超出范围。
400 InvalidParameter.DisplayName.Length The maximum length of DisplayName is exceeded. 参数DisplayName长度超出范围。
400 MissingParameter.DisplayName You must specify DisplayName. 参数DisplayName缺失。
400 InvalidParameter.DisplayName The DisplayName is invalid. 参数DisplayName无效。
409 LimitExceeded.ResourceGroup The count of resource groups beyond the current limits. 资源组数量超出限制。

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情