查询所有角色组。

请求参数

参数 类型 描述 是否必选

action

String

DescribeGroupRoles（查询所有角色组）

true

zone

String

区域 id

false

project_id

String

项目 id

true

offset

Integer

数据偏移量，默认为 0

false

limit

Integer

返回数据长度，默认为 20，最大为 100

false

响应消息

参数 条目 类型 描述

action

-

String

DescribeGroupRolesResponse

total_count

-

Integer

根据过滤条件得到的角色组总数

ret_code

-

Integer

执行成功与否，0 表示成功，其他值则为错误代码

group_role_set

-

Array

被更新的角色组描述

-

read_only

Integer

自定义与系统默认，0 表示自定义可编辑，1 表示系统默认不可编辑

-

status

String

启用状态，enabled 表示启用，disabled 表示未启用状态

-

description

String

就是描述

-

group_role_id

String

角色组 id

-

status_time

TimeStamp

角色组更新时间

-

create_time

TimeStamp

角色组创建时间

-

iamg_role_id

String

IAM 组身份 id

-

group_role_name

String

角色组名称

-

role_type

String

角色类型

示例

请求示例

https://api.qingcloud.com/iaas/?zone=test&project_id=pj-xzvlxlb5&action=DescribeGroupRoles&offset=0&limit=100

响应示例

“{
    "action": "DescribeGroupRolesResponse",
    "total_count": 2,
    "group_role_set": [
        {
            "read_only": 1,
            "status": "enabled",
            "description": "test",
            "group_role_id": "gr-5590xkq2",
            "status_time": "2021-12-27T02:54:35Z",
            "create_time": "2021-12-27T02:54:35Z",
            "iamg_role_id": null,
            "group_role_name": "test",
            "role_type": "rule"
        },
        {
            "read_only": 0,
            "status": "enabled",
            "description": "",
            "group_role_id": "gr-blph1xfg",
            "status_time": "2021-12-27T02:54:01Z",
            "create_time": "2021-12-27T02:54:01Z",
            "iamg_role_id": null,
            "group_role_name": "a",
            "role_type": "rule"
        }
    ],
    "ret_code": 0
}”

查询单个角色组

请求参数

参数 类型 描述 是否必选

action

String

DescribeGroupRoles（查询单个角色组）

true

status

Array

启用状态

false

verbose

Integer

是否返回冗长的信息，若为 1，则返回已加入角色组的规则信息

false

group_roles

Array

角色组 id 列表

true

owner

String

所有者 id

true

zone

String

区域 id

false

project_id

String

项目 id

true

响应消息

参数 条目1 条目2 类型 描述

action

-

-

String

DescribeGroupRolesResponse

total_count

-

-

Integer

根据过滤条件得到的角色组总数

ret_code

-

-

Integer

执行成功与否，0 表示成功，其他值则为错误代码

group_role_set

-

-

Array

被更新的角色组描述

-

read_only

-

Integer

自定义与系统默认，0 表示自定义可编辑，1 表示系统默认不可编辑

-

status

-

String

启用状态，enabled 表示启用，disabled 表示未启用状态

-

description

-

String

就是描述

-

group_role_id

-

String

角色组 id

-

status_time

-

TimeStamp

角色组更新时间

-

create_time

-

TimeStamp

角色组创建时间

-

iamg_role_id

-

String

IAM 组身份 id

-

group_role_name

-

String

角色组名称

-

role_类型

-

String

角色类型

-

group_role_rule_set

-

Array

-

-

-

status

String

启用状态

-

-

description

String

规则描述

-

-

group_role_id

String

关联的角色组 id

-

-

root_user_id

String

所有者 root 用户 id

-

-

owner

String

所有者 id

-

-

console_id

String

控制台 id

-

-

iam_policy_id

String

IAM 策略 id

-

-

controller

String

控制器

-

-

create_time

String

创建时间

-

-

principle

Json

规则详情

-

-

policy

String

规则类型

-

-

status_time

TimeStamp

更新时间

-

-

group_role_rule_id

String

角色组规则 id

示例

请求示例

https://api.qingcloud.com/iaas/?status=[]
&verbose=1
&group_roles=["gr-5590xkq2"]
&action=DescribeGroupRoles
&owner=usr-WantwZJ8
&zone=test
&project_id=pj-xzvlxlb5

响应示例

{
    "action": "DescribeGroupRolesResponse",
    "total_count": 1,
    "group_role_set": [
        {
            "read_only": 0,
            "status": "enabled",
            "group_role_rule_set": [
                {
                    "status": "enabled",
                    "description": null,
                    "group_role_id": "gr-5590xkq2",
                    "root_user_id": "usr-WantwZJ8",
                    "owner": "usr-WantwZJ8",
                    "console_id": "alphacloud",
                    "iam_policy_id": "",
                    "controller": "self",
                    "create_time": "2021-12-27T10:54:35",
                    "principle": "",
                    "policy": "monitor.describe",
                    "status_time": "2021-12-27T10:54:35",
                    "group_role_rule_id": "grr-gevekekh"
                },
                {
                    "status": "enabled",
                    "description": null,
                    "group_role_id": "gr-5590xkq2",
                    "root_user_id": "usr-WantwZJ8",
                    "owner": "usr-WantwZJ8",
                    "console_id": "alphacloud",
                    "iam_policy_id": "",
                    "controller": "self",
                    "create_time": "2021-12-27T10:54:35",
                    "principle": "",
                    "policy": "all.describe",
                    "status_time": "2021-12-27T10:54:35",
                    "group_role_rule_id": "grr-tlq2l8tk"
                }
            ],
            "description": "test",
            "group_role_id": "gr-5590xkq2",
            "status_time": "2021-12-27T02:54:35Z",
            "create_time": "2021-12-27T02:54:35Z",
            "iamg_role_id": null,
            "group_role_name": "test",
            "role_type": "rule"
        }
    ],
    "ret_code": 0
}