调用ListSharedResources查询您共享的资源列表或者其他账号共享给您的资源列表。

本文将提供一个示例,查询您在地域cn-hangzhou下共享的资源列表。返回结果显示,您只共享过1个资源,即在共享单元rs-6GRmdD3X****中共享过VSwitch类型的资源vsw-bp1upw03qyz8n7us9****

请求参数

名称 类型 是否必选 示例值 描述
Action String ListSharedResources

要执行的操作。取值:ListSharedResources。

RegionId String cn-hangzhou

地域ID。

资源共享支持的地域,请参见DescribeRegions

ResourceOwner String Self

共享单元归属者。取值:

  • Self:查询您创建的共享单元中,共享给其他账号的资源列表。
  • OtherAccounts:查询其他账号创建的共享单元中,共享给您的资源列表。
ResourceShareIds.N RepeatList rs-6GRmdD3X****

共享单元ID。

N的取值范围:1~5,即每次最多指定5个共享单元。

ResourceType String VSwitch

共享资源类型。

取值:VSwitch。

ResourceIds.N RepeatList vsw-bp1upw03qyz8n7us9****

共享资源ID。

N的取值范围:1~5,即每次最多指定5个共享资源。

Target String 172050525300****

资源使用者。

资源共享的受益方,可以使用共享的资源,通常为资源目录内的成员账号UID。关于如何获取成员账号UID,请参见查看成员基本信息

MaxResults Integer 20

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

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

NextToken String TGlzdFJlc291cmNlU2hhcmVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0

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

关于公共请求参数的详情,请参见公共参数

返回数据

名称 类型 示例值 描述
NextToken String TGlzdFJlc291cmNlU2hhcmVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=

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

RequestId String 04677DCA-7C33-464B-8811-1B1DA3C3D197

请求ID。

SharedResources Array of SharedResource

共享资源信息。

CreateTime String 2020-12-07T07:39:02.921Z

关联资源的时间。

ResourceId String vsw-bp1upw03qyz8n7us9****

共享资源ID。

ResourceShareId String rs-6GRmdD3X****

共享单元ID。

ResourceStatus String Available

共享资源状态。查询您共享的资源时不返回该参数,查询共享给您的资源时返回该参数。

取值:

  • Available:资源可用。
  • ZonalResourceInaccessible:在当前可用区,资源不可用。
  • LimitExceeded:配额超限,资源不可用。
  • Unavailable:资源不可用。
ResourceStatusMessage String The reason for the association failure.

关联失败的原因。

ResourceType String VSwitch

共享资源类型。取值:VSwitch。

UpdateTime String 2020-12-07T07:39:02.921Z

更新关联资源的时间。

示例

请求示例

https://resourcesharing.aliyuncs.com/?Action=ListSharedResources
&RegionId=cn-hangzhou
&ResourceOwner=Self
&<公共请求参数>

正常返回示例

XML 格式

<ListSharedResourcesResponse>
	  <RequestId>04677DCA-7C33-464B-8811-1B1DA3C3D197</RequestId>
	  <SharedResources>
		    <ResourceShareId>rs-6GRmdD3X****</ResourceShareId>
		    <ResourceId>vsw-bp1upw03qyz8n7us9****</ResourceId>
		    <CreateTime>2020-12-07T07:39:02.921Z</CreateTime>
		    <UpdateTime>2020-12-07T07:39:02.921Z</UpdateTime>
		    <ResourceType>VSwitch</ResourceType>
	  </SharedResources>
</ListSharedResourcesResponse>

JSON 格式

{
  "RequestId": "04677DCA-7C33-464B-8811-1B1DA3C3D197",
  "SharedResources": [
    {
      "ResourceShareId": "rs-6GRmdD3X****",
      "ResourceId": "vsw-bp1upw03qyz8n7us9****",
      "CreateTime": "2020-12-07T07:39:02.921Z",
      "UpdateTime": "2020-12-07T07:39:02.921Z",
      "ResourceType": "VSwitch"
    }
  ]
}

错误码

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.ResourceIds The ResourceIds is invalid. 传入的资源ID错误。
400 InvalidParameter.ResourceIds.Length The maximum number of ResourceIds (5) is exceeded. 传入的资源ID数量超限(最大5个)。
400 InvalidParameter.ResourceIds.Duplicate The specified ResourceId contains duplicate values. 传入的资源ID有重复项。
400 InvalidParameter.Target The Target is invalid. 资源所有者传参错误。
400 InvalidParameter The specified parameter is invalid. 参数无效。

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