全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
访问控制

GetPolicy

更新时间:2017-06-07 13:26:11

接口描述

 获取指定的授权策略信息

请求参数

Action

  • 类型:String
  • 必须:是
  • 描述:系统规定参数,取值:GetPolicy

PolicyType

  • 类型:String
  • 必须:是
  • 描述:指定Policy的类型, 取值System或Custom

PolicyName

  • 名称:PolicyName
  • 类型:String
  • 必须:是
  • 描述:指定授权策略名称

返回参数

Policy

  • 类型:Policy Type
  • 描述:授权策略的基本信息

需要的权限

Action

ram:GetPolicy

Resource

acs:ram:*:${AccountId} or system:policy/${PolicyName}

错误信息

InvalidParameter.PolicyType
  • HTTP Status:400
  • Error Message:The parameter - "PolicyType" is incorrect.
InvalidParameter.PolicyName.InvalidChars
  • HTTP Status:400
  • Error Message:The parameter - "PolicyNam" contains invalid chars.
InvalidParameter.PolicyName.Length
  • HTTP Status:400
  • Error Message:The parameter - "PolicyName" beyond the length limit.
EntityNotExist.Policy
  • HTTP Status:404
  • Error Message:The policy does not exist.

操作示例

请求示例

https://ram.aliyuncs.com/?Action=GetPolicy
&PolicyName=OSS-Administrator
&<公共请求参数>

返回示例

XML格式

<GetPolicyResponse>
    <RequestId>697852FB-50D7-44D9-9774-530C31EAC572</RequestId>
    <Policy>
        <PolicyName>OSS-Administrator</PolicyName>
        <PolicyType>Custom</PolicyType>
        <Description>OSS管理员权限</Description>
        <DefaultVersion>v1</DefaultVersion>
        <CreateDate>2015-01-23T12:33:18Z</CreateDate>
        <UpdateDate>2015-01-23T12:33:18Z</UpdateDate>
        <AttachmentCount>0</AttachmentCount>
    </Policy>
</GetPolicyResponse>

JSON格式

{
    "RequestId": "697852FB-50D7-44D9-9774-530C31EAC572",
    "Policy": {
        "PolicyName": "OSS-Administrator",
        "PolicyType": "Custom",
        "Description": "OSS管理员权限",
        "DefaultVersion": "v1",
        "CreateDate": "2015-01-23T12:33:18Z",
        "UpdateDate": "2015-01-23T12:33:18Z",
        "AttachmentCount": 0
    }
}
本文导读目录