GetPolicy获取权限策略信息-访问控制-阿里云-访问控制(RAM)-阿里云帮助中心

调用GetPolicy接口获取指定的权限策略信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ram:GetPolicy

get

Policy

acs:ram:*:system:policy/{#PolicyName}

Policy

acs:ram:*:{#accountId}:policy/{#PolicyName}

无

请求参数

名称	类型	必填	描述	示例值
PolicyType	string	否	指定权限策略的类型，取值为`System`或`Custom`。	Custom
PolicyName	string	否	指定权限策略名称。	OSS-Administrator

返回参数

名称	类型	描述	示例值
	object	返回参数。
Policy	object	权限策略的基本信息。
DefaultVersion	string	默认版本。	v1
UpdateDate	string	修改时间。	2015-01-23T12:33:18Z
Description	string	权限策略描述。	OSS管理员权限
PolicyDocument	string	已废弃。	N/A
AttachmentCount	integer	引用次数。	0
PolicyName	string	权限策略名称。	OSS-Administrator
CreateDate	string	创建时间。	2015-01-23T12:33:18Z
PolicyType	string	权限策略类型。	Custom
RequestId	string	请求 ID。	697852FB-50D7-44D9-9774-530C31EAC572
DefaultPolicyVersion	object	权限策略的默认版本。
IsDefaultVersion	boolean	`DefaultPolicyVersion`返回的数据结构固定为默认版本，因此`IsDefaultVersion`的取值固定为`true`。	true
PolicyDocument	string	权限策略内容。	{ "Statement": [{ "Action": ["oss:"], "Effect": "Allow", "Resource": ["acs:oss:::"]}], "Version": "1"}
VersionId	string	权限策略版本。	v1
CreateDate	string	创建时间。	2015-01-23T12:33:18Z

示例

正常返回示例

JSON格式

{
  "Policy": {
    "DefaultVersion": "v1",
    "UpdateDate": "2015-01-23T12:33:18Z",
    "Description": "OSS管理员权限",
    "PolicyDocument": "N/A",
    "AttachmentCount": 0,
    "PolicyName": "OSS-Administrator",
    "CreateDate": "2015-01-23T12:33:18Z",
    "PolicyType": "Custom"
  },
  "RequestId": "697852FB-50D7-44D9-9774-530C31EAC572",
  "DefaultPolicyVersion": {
    "IsDefaultVersion": true,
    "PolicyDocument": "{ \"Statement\": [{ \"Action\": [\"oss:*\"], \"Effect\": \"Allow\", \"Resource\": [\"acs:oss:*:*:*\"]}], \"Version\": \"1\"}",
    "VersionId": "v1",
    "CreateDate": "2015-01-23T12:33:18Z"
  }
}

异常返回示例

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
    }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。