查询本账号内已创建的角色列表信息。金山云账号或被授权的子用户可以调用该接口。
如果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
<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>
文档内容是否对您有帮助?
评价建议不能为空
非常感谢您的反馈,我们会继续努力做到更好!