Creates a resource group.
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | CreateResourceGroup |
The operation that you want to perform. Set the value to CreateResourceGroup. |
DisplayName | String | Yes | my-project |
The display name of the resource group. The name must be 1 to 30 characters in length and can contain letters, digits, and hyphens (-). |
Name | String | Yes | my-project |
The unique identifier of the resource group. The identifier must be 3 to 12 characters in length and can contain letters, digits, and hyphens (-). The identifier must start with a letter. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 04F0F334-1335-436C-A1D7-6C044FE73368 |
The ID of the request. |
ResourceGroup | Struct |
The information of the resource group. |
|
AccountId | String | 123456789**** |
The ID of the Alibaba Cloud account to which the resource group belongs. |
CreateDate | String | 2015-01-23T12:33:18Z |
The time when the resource group was created. |
DisplayName | String | my-project |
The display name of the resource group. |
Id | String | rg-9gLOoK**** |
The ID of the resource group. |
Name | String | my-project |
The unique identifier of the resource group. |
RegionStatuses | Array of RegionStatus |
The status of the resource group in all regions. |
|
RegionStatus | |||
RegionId | String | cn-qingdao |
The region ID. |
Status | String | Creating |
The status of the resource group. Valid values:
|
Status | String | Creating |
The status of the resource group. Valid values:
|
Examples
Sample requests
https://resourcemanager.aliyuncs.com/?Action=CreateResourceGroup
&Name=my-project
&DisplayName=my-project
&<Common request parameters>
Sample success responses
XML
format
<CreateResourceGroupResponse>
<RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
<ResourceGroup>
<Id>rg-9gLOoK****</Id>
<AccountId>123456789****</AccountId>
<Name>my-project</Name>
<DisplayName>my-project</DisplayName>
<Status>Creating</Status>
<RegionStatuses>
<RegionStatus>
<RegionId>cn-hangzhou</RegionId>
<Status>OK</Status>
</RegionStatus>
<RegionStatus>
<RegionId>cn-qingdao</RegionId>
<Status>Creating</Status>
</RegionStatus>
</RegionStatuses>
<CreateDate>2015-01-23T12:33:18Z</CreateDate>
</ResourceGroup>
</CreateResourceGroupResponse>
JSON
format
{
"RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
"ResourceGroup": {
"Id": "rg-9gLOoK****",
"AccountId": "123456789****",
"Name": "my-project",
"DisplayName": "my-project",
"Status": "Creating",
"RegionStatuses":{
"RegionStatus":[
{
"RegionId":"cn-hangzhou",
"Status":"OK"
},
{
"RegionId":"cn-qingdao",
"Status":"Creating"
}
]
},
"CreateDate": "2015-01-23T12:33:18Z"
}
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | InvalidParameter.Name.InvalidChars | The specified resource group name is invalid. The name must be 1 to 30 characters in length and can contain letters and digits. | The error message returned because the resource group name is invalid. The name must be 1 to 30 characters in length and can contain letters and digits. |
400 | InvalidParameter.Name.Length | The maximum length of Name is exceeded. | The error message returned because the length of the value specified for the Name parameter has exceeded the upper limit. |
400 | InvalidParameter.DisplayName.Length | The maximum length of DisplayName is exceeded. | The error message returned because the length of the value specified for the DisplayName parameter has exceeded the upper limit. |
409 | LimitExceeded.ResourceGroup | Failed to create the resource group because the maximum number of resource groups is exceeded. You can create a maximum of 30 resource groups. | The error message returned because the number of resource groups has exceeded the upper limit. A maximum of 30 resource groups can be created. |
400 | MissingParameter.DisplayName | You must specify DisplayName. | The error message returned because the DisplayName parameter is not specified. |
400 | InvalidParameter.DisplayName | The DisplayName is invalid. | The error message returned because the value of the DisplayName parameter is invalid. |
For a list of error codes, visit the API Error Center.