调用ListResourceShareAssociations查询共享单元中关联资源或资源使用者的记录。
本文将提供一个示例,在地域cn-hangzhou
,查询当前账号创建的共享单元中关联的共享资源的记录。返回结果显示,当前账号关联过以下2个资源:
- 在共享单元
rs-6GRmdD3X****
中,添加过VSwitch类型的共享资源vsw-bp1upw03qyz8n7us9****
,该资源处于关联中Associated
状态,即该资源正常共享中。 - 在共享单元
rs-6GRmdD3X****
中,移除过VSwitch类型的共享资源vsw-bp183p93qs667muql****
,该资源处于已分离Disassociated
状态,即该资源已停止共享。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListResourceShareAssociations |
要执行的操作。取值:ListResourceShareAssociations。 |
AssociationType | String | 是 | Resource |
关联类型:取值:
|
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 |
关联状态。取值:
说明
Failed 和Disassociated 状态的记录,会在48~96小时内被系统自动删除。
|
MaxResults | Integer | 否 | 20 |
单次请求返回结果的最大条数。 取值范围:1~20。默认值:20。 |
NextToken | String | 否 | TGlzdFJlc291cmNlU2hhcmVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0 |
当请求的返回结果被截断时,您可以使用 |
关于公共请求参数的详情,请参见公共参数。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
NextToken | String | TGlzdFJlc291cmNlU2hhcmVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0= |
当请求的返回结果被截断时,您可以使用 |
RequestId | String | 11BA57B5-7301-4E2F-BBA5-2AE4C2F4FCDB |
请求ID。 |
ResourceShareAssociations | Array of ResourceShareAssociation |
共享资源或资源使用者信息。 |
|
AssociationStatus | String | Associated |
关联状态。取值:
说明
Failed 和Disassociated 状态的记录,会在48~96小时内被系统自动删除。
|
AssociationStatusMessage | String | The reason for the association failure. |
关联失败的原因。 |
AssociationType | String | Resource |
关联类型。取值:
|
CreateTime | String | 2020-12-07T07:39:01.818Z |
关联的时间。存在以下两种情况:
|
EntityId | String | vsw-bp1upw03qyz8n7us9**** |
关联实体ID。取值:
|
EntityType | String | VSwitch |
关联实体类型。取值:
|
ResourceShareId | String | rs-6GRmdD3X**** |
共享单元ID。 |
ResourceShareName | String | example |
共享单元名称。 |
UpdateTime | String | 2020-12-07T07:39:02.920Z |
更新关联的时间。存在以下两种情况:
|
示例
请求示例
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. | 参数无效。 |
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交