全部产品
Search

搜索本产品

    资源管理：ListPolicyAttachments - 查看授权列表

    文档中心

    资源管理：ListPolicyAttachments - 查看授权列表

    更新时间：Dec 16, 2024

    调用ListPolicyAttachments查看授权列表。

    接口说明

    您可以查看以下信息：

    • 阿里云账号或资源组下的所有授权记录。
    • RAM 用户、RAM 用户组、RAM 角色被授予的所有权限策略。
    • 阿里云账号或资源组下拥有某个权限的 RAM 用户、RAM 用户组、RAM 角色。

    调试

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

    授权信息

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

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

    请求参数

    名称类型必填描述示例值
    ResourceGroupIdstring否

    资源组 ID 或资源组所属的阿里云账号 ID。取值为空表示列出当前账号下的所有授权记录。

    		rg-001
    PolicyTypestring否

    权限策略类型。取值为空表示列出所有类型的权限策略。

    • Custom：自定义策略。
    • System：系统策略。
    		System
    PolicyNamestring否

    权限策略名称。

    长度为 1~128 个字符，可包含英文字母、数字和短横线（-）。

    		AdministratorAccess
    PrincipalTypestring否

    被授权对象类型。取值为空表示列出所有类型的被授权对象。

    • IMSUser：RAM 用户。
    • IMSGroup：RAM 用户组。
    • ServiceRole：RAM 角色。
    		IMSUser
    PrincipalNamestring否

    被授权对象名称。

    		alice@demo.onaliyun.com
    PageNumberinteger否

    页码。

    起始值：1。默认值：1。

    		1
    PageSizeinteger否

    分页时每页显示的数据行数。

    取值范围：1~100。默认值：10。

    		10
    Languagestring否

    语言类型。系统权限策略的描述将以此语言返回。

    • en：英文。
    • zh-CN：中文。
    • ja：日文。
    		zh-CN

    返回参数

    名称类型描述示例值
    object
    PageNumberinteger

    页码。

    		1
    PageSizeinteger

    分页时每页显示的数据行数。

    		10
    PolicyAttachmentsarray<object>

    权限策略信息。

    PolicyAttachmentobject

    权限策略信息。

    AttachDatestring

    授权时间。

    		2015-01-23T12:33:18Z
    Descriptionstring

    权限策略描述。

    		管理员权限
    PolicyNamestring

    权限策略名称。

    		AdministratorAccess
    PolicyTypestring

    权限策略类型。

    • Custom：自定义策略。
    • System：系统策略。
    		System
    PrincipalNamestring

    被授权对象名称。

    		alice@demo.onaliyun.com
    PrincipalTypestring

    被授权对象类型。

    • IMSUser：RAM 用户。
    • IMSGroup：RAM 用户组。
    • ServiceRole：RAM 角色。
    		IMSUser
    ResourceGroupIdstring

    资源组 ID 或资源组所属的阿里云账号 ID。

    		rg-9gLOoK****
    RequestIdstring

    请求 ID。

    		7B8A4E7D-6CFF-471D-84DF-195A7A241ECB
    TotalCountinteger

    数据总条数。

    		2

    示例

    正常返回示例

    JSON格式

    {
  "PageNumber": 1,
  "PageSize": 10,
  "PolicyAttachments": {
    "PolicyAttachment": [
      {
        "AttachDate": "2015-01-23T12:33:18Z",
        "Description": "管理员权限",
        "PolicyName": "AdministratorAccess",
        "PolicyType": "System",
        "PrincipalName": "alice@demo.onaliyun.com",
        "PrincipalType": "IMSUser",
        "ResourceGroupId": "rg-9gLOoK****"
      }
    ]
  },
  "RequestId": "7B8A4E7D-6CFF-471D-84DF-195A7A241ECB",
  "TotalCount": 2
}

    错误码

    HTTP status code错误码错误信息描述
    400InvalidParameter.PolicyTypeThe specified policy type is invalid.无效的权限策略类型。
    404EntityNotExists.ResourceGroupThe specified resource group does not exist. You must first create a resource group.资源组不存在，请先创建资源组。
    404EntityNotExist.PolicyThe policy does not exist.权限策略不存在。

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

    变更历史

    变更时间变更内容概要操作
    暂无变更历史