查询账号的角色列表

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

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

请求参数

名称	类型	必须	长度限制(字符)	参数格式	描述
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\.,\[email protected]=_-]+)*)/	可选参数，用于过滤列表，如果未传入则默认值是/

返回元素（调用成功）

名称	类型	描述
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>