创建角色(CreateRole)
概述
创建角色。金山云账号或被授权的子用户可以调用该接口。
创建Role需要提供信任账号列表,以逗号分隔.
注:一个账号下最多拥有100个Role
openAPI接口
请求参数
名称 |
类型 |
必须 |
长度限制(字符) |
参数格式 |
描述 |
Action |
String |
是 |
|
CreateRole |
action名称 |
RoleName |
String |
是 |
最短1,最长64 |
[\w+=,[email protected]]+ |
|
TrustAccounts |
String |
是 |
最短1,最长1000 |
|
信任账号列表(多个账号之间使用半角逗号(,)分隔,最多可以有20个账号) |
Path |
String |
否 |
最短:1,最长:512 |
\/ or \/[:graph:]+\/ |
默认是/,该字段暂未支持,一律处理为 '/' |
Description |
String |
否 |
最短:1,最长:128 |
|
默认是空字符串 |
返回元素(调用成功)
错误码(调用不成功)
错误代码 |
描述 |
HTTP 状态码 |
语义 |
MissingParameter |
A required parameter for the specified action is not supplied. |
400 |
忘记输入参数,具体参数名在错误消息中说明(RoleName) |
InvalidParameterValue |
An invalid or out-of-range value was supplied for the input parameter. |
400 |
参数格式/取值范围不对,具体参数名在错误消息中说明(RoleName) |
LimitExceeded |
The request was rejected because it attempted to create resources beyond the current Ksyun account limits |
409 |
资源数量超过限制,具体限制在错误消息中说明 |
EntityAlreadyExists |
The request was rejected because it attempted to create a resource that already exists |
409 |
资源已经存在,具体实体名称在错误消息中说明 |
示例(调用成功)
请求示例
https://iam.cn-beijing-6.api.ksyun.com/?Action=CreateRole
&RoleName=roleTest
&TrustAccounts=123123,456456,789679
&Version=2015-11-01
&AUTHPARAMS
返回示例
<CreateRoleResponse>
<CreateRoleResult>
<Role>
<Path>/ksc/iam/</Path>
<Krn>krn:kcs:iam::213:role/ksc/iam/roleTest</Krn>
<RoleName>roleTest</RoleName>
<Description>这个一个测试使用的Role</Description>
<TrustAccounts>123123,456456,789679</TrustAccounts>
<CreateDate>2017-02-08T23:34:01.495Z</CreateDate>
<RoleId>AROADBQP57FF2AEXAMPLE</RoleId>
</Role>
</CreateRoleResult>
<ResponseMetadata>
<RequestId>4a93ceee-9966-11e1-b624-b1aEXAMPLE7c</RequestId>
</ResponseMetadata>
</CreateRoleResponse>