查询策略元数据信息

查询主账号下指定策略的元数据信息。

注1：策略的元数据信息不包括策略授权文档的内容，如果需要查看策略授权文档内容，需要调用GetPolicyVersion接口；IAM系统内置的全局系统策略的元数据信息也可以被查询。

请求参数

名称	类型	必须	长度限制(字符)	参数格式	描述
Action	String	是	确定值	[a-zA-Z]+	操作接口名，系统规定参数，取值：GetPolicy
PolicyKrn	String	是	最短是25,最长2048	格式：krn:ksc:iam::account-id:policy/policy-name	待查询策略的唯一标识

返回元素（调用成功）

名称	类型	描述
Policy	PolicyType	被查询策略的元数据信息

错误码（调用不成功）

错误代码(Code)	错误消息(Message)	HTTP 状态码	中文描述（语义）
InvalidParameterValue	An value must be supplied for the input parameter %s.	400	输入参数%s的值不能为空，具体参数名在%s说明
InvalidParameterValue	An invalid or out-of-range value was supplied for the input parameter %s.	400	输入参数 %s的值无效、不合法或者超出范围，具体参数名在%s说明
PolicyNoSuchEntity	The request was rejected because it referenced ‘Policy’ that does not exist.	404	请求被拒绝，因其引用的“策略”不存在

示例（调用成功）

请求示例

https://iam.api.ksyun.com/?Action=GetPolicy
&PolicyKrn=krn:ksc:iam::12345678901234567890:policy/IAMadmin
&公共请求参数

返回示例

• XML格式

<GetPolicyResponse>
    <ResponseMetadata>
        <RequestId>c8b0eafa-80e5-4eb3-b1b8-00c5265cbce4</RequestId>
    </ResponseMetadata>
    <GetPolicyResult>
        <Policy>
            <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/IAMadmin</Krn>
            <PolicyName>IAMadmin</PolicyName>
        </Policy>
    </GetPolicyResult>
</GetPolicyResponse>

• JSON示例

{
    "ResponseMetadata": {
        "RequestId": "f07f9839-e89d-45f4-bc6c-de85a748aaab"
    },
    "GetPolicyResult": {
        "Policy": {
            "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/IAMadmin",
            "PolicyName": "IAMadmin"
        }
    }
}