请求参数
名称 |
类型 |
必须 |
长度限制(字符) |
参数格式 |
描述 |
Action |
String |
是 |
确定值 |
[a-zA-Z]+ |
操作接口名,系统规定参数,取值:ListPolicies |
Marker |
String |
否 |
最短1,最长320 |
[:graph:]+ |
当返回结果被截断时,使用本次返回的Marker值用于标示下次调用查询策略信息列表操作的起始点 |
MaxItems |
Integer |
否 |
最小值1,最大值1000,默认100 |
|
用于限制本次查询结果返回的策略数量,如果仍有额外策略未显示,则返回元素中的IsTruncated的值会被设置为true,同时返回下次查询的起始点Marker值 |
OnlyAttached |
Boolean |
否 |
|
|
可选参数,用于过滤策略列表,如果设置则只返回已经附加到实体上策略 |
PathPrefix |
String |
否 |
最短1,最长512 |
/ |
可选参数,用于过滤策略列表,如果未传入则默认值是/ |
Scope |
String |
否 |
3或5 |
ALL|KSC|Local |
用于过滤显示策略范围,ALL为全部,KSC是系统策略、Local是自定义策略 |
返回元素(调用成功)
名称 |
类型 |
描述 |
Policies |
PolicyType List |
被查询策略的元数据信息列表 |
IsTruncated |
Boolean |
截断标志位,用于说明是否仍有更多的策略信息未显示全 |
Marker |
String |
如果截断标志位是true,Marker值被设定,用于标识下次查询的起始点 |
错误码(调用不成功)
错误代码(Code) |
错误消息(Message) |
HTTP 状态码 |
中文描述(语义) |
InvalidParameterValue |
An invalid or out-of-range value was supplied for the input parameter %s. |
400 |
输入参数 %s的值无效、不合法或者超出范围,具体参数名在%s说明 |
示例(调用成功)
请求示例
https://iam.api.ksyun.com/?Action=ListPolicies&公共请求参数
返回示例
<ListPoliciesResponse>
<ListPoliciesResult>
<Marker/>
<IsTruncated>false</IsTruncated>
<Policies>
<member>
<PolicyId>4Ym5BEkcT4awlk3OdIIQ_A</PolicyId>
<DefaultVersionId>v1</DefaultVersionId>
<UpdateDate>2016-05-16T17:30:43.000Z</UpdateDate>
<AttachmentCount>0</AttachmentCount>
<Description/>
<Path>/</Path>
<CreateDate>2016-05-16T17:30:43.000Z</CreateDate>
<Krn>krn:ksc:iam::73407420:policy/IAMadmin</Krn>
<PolicyName>IAMadmin</PolicyName>
</member>
<member>
<PolicyId>eCuWLaNkTp6Pjv3j348tNw</PolicyId>
<DefaultVersionId>v1</DefaultVersionId>
<UpdateDate>2016-05-16T17:43:32.000Z</UpdateDate>
<AttachmentCount>0</AttachmentCount>
<Description/>
<Path>/</Path>
<CreateDate>2016-05-16T17:43:32.000Z</CreateDate>
<Krn>krn:ksc:iam::73407420:policy/IAMadmin1</Krn>
<PolicyName>IAMadmin1</PolicyName>
</member>
</Policies>
</ListPoliciesResult>
<ResponseMetadata>
<RequestId>bf3c3c28-0576-4e9d-a8d8-bff28f75aeea</RequestId>
</ResponseMetadata>
</ListPoliciesResponse>
{
"ListPoliciesResult": {
"Policies": {
"member": [
{
"PolicyId": "4Ym5BEkcT4awlk3OdIIQ_A",
"DefaultVersionId": "v1",
"UpdateDate": "2016-05-16T17:30:43.000Z",
"AttachmentCount": "0",
"Path": "/",
"CreateDate": "2016-05-16T17:30:43.000Z",
"Krn": "krn:ksc:iam::73407420:policy/IAMadmin",
"PolicyName": "IAMadmin"
},
{
"PolicyId": "eCuWLaNkTp6Pjv3j348tNw",
"DefaultVersionId": "v1",
"UpdateDate": "2016-05-16T17:43:32.000Z",
"AttachmentCount": "0",
"Path": "/",
"CreateDate": "2016-05-16T17:43:32.000Z",
"Krn": "krn:ksc:iam::73407420:policy/IAMadmin1",
"PolicyName": "IAMadmin1"
}
]
},
"IsTruncated": false
},
"ResponseMetadata": {
"RequestId": "caa91c07-c0ab-4ec0-9a30-556c657bfc60"
}
}