创建角色(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		默认是空字符串

返回元素（调用成功）

名称	类型	描述
Role		新创建的角色基本信息

错误码（调用不成功）

错误代码	描述	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

返回示例

• XML示例

<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>

返回角色管理一览表