接口描述
本接口（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"
}
}