调用ListResourceShareAssociations查询共享单元中关联资源或资源使用者的记录。

本文将提供一个示例，在地域cn-hangzhou，查询当前账号创建的共享单元中关联的共享资源的记录。返回结果显示，当前账号关联过以下2个资源：

  • 在共享单元rs-6GRmdD3X****中，添加过VSwitch类型的共享资源vsw-bp1upw03qyz8n7us9****，该资源处于关联中Associated状态，即该资源正常共享中。
  • 在共享单元rs-6GRmdD3X****中，移除过VSwitch类型的共享资源vsw-bp183p93qs667muql****，该资源处于已分离Disassociated状态，即该资源已停止共享。

请求参数

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

要执行的操作。取值：ListResourceShareAssociations。
AssociationType String 是 Resource

关联类型：取值：

  • Resource：查询关联共享资源的记录。
  • Target：查询关联资源使用者的记录。
RegionId String 是 cn-hangzhou

地域ID。

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

ResourceShareIds.N RepeatList 否 rs-6GRmdD3X****

共享单元ID。

N的取值范围：1~5，即每次最多指定5个共享单元。
ResourceId String 否 vsw-bp183p93qs667muql****

资源ID。

说明 当 AssociationType为 Target时，该参数不可用。
Target String 否 172050525300****

资源使用者ID。

说明 当 AssociationType为 Resource时，该参数不可用。
AssociationStatus String 否 Associated

关联状态。取值：

  • Associating：关联中。
  • Associated：已关联。
  • Failed：关联失败。
  • Disassociating：分离中。
  • Disassociated：已分离。
说明 Failed和 Disassociated状态的记录，会在48~96小时内被系统自动删除。
MaxResults Integer 否 20

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

取值范围：1~20。默认值：20。
NextToken String 否 TGlzdFJlc291cmNlU2hhcmVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0

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

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

返回数据

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

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

RequestId String 11BA57B5-7301-4E2F-BBA5-2AE4C2F4FCDB

请求ID。
ResourceShareAssociations Array of ResourceShareAssociation

共享资源或资源使用者信息。
AssociationStatus String Associated

关联状态。取值：

  • Associating：关联中。
  • Associated：已关联。
  • Failed：关联失败。
  • Disassociating：分离中。
  • Disassociated：已分离。
说明 Failed和 Disassociated状态的记录，会在48~96小时内被系统自动删除。
AssociationStatusMessage String The reason for the association failure.

关联失败的原因。
AssociationType String Resource

关联类型。取值：

  • Resource：资源。
  • Target：资源使用者。
CreateTime String 2020-12-07T07:39:01.818Z

关联的时间。存在以下两种情况：

  • 当关联类型AssociationType为资源Resource时，该参数为添加或移除资源的时间。
  • 当关联类型AssociationType为资源使用者Target时，该参数为添加或移除资源使用者的时间。
EntityId String vsw-bp1upw03qyz8n7us9****

关联实体ID。取值：

  • 当关联类型AssociationType为资源Resource时，该参数为资源ID。
  • 当关联类型AssociationType为资源使用者Target时，该参数为资源使用者ID。
EntityType String VSwitch

关联实体类型。取值：

  • 当关联实体为资源时，该参数为VSwitch。
  • 当关联实体为资源使用者时，该参数为Account。
ResourceShareId String rs-6GRmdD3X****

共享单元ID。
ResourceShareName String example

共享单元名称。
UpdateTime String 2020-12-07T07:39:02.920Z

更新关联的时间。存在以下两种情况：

  • 当关联类型AssociationType为资源Resource时，该参数为更新资源的时间。
  • 当关联类型AssociationType为资源使用者Target时，该参数为更新资源使用者的时间。

示例

请求示例

https://resourcesharing.aliyuncs.com/?Action=ListResourceShareAssociations
&AssociationType=Resource
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML 格式 

<ListResourceShareAssociationsResponse>
	  <ResourceShareAssociations>
		    <ResourceShareId>rs-6GRmdD3X****</ResourceShareId>
		    <ResourceShareName>example</ResourceShareName>
		    <EntityId>vsw-bp1upw03qyz8n7us9****</EntityId>
		    <EntityType>VSwitch</EntityType>
		    <AssociationStatusMessage></AssociationStatusMessage>
		    <AssociationType>Resource</AssociationType>
		    <CreateTime>2020-12-07T07:39:01.818Z</CreateTime>
		    <UpdateTime>2020-12-07T07:39:02.920Z</UpdateTime>
		    <AssociationStatus>Associated</AssociationStatus>
	  </ResourceShareAssociations>
	  <ResourceShareAssociations>
		    <ResourceShareId>rs-6GRmdD3X****</ResourceShareId>
		    <ResourceShareName>example</ResourceShareName>
		    <EntityId>vsw-bp183p93qs667muql****</EntityId>
		    <EntityType>VSwitch</EntityType>
		    <AssociationStatusMessage></AssociationStatusMessage>
		    <AssociationType>Resource</AssociationType>
		    <CreateTime>2020-12-04T09:40:41.246Z</CreateTime>
		    <UpdateTime>2020-12-07T03:17:24.067Z</UpdateTime>
		    <AssociationStatus>Disassociated</AssociationStatus>
	  </ResourceShareAssociations>
	  <RequestId>11BA57B5-7301-4E2F-BBA5-2AE4C2F4FCDB</RequestId>
</ListResourceShareAssociationsResponse>

JSON 格式 

{
  "ResourceShareAssociations": [
    {
      "ResourceShareId": "rs-6GRmdD3X****",
      "ResourceShareName": "example",
      "EntityId": "vsw-bp1upw03qyz8n7us9****",
      "EntityType": "VSwitch",
      "AssociationStatusMessage": "",
      "AssociationType": "Resource",
      "CreateTime": "2020-12-07T07:39:01.818Z",
      "UpdateTime": "2020-12-07T07:39:02.920Z",
      "AssociationStatus": "Associated"
    },
    {
      "ResourceShareId": "rs-6GRmdD3X****",
      "ResourceShareName": "example",
      "EntityId": "vsw-bp183p93qs667muql****",
      "EntityType": "VSwitch",
      "AssociationStatusMessage": "",
      "AssociationType": "Resource",
      "CreateTime": "2020-12-04T09:40:41.246Z",
      "UpdateTime": "2020-12-07T03:17:24.067Z",
      "AssociationStatus": "Disassociated"
    }
  ],
  "RequestId": "11BA57B5-7301-4E2F-BBA5-2AE4C2F4FCDB"
}

错误码

HttpCode 错误码 错误信息 描述
400 MissingParameter.AssociationType You must specify AssociationType. AssociationType参数缺失。
400 InvalidParameter.AssociationType The AssociationType is invalid. AssociationType参数错误。
400 InvalidParameter.AssociationStatus The AssociationStatus is invalid. AssociationStatus参数错误。
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.Target The Target is invalid. 资源所有者传参错误。
400 InvalidParameter.ResourceId The ResourceId is invalid. ResourceId参数错误。
400 ConflictedAssociationType The specified ResourceId or Target conflicts with AssociationType. 参数组合冲突：传入参数与AssociationType选定项不符。
400 InvalidParameter The specified parameter is invalid. 参数无效。

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