全部产品
Search
文档中心

资源管理:ListResourceSharePermissions - 查询共享单元中关联权限的记录

更新时间:Aug 28, 2026

调用ListResourceSharePermissions查询共享单元中关联权限的记录。

接口说明

本文将提供一个示例,在cn-hangzhou地域,查询当前账号创建的共享单元中关联的共享权限记录。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

ResourceShareId

string

共享单元 ID。

rs-6GRmdD3X****

MaxResults

integer

单次请求返回结果的最大条数。

取值范围:1~100。默认值:20。

20

NextToken

string

当请求的返回结果被截断时,您可以使用NextToken再次发起请求,获取从当前截断位置之后的内容。

TGlzdFJlc291cm****

ResourceOwner

string

共享单元归属者。取值:

  • Self:查询当前账号的共享单元列表。

  • OtherAccounts:查询其他账号共享给当前账号的共享单元列表。

Self

返回参数

名称

类型

描述

示例值

object

返回参数。

NextToken

string

当请求的返回结果被截断时,您可以使用NextToken再次发起请求,获取从当前截断位置之后的内容。

TGlzdFJlc291cm****

RequestId

string

请求 ID。

2F23CFB6-A721-4E90-AC1E-0E30FA8B45DA

Permissions

array<object>

共享权限信息。

object

共享权限信息。

PermissionName

string

共享权限名称。

AliyunRSDefaultPermissionVSwitch

PermissionVersion

string

共享权限版本。

v1

DefaultVersion

boolean

共享权限是否为默认版本。取值:

  • false:不是默认版本。

  • true:是默认版本。

true

CreateTime

string

创建时间。

2020-12-07T07:39:01.818Z

UpdateTime

string

更新时间。

2020-12-07T07:39:01.818Z

ResourceType

string

共享资源类型。

支持共享的资源类型,请参见支持资源共享的云服务

VSwitch

DefaultPermission

boolean

是否为默认权限。取值:

  • false:不是默认权限。

  • true:是默认权限。

true

示例

正常返回示例

JSON格式

{
  "NextToken": "TGlzdFJlc291cm****",
  "RequestId": "2F23CFB6-A721-4E90-AC1E-0E30FA8B45DA",
  "Permissions": [
    {
      "PermissionName": "AliyunRSDefaultPermissionVSwitch",
      "PermissionVersion": "v1",
      "DefaultVersion": true,
      "CreateTime": "2020-12-07T07:39:01.818Z",
      "UpdateTime": "2020-12-07T07:39:01.818Z",
      "ResourceType": "VSwitch",
      "DefaultPermission": true
    }
  ]
}

错误码

HTTP status code

错误码

错误信息

描述

400 MissingParameter.ResourceShareId You must specify ResourceShareId.
400 InvalidParameter.ResourceShareId The ResourceShareId is invalid.
400 InvalidParameter.MaxResults The MaxResults is invalid.
400 InvalidParameter.NextToken The NextToken is invalid.
400 InvalidParameter.NextToken.Length The maximum length of NextToken exceeds 256 characters.
400 InvalidParameter.ResourceOwner The ResourceOwner is invalid.
400 MissingParameter.ResourceOwner You must specify ResourceOwner.
404 EntityNotExists.ResourceShare The resource share does not exist in the current account.

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

变更历史

更多信息,参考变更详情