GetResourceGroup - Resource Management - Alibaba Cloud Documentation Center

Queries the information of a resource group.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
ResourceGroupId	string	Yes	The ID of the resource group. You can call the ListResourceGroups operation to obtain the ID of the resource group.	rg-9gLOoK****
IncludeTags	boolean	No	Specifies whether to return the information of tags. Valid values: false (default value) true	true

Response parameters

Parameter	Type	Description	Example
	object
RequestId	string	The ID of the request.	2D69A58F-345C-4FDE-88E4-BF5189484043
ResourceGroup	object	The information of the resource group.
DisplayName	string	The display name of the resource group.	my-project
Status	string	The status of the resource group. Valid values: Creating: The resource group is being created. OK: The resource group is created. PendingDelete: The resource group is waiting to be deleted.	OK
RegionStatuses	array<object>	The status of the resource group in all regions.
RegionStatus	object
Status	string	The status of the resource group. Valid values: Creating: The resource group is being created. OK: The resource group is created. PendingDelete: The resource group is waiting to be deleted. Deleting: The resource group is being deleted.	OK
RegionId	string	The region ID.	cn-qingdao
AccountId	string	The ID of the Alibaba Cloud account to which the resource group belongs.	123456789****
Name	string	The 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:18Z
Id	string	The ID of the resource group.	rg-9gLOoK****
Tags	array<object>	The tags that are added to the resource group.
Tag	object	The tags that are added to the resource group.
TagKey	string	The tag key.	k1
TagValue	string	The tag value.	v1

Examples

Sample success responses

JSONformat

{
  "RequestId": "2D69A58F-345C-4FDE-88E4-BF5189484043",
  "ResourceGroup": {
    "DisplayName": "my-project",
    "Status": "OK",
    "RegionStatuses": {
      "RegionStatus": [
        {
          "Status": "OK",
          "RegionId": "cn-qingdao"
        }
      ]
    },
    "AccountId": "123456789****",
    "Name": "my-project",
    "CreateDate": "2015-01-23T12:33:18Z",
    "Id": "rg-9gLOoK****",
    "Tags": {
      "Tag": [
        {
          "TagKey": "k1",
          "TagValue": "v1"
        }
      ]
    }
  }
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidParameter.ResourceGroupId	The ResourceGroupId is invalid.	The resource group ID is invalid.
403	NoPermission	You are not authorized to perform the operation.	You are not authorized to perform the operation.
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.

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

Change history

Change time	Summary of changes	Operation

No change history