ListResourceShareAssociations - 资源管理

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

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

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
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.	参数无效。

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