Cloud Services API ReferenceGeneral ServiceIdentity and Access ManagementPermission ManagementQuery Sub-Permissions

Query Sub-Permissions

Last Updated on : 2023-10-09 08:09:18download

Based on the permission ID, query the list of sub-permissions that are linked with the specified permission.

API address

GET: /v2.0/cloud/iam/permission/{permission_id}/item

Request parameter

Parameter name	Type	IN	Required	Description
permission_id	Long	uri	true	The ID of the specified permission.
last_row_key	Long	query	false	The starting ID of the query.
page_size	Integer	query	false	The number of items returned on each page.

Return parameter

Parameter name	Type	Description
success	Boolean	Indicates whether the operation is successful. Valid values: `true`: The operation succeeded. `false`: The operation failed.
error_code	String	The error code. For more information, see the error codes.
error_msg	String	The message that is returned if the request fails. It is empty if the request is successful.
result	QueryResourceAndPolicyListByPermissionRes	The returned result.

Description of result

Parameter name	Type	Description
permission_id	Long	The ID of the specified permission.
permission_item_list	List	The list of sub-permissions.
last_row_key	Long	The starting ID of the query.
page_size	Integer	The number of items returned on each page.

Description of permission_item_list

Parameter name	Type	Description
item_id	Long	The ID of the specified sub-permission.
policy_id	Long	The ID of the specified policy.
policy_name	String	The name of the specified policy.
resource_id	String	The ID of the specified resource.
resource_type	Integer	The type of the specified resource. Valid values: `1`: space resource. `2`: device resource. `11`: global resource type.
item_type	Integer	The type of the specified sub-permission. Valid values: `1`: The space contains subgroups. `0`: The space does not contain subgroups.

Request example

GET: /v2.0/cloud/iam/permission/1/item?lastRowKey=0&pageSize=100

Return example

{
    "tid": "195bceee56b411ee801ef25dabf95fef",
    "result": {
        "last_row_key": 181044,
        "permission_item_list": [
            {
                "policy_id": 110001,
                "item_id": 232371810,
                "item_type": 0,
                "resource_type": 11,
                "resource_id": "*"
            }
        ],
        "permission_id": 181044,
        "page_size": 10
    },
    "t": 1695104201504,
    "success": true
}

Error code

For more information, see error code.

Prev DocLink User with Permission

Next DocUnlink Sub-Permission