ListResourceShares_资源共享_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

本文将提供一个示例,查询当前账号在cn-hangzhou地域创建的共享单元列表。返回结果显示,当前账号151266687691****创建过以下 2 个共享单元:

  • 共享单元rs-hX9wC5jO****,处于已删除Deleted状态。
  • 共享单元rs-PqysnzIj****,处于已启用Active状态。

流控信息

请求速率为20/1(s)。

授权信息

当前云产品暂无权限信息透出。

请求参数

字段名称字段详情
ResourceOwnerstring

共享单元归属者。取值:展开详情

示例值:Self
ResourceShareNamestring

共享单元名称。

示例值:test参考取值来源:
    CreateResourceShare
    UpdateResourceShare
    AssociateResourceShare
    DisassociateResourceShare
    RejectResourceShareInvitation
    AcceptResourceShareInvitation
    ListResourceShareInvitations
ResourceShareStatusstring

共享单元状态。取值:展开详情

示例值:Active
MaxResultsinteger<int32>

单次请求返回结果的最大条数。展开详情

示例值:20
NextTokenstring

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

示例值:TGlzdFJlc291cm****
ResourceShareIdsarray<string>

共享单元 ID。展开详情

示例值:rs-PqysnzIj****子级条数 <= 20
PermissionNamestring

共享权限名称。具体信息,请参见权限库

示例值:AliyunRSDefaultPermissionVSwitch参考取值来源:
    ListPermissions
    AssociateResourceSharePermission
ResourceGroupIdstring

资源组 ID。

示例值:rg-aekz5nlvlak****
Tagarray<object>

标签列表。

子级条数 <= 20

返回参数

字段名称字段详情
NextTokenstring

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

示例值:TGlzdFJlc291cm****
RequestIdstring

请求 ID。

示例值:2F23CFB6-A721-4E90-AC1E-0E30FA8B45DA
ResourceSharesarray<object>

共享单元信息。

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
MissingParameter.ResourceOwner
You must specify ResourceOwner.诊断
400
InvalidParameter.ResourceOwner
The ResourceOwner is invalid.诊断
400
InvalidParameter.ResourceShareName
The ResourceShareName is invalid.诊断
400
InvalidParameter.ResourceShareName.Length
The maximum length of ResourceShareName exceeds 50 characters.诊断
400
InvalidParameter.ResourceShareStatus
The ResourceShareStatus 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.ResourceShareIds
The ResourceShareIds is invalid.诊断
400
InvalidParameter.ResourceShareIds.Duplicate
The ResourceShareIds contains duplicate values.诊断
400
InvalidParameter.ResourceShareIds.Length
The maximum length of ResourceShareIds exceeds 5 characters.诊断
400
InvalidParameter
The specified parameter is invalid.诊断
400
InvalidParameter.ResourceOwnerAndTag
You cannot use ResourceOwner set to OtherAccounts and tags in one request.诊断

变更历史

变更时间变更内容概要操作
2024-11-18
变更错误码400
新增请求参数ResourceGroupId
新增请求参数Tag
变更返回参数
2023-04-03
删除请求参数ResourceGroupId
删除返回参数
2023-03-02
新增请求参数ResourceGroupId
变更返回参数
2022-11-16
新增请求参数PermissionName
2021-11-18
新增错误码400

相关示例