查询本账号内已创建的角色列表信息。金山云账号或被授权的子用户可以调用该接口。
如果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\.,\+@=_-]+)*)/ |
可选参数，用于过滤列表，如果未传入则默认值是/ |
返回元素（调用成功）
| 名称 | 类型 | 描述 |
|---|---|---|
| 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>
文档内容是否对您有帮助？
根本没帮助
文档较差
文档一般
文档不错
文档很好
在文档使用中是否遇到以下问题
内容不全，不深入
内容更新不及时
描述不清晰，比较混乱
系统或功能太复杂，缺乏足够的引导
内容冗长
更多建议
0/200
评价建议不能为空
提交成功！
非常感谢您的反馈，我们会继续努力做到更好！