Getting Role List

Last updated: 2020-06-05 19:09:18

    Note:

    This is a legacy API which has been hidden and will no longer be updated. We recommend using the new CAM API 3.0 which is standardized and faster.

    API Description

    This API (DescribeRoleList) is used to obtain the details of a specified role.
    Request domain name: cam.api.qcloud.com

    Input Parameters

    The following request parameter list only provides the AP request parameters. Other parameters can be found in Common Request Parameters.

    Parameter Name Required Type Description
    page Yes int Page number, starting from 1.
    rp Yes int Page size, which cannot be greater than 200.

    Output Parameters

    Parameter Name Type Description
    totalNum int Total number of roles under this owner
    list Array Role list

    The following information is displayed for each role in the list field.

    Parameter Name Type Description
    roleId string Role ID
    roleName String Role name
    policyDocument String Trust policy of the role
    description String Role description
    addTime String Creation time of the role
    updateTime String Last modified time of the role

    Example

    Input

    https://cam.api.qcloud.com/v2/index.php?Action=DescribeRoleList&page=1&rp=10&<Common request parameters>

    Output

    {
        "code": 0,
        "message": "",
        "codeDesc": "Success",
        "data": {
            "totalNum": 2,
            "list": [
                {
                    "roleId": "4611686018427397919",
                    "roleName": "testroleName001",
                    "policyDocument": "{\"version\":\"2.0\",\"statement\":[{\"action\":\"name/sts:AssumeRole\",\"effect\":\"allow\",\"principal\":{\"qcs\":[\"qcs::cam::uin/888888888:root\"]}}]}",
                    "description": "",
                    "addTime": "2017-09-26 11:02:21",
                    "updateTime": "2017-09-26 11:02:21"
                },
                {
                    "roleId": "4611686018427397919",
                    "roleName": "testroleName002",
                    "policyDocument": "{\"version\":\"2.0\",\"statement\":[{\"action\":\"name/sts:AssumeRole\",\"effect\":\"allow\",\"principal\":{\"qcs\":[\"qcs::cam::uin/12345678:root\"]}}]}",
                    "description": "",
                    "addTime": "2017-09-25 15:19:29",
                    "updateTime": "2017-09-25 15:19:29"
                }
            ]
        }
    }

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help