查询资源使用者列表。
接口说明
如果您是资源所有者，您可以查询您把资源共享给了哪些资源使用者。 如果您是资源使用者，您可以查询您参与了哪些资源共享。
本文将提供一个示例，在cn-hangzhou地域，查询您发起的资源共享的资源使用者列表。返回结果显示，您将资源共享给了资源使用者114240524784****和172050525300****。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
resourcesharing:ListSharedTargets |
list |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ResourceOwner |
string |
是 |
共享单元归属者。
|
Self |
| ResourceType |
string |
否 |
共享资源类型。 支持共享的资源类型，请参见支持资源共享的云服务。 |
VSwitch |
| ResourceId |
string |
否 |
共享资源 ID。 |
vsw-bp1upw03qyz8n7us9**** |
| ResourceArn |
string |
否 |
||
| MaxResults |
integer |
否 |
单次请求返回结果的最大条数。 取值范围：1~100。默认值：20。 |
20 |
| NextToken |
string |
否 |
当请求的返回结果被截断时，您可以使用 |
TGlzdFJlc291cm**** |
| ResourceShareIds |
array |
否 |
共享单元 ID。 N 的取值范围：1~5，即每次最多指定 5 个共享单元。 |
rs-6GRmdD3X**** |
|
string |
否 |
共享单元 ID。 N 的取值范围：1~5，即每次最多指定 5 个共享单元。 |
rs-6GRmdD3X**** |
|
| Targets |
array |
否 |
资源使用者。 |
114240524784**** |
|
string |
否 |
资源使用者。取值：
更多信息，请参见资源共享方式、查看资源目录 ID、查看资源夹 ID或查看成员 ID。 N 的取值范围：1~5，即每次最多添加 5 个资源使用者。 |
114240524784**** |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回参数。 |
||
| NextToken |
string |
当请求的返回结果被截断时，您可以使用 |
TGlzdFJlc291cm**** |
| RequestId |
string |
请求 ID。 |
04677DCA-7C33-464B-8811-1B1DA3C3D197 |
| SharedTargets |
array<object> |
资源使用者信息。 |
|
|
object |
资源使用者信息。 |
||
| TargetId |
string |
资源使用者 ID 或资源所有者 ID。取值：
|
114240524784**** |
| UpdateTime |
string |
更新关联资源使用者的时间。 |
2020-12-07T09:16:59.905Z |
| CreateTime |
string |
关联资源使用者的时间。 |
2020-12-07T09:16:59.905Z |
| ResourceShareId |
string |
共享单元 ID。 |
rs-6GRmdD3X**** |
| External |
boolean |
资源使用者是否为资源目录外账号。取值：
|
false |
| TargetProperty |
string |
资源使用者属性。例如：资源共享的时间段。 说明
仅当资源使用者为阿里云服务时返回该参数。 |
{ "timeRange":{ "timeRangeType":"timeRange", "beginAtTime":"00:00", "timezone":"UTC+8", "endAtTime":"19:59" } } |
示例
正常返回示例
JSON格式
{
"NextToken": "TGlzdFJlc291cm****",
"RequestId": "04677DCA-7C33-464B-8811-1B1DA3C3D197",
"SharedTargets": [
{
"TargetId": "114240524784****",
"UpdateTime": "2020-12-07T09:16:59.905Z",
"CreateTime": "2020-12-07T09:16:59.905Z",
"ResourceShareId": "rs-6GRmdD3X****",
"External": false,
"TargetProperty": "{\n \"timeRange\":{\n \"timeRangeType\":\"timeRange\",\n \"beginAtTime\":\"00:00\",\n \"timezone\":\"UTC+8\",\n \"endAtTime\":\"19:59\"\n }\n}"
}
]
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | MissingParameter.ResourceOwner | You must specify ResourceOwner. | ResourceOwner参数缺失。 |
| 400 | InvalidParameter.ResourceOwner | The ResourceOwner is invalid. | ResourceOwner参数错误。 |
| 400 | InvalidParameter.ResourceType | The ResourceType is invalid. | 传入的资源类型错误。 |
| 400 | InvalidParameter.MaxResults | The MaxResults is invalid. | MaxResults参数错误。 |
| 400 | InvalidParameter.NextToken | The NextToken is invalid. | NextToken参数错误。 |
| 400 | InvalidParameter.NextToken.Length | The maximum length of NextToken exceeds 256 characters. | NextToken长度超限（最大256个字符）。 |
| 400 | InvalidParameter.ResourceShareIds | The ResourceShareIds is invalid. | ResourceShareIds参数错误。 |
| 400 | InvalidParameter.ResourceShareIds.Duplicate | The ResourceShareIds contains duplicate values. | ResourceShareIds有重复项。 |
| 400 | InvalidParameter.ResourceShareIds.Length | The maximum length of ResourceShareIds exceeds 5 characters. | ResourceShareIds长度超限（最大5个）。 |
| 400 | InvalidParameter.Targets | The Targets is invalid. | 资源使用者的参数不符合规则。 |
| 400 | InvalidParameter.Targets.Duplicate | The Targets contains duplicate values. | 资源使用者有重复项。 |
| 400 | InvalidParameter.Targets.Length | The maximum number of Targets exceeds 5. | 资源使用者数量超限（最大5个）。 |
| 400 | InvalidParameter.ResourceId | The ResourceId is invalid. | ResourceId参数错误。 |
| 400 | InvalidParameter | The specified parameter is invalid. | 参数无效。 |
| 400 | InvalidParameter.ResourceArn | The ResourceArn is invalid. | 资源ARN参数无效。 |
| 400 | InvalidParameter.ResourceConflict | Both ResourceId and ResourceArn cannot be specified simultaneously. Please provide only one of these parameters. | ResourceId 和 ResourceArn 不能同时指定。请仅提供其中一个参数。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。