Cloud Services API ReferenceGeneral ServiceIdentity and Access ManagementPermission ManagementQuery Permission Data

Query Permission Data

Last Updated on : 2023-10-09 08:06:21download

Based on the user ID, query the permission data linked with the specified user.

API address

GET: /v2.0/cloud/iam/permission/user/{user_id}

Request parameter

Parameter name	Type	IN	Required	Description
user_id	String	uri	true	The user ID.
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	QueryPermissionListByUserRes	The returned result.

Description of result

Parameter name	Type	Description
user_id	String	The user ID.
permission_list	List	The list of authorized 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_list

Parameter name	Type	Description
permission_id	Long	The ID of the specified permission.
name	String	The name of the specified permission.
description	String	The description of the specified permission.
type	Integer	The authorization type. Valid values: `0`: generic authorization. `1`: temporary authorization.
start_time	Long	The time when a temporary authorization takes effect. This field is only valid for temporary authorization.
end_time	Long	The time when a temporary authorization expires. This field is only valid for temporary authorization.
gmt_create	Long	The creation time.

Request example

GET: /v2.0/cloud/iam/permission/user/uid1?lastRowKey=0&pageSize=100

Return example

{
    "tid": "195bceee56b411ee801ef25dabf95fef",
    "result": {
        "last_row_key": 181044,
        "user_id": "uid1",
        "permission_list": [
            {
                "gmt_create": 1695104201,
                "description": "Description",
                "permission_id": 232371810,
                "type": "0",
                "name": "Permission name"
            }
        ],
        "page_size": 10
    },
    "t": 1695104201504,
    "success": true
}

Error code

For more information, see error code.

Prev DocUnlink User from Permission

Next DocQuery User List