调用ListSharedTargets查询资源使用者列表。
如果是您发起的资源共享,您可以查询您把资源共享给了哪些资源使用者。
如果是其他账号发起的资源共享,您可以查询您作为资源使用者参与了哪些资源共享。
本文将提供一个示例,查询在地域cn-hangzhou
下您发起的资源共享的资源使用者列表。返回结果显示,您将资源共享给了资源使用者114240524784****
和172050525300****
。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListSharedTargets |
要执行的操作。取值:ListSharedTargets。 |
RegionId | String | 是 | cn-hangzhou |
地域ID。 支持资源共享的地域,请参见DescribeRegions。 |
ResourceOwner | String | 是 | Self |
共享单元归属者。
|
ResourceShareIds.N | RepeatList | 否 | rs-6GRmdD3X**** |
共享单元ID。 N的取值范围:1~5,即每次最多指定5个共享单元。 |
Targets.N | RepeatList | 否 | 114240524784**** |
资源使用者。 资源共享的受益方,可以使用共享的资源,通常为资源目录内的成员账号UID。关于如何获取成员账号UID,请参见查看成员基本信息。 N的取值范围:1~5,即每次最多指定5个资源使用者。 |
ResourceType | String | 否 | VSwitch |
共享资源类型。 取值:VSwitch。 |
ResourceId | String | 否 | vsw-bp1upw03qyz8n7us9**** |
共享资源ID。 |
MaxResults | Integer | 否 | 20 |
单次请求返回结果的最大条数。 取值范围:1~20。默认值:20。 |
NextToken | String | 否 | TGlzdFJlc291cmNlU2hhcmVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0 |
当请求的返回结果被截断时,您可以使用 |
关于公共请求参数的详情,请参见公共参数。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
NextToken | String | TGlzdFJlc291cmNlU2hhcmVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0= |
当请求的返回结果被截断时,您可以使用 |
RequestId | String | 04677DCA-7C33-464B-8811-1B1DA3C3D197 |
请求ID。 |
SharedTargets | Array of SharedTarget |
资源使用者信息。 |
|
CreateTime | String | 2020-12-07T09:16:59.905Z |
关联资源使用者的时间。 |
ResourceShareId | String | rs-6GRmdD3X**** |
共享单元ID。 |
TargetId | String | 114240524784**** |
资源使用者ID。 |
UpdateTime | String | 2020-12-07T09:16:59.905Z |
更新关联资源使用者的时间。 |
示例
请求示例
https://resourcesharing.aliyuncs.com/?Action=ListSharedTargets
&RegionId=cn-hangzhou
&ResourceOwner=Self
&<公共请求参数>
正常返回示例
XML
格式
<ListSharedTargetsResponse>
<RequestId>445ECACB-1082-4008-ABD4-8B259EFF4855</RequestId>
<SharedTargets>
<ResourceShareId>rs-6GRmdD3X****</ResourceShareId>
<CreateTime>2020-12-07T09:16:59.905Z</CreateTime>
<UpdateTime>2020-12-07T09:16:59.905Z</UpdateTime>
<TargetId>114240524784****</TargetId>
</SharedTargets>
<SharedTargets>
<ResourceShareId>rs-6GRmdD3X****</ResourceShareId>
<CreateTime>2020-12-07T09:15:26.879Z</CreateTime>
<UpdateTime>2020-12-07T09:15:26.879Z</UpdateTime>
<TargetId>172050525300****</TargetId>
</SharedTargets>
</ListSharedTargetsResponse>
JSON
格式
{
"RequestId": "445ECACB-1082-4008-ABD4-8B259EFF4855",
"SharedTargets": [
{
"ResourceShareId": "rs-6GRmdD3X****",
"CreateTime": "2020-12-07T09:16:59.905Z",
"UpdateTime": "2020-12-07T09:16:59.905Z",
"TargetId": "114240524784****"
},
{
"ResourceShareId": "rs-6GRmdD3X****",
"CreateTime": "2020-12-07T09:15:26.879Z",
"UpdateTime": "2020-12-07T09:15:26.879Z",
"TargetId": "172050525300****"
}
]
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
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.Length | The maximum length of ResourceShareIds exceeds 5 characters. | ResourceShareIds长度超限(最大5个)。 |
400 | InvalidParameter.ResourceShareIds.Duplicate | The ResourceShareIds contains duplicate values. | ResourceShareIds有重复项。 |
400 | InvalidParameter.Targets | The Targets is invalid. | 资源使用者的参数不符合规则。 |
400 | InvalidParameter.Targets.Length | The maximum number of Targets exceeds 5. | 资源使用者数量超限(最大5个)。 |
400 | InvalidParameter.Targets.Duplicate | The Targets contains duplicate values. | 资源使用者有重复项。 |
400 | InvalidParameter.ResourceId | The ResourceId is invalid. | ResourceId参数错误。 |
400 | InvalidParameter | The specified parameter is invalid. | 参数无效。 |
访问错误中心查看更多错误码。