创建角色

最近更新时间:2019-11-25 14:34:55

接口描述

本接口(CreateRole)用于创建角色。
请求域名:cam.api.qcloud.com

输入参数

以下请求参数列表仅列出了接口请求参数,未列出 公共请求参数

字段 是否必选 类型 描述
policyDocument string 策略文档,示例:{"version":"2.0","statement":[{"action":"name/sts:AssumeRole","effect":"allow","principal":{"service":["cloudaudit.cloud.tencent.com","cls.cloud.tencent.com"]}}]},principal用于指定角色的授权对象。获取该参数可参阅 获取角色详情(https://cloud.tencent.com/document/product/598/36221) 输出参数RoleInfo
description string 角色描述
roleName string 角色名

输出参数

字段 类型 描述
roleId string 角色 ID

示例

输入

https://cam.api.qcloud.com/v2/index.php?Action=CreateRole&roleName=testroleName
&policyDocument=%7B%22version%22%3A%222.0%22%2C%22statement%22%3A%5B%7B%22action%22%3A%22name%2Fsts%3AAssumeRole%22%2C%22effect%22%3A%22allow%22%2C%22principal%22%3A%7B%22qcs%22%3A%5B%22qcs%3A%3Acam%3A%3Auin%12345678%3Aroot%22%5D%7D%7D%5D%7D&<公共请求参数>

其中 policyDocument 字段值是:
{"version":"2.0","statement":[{"action":"name/sts:AssumeRole","effect":"allow","principal":{"qcs":["qcs::cam::uin/12345678:root"]}}]}

输出

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "data": {
        "roleId": "4611686018427397919"
    }
}