查询账号的角色列表

最近更新时间:2017-12-21 21:18:02

查询账号的角色列表(ListRoles)

概述

查询本账号内已创建的角色列表信息。金山云账号或被授权的子用户可以调用该接口。

如果PathPrefix参数为空,默认为/ ,列出所有的角色。

openAPI接口

请求参数
名称 类型 必须 长度限制(字符) 参数格式 描述
Action String ListRoles action名称
Marker String 最短1,最长320 [:graph:]+ 当返回结果被截断时,使用本次返回的Marker值用于标示下次调用查询操作的起始点,Marker值不会过期
MaxItems Integer 最小值1,最大值1000,默认100 用于限制本次查询结果返回的数量,如果仍有额外元素未显示,则返回元素中的IsTruncated的值会被设置为true,同时返回下次查询的起始点Marker值
PathPrefix String 最短1,最长512 ((/[A-Za-z0-9\.,\+@=_-]+)*)/ 可选参数,用于过滤列表,如果未传入则默认值是/
返回元素(调用成功)
名称 类型 描述
IsTruncated Boolean 截断标志位,用于说明是否仍有更多的元素未显示全
Marker String 如果截断标志位是true,Marker值被设定,用于标识下次查询的起始点
Roles.member List 角色列表

错误码(调用不成功)

错误代码 描述 HTTP 状态码 语义
InvalidParameterValue An invalid or out-of-range value was supplied for the input parameter. 400 参数格式/取值范围不对,具体参数名在错误消息中说明
示例(调用成功)
请求示例
https://iam.cn-beijing-6.api.ksyun.com/?Action=ListRoles
&MaxItems=100
&Version=2015-11-01
&AUTHPARAMS
返回示例
  • XML示例
<ListRolesResponse>
<ListRolesResult>
  <IsTruncated>false</IsTruncated>
   <Roles>
    <member>
      <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>
    </member>
    </Roles>
</ListRolesResult>
<ResponseMetadata>
  <RequestId>20f7279f-99ee-11e1-a4c3-27EXAMPLE804</RequestId>
</ResponseMetadata>
</ListRolesResponse>

返回角色管理一览表

金山云,开启您的云计算之旅

注册有礼