查询策略元数据信息

最近更新时间:2017-12-21 21:18:00

查询策略元数据信息(GetPolicy)

描述

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

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

返回API概览

请求参数

名称 类型 必须 长度限制(字符) 参数格式 描述
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"
        }
    }
}

金山云,开启您的云计算之旅

注册有礼