ListResourceGroupsWithAuthDetails API Overview - Resource Management

Queries resource groups and their user authorization information.

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
Status	string	No	The status of the resource group. This parameter specifies a filter condition for the query. 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
PageNumber	integer	No	The page number of the returned page.	1
PageSize	integer	No	The number of entries returned per page.	10
DisplayName	string	No	The display name of the resource group. This parameter specifies a filter condition for the query. Fuzzy search is supported. The display name can be a maximum of 50 characters in length.	TestRG-BVT1
Name	string	No	The identifier of the resource group. This parameter specifies a filter condition for the query. Fuzzy search is supported. The identifier can be a maximum of 50 characters in length and can contain letters, digits, and hyphens (-).	prod-rg
Tag	array<object>	No	The tags.
	object	No	The tag.
Key	string	No	The tag key.	k1
Value	string	No	The tag value.	v1
IncludeTags	boolean	No	Specifies whether to return the information of tags. Valid values: false (default) true Note If you set a tag filter condition, the tag information is returned regardless of the `IncludeTags` value.	true
ResourceGroupIds	array	No	The IDs of the resource groups that you want to query.
	string	No	The IDs of the resource groups that you want to query.	rg-acfm3uwewyefzuy
ResourceTypes	array<object>	No	The resource types.
	object	No	The resource types.
ResourceTypeCode	string	No	The resource type. You can obtain the resource type from the Resource type column in Services that work with Resource Group.	instance
Service	string	No	The service code. You can obtain the code from the Service code column in Services that work with Resource Group.	ecs
ResourceRegionId	string	No	The ID of the region where the resource resides.	cn-shenzhen

Response parameters

Parameter	Type	Description	Example
	object	The response parameters.
AuthDetails	array<object>	The authorization details for resource groups.
AuthDetail	object	The authorization details for a type of resource groups.
AccountScopeAuth	boolean	Indicates whether the user has account-level authorization for this resource type.
AuthOfResourceGroups	array<object>	The permission details for the resource groups on the specified resource types.
AuthOfResourceGroup	object	The permission details for the resource groups on the specified resource type.
HasPermission	boolean	Indicates whether the user has permissions on the resource group for the specified resource type.	true
ResourceGroupId	string	The resource group ID.	rg-aekzscexx6w3u2y
ResourceType	string	The resource type. You can obtain the resource type from the Resource type column in Services that work with Resource Group.	instance
Service	string	The ID of the Alibaba Cloud service. You can obtain the ID from the Service code column in Services that work with Resource Group.	ecs
PageNumber	integer	The page number.	1
PageSize	integer	The number of entries returned per page.	10
RequestId	string	The response parameters.	4141780B-4E3D-5D2A-A8F4-44D6D34F****
ResourceGroups	array<object>	The information of the resource groups.
ResourceGroup	object	The information about a resource group.
AccountId	string	The ID of the Alibaba Cloud account to which the resource group belongs.	123456789****
CreateDate	string	The time when the resource group was created. The time is displayed in UTC.	2015-01-23T12:33:18Z
DisplayName	string	The display name of the resource group.	my-project
Id	string	The ID of your Alibaba Cloud resource group.	rg-9gLOoK****
Name	string	The unique identifier 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
Tags	array<object>	The tags.
Tag	object	The tags.
TagKey	string	The tag key.	k1
TagValue	string	The tag value.	v1
TotalCount	integer	The total number of entries returned.	10

Examples

Sample success responses

JSONformat

{
  "AuthDetails": [
    {
      "AccountScopeAuth": true,
      "AuthOfResourceGroups": [
        {
          "HasPermission": true,
          "ResourceGroupId": "rg-aekzscexx6w3u2y"
        }
      ],
      "ResourceType": "instance",
      "Service": "ecs"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "RequestId": "4141780B-4E3D-5D2A-A8F4-44D6D34F****",
  "ResourceGroups": [
    {
      "AccountId": "123456789****",
      "CreateDate": "2015-01-23T12:33:18Z",
      "DisplayName": "my-project",
      "Id": "rg-9gLOoK****",
      "Name": "my-project",
      "Status": "OK",
      "Tags": [
        {
          "TagKey": "k1",
          "TagValue": "v1"
        }
      ]
    }
  ],
  "TotalCount": 10
}

Error codes

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

Change history

Change time	Summary of changes	Operation
2025-12-10	Add Operation	View Change Details