查询策略版本内容

最近更新时间:2017-12-21 21:16:45

查询策略版本内容(GetPolicyVersion)

描述

查询指定策略的特定策略版本的内容

注1:金山云账户能够查询自定义策略和系统策略的策略版本内容。

返回API概览

请求参数

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

返回元素(调用成功)

名称 类型 描述
PolicyVersion PolicyVersionType 查询的策略版本的信息
错误码(调用不成功)
错误代码(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=GetPolicyVersion
&PolicyKrn=krn:ksc:iam::12345678901234567890:policy/IAMadmin
&VersionId=v1
&公共请求参数
返回示例
  • XML格式
<GetPolicyVersionResponse>
    <GetPolicyVersionResult>
        <PolicyVersion>
            <IsDefaultVersion>true</IsDefaultVersion>
            <VersionId>v1</VersionId>
            <CreateDate>2016-05-16T17:43:32.000Z</CreateDate>
            <Document>{"Version":"2015-11-01","Statement":[{"Effect":"Allow","Action":"iam:*", "Resource":"*"}]}</Document>
        </PolicyVersion>
    </GetPolicyVersionResult>
    <ResponseMetadata>
        <RequestId>4c8e4c8a-ab39-43c5-86cf-553f9b97bc69</RequestId>
    </ResponseMetadata>
</GetPolicyVersionResponse>
  • JSON示例
{
  "GetPolicyVersionResult": {
    "PolicyVersion": {
      "IsDefaultVersion": "true",
      "VersionId": "v1",
      "Document": "{\"Version\":\"2015-11-01\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":\"iam:*\", \"Resource\":\"*\"}]}",
      "CreateDate": "2016-05-16T17:43:32.000Z"
    }
  },
  "ResponseMetadata": {
    "RequestId": "6ba774b0-819c-4d2c-ad7a-10d70625e9bf"
  }
}

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

注册有礼