# 查询资源关联的实例信息列表 - ListResourceAssociations #### 功能介绍 网卡等资源可以关联高阶服务的资源实例，如ELB，您可以通过此接口查询资源关联的实例信息列表，包括资源和实例的类型、ID和所属的项目ID。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-vpc/vpc_api00_0007.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-vpc/vpc_permission_0000.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI GET /v3/{project_id}/vpc/resource-associations 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释**： 网络ACL所属的项目ID。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-vpc/vpc_api_0011.html)。 **取值范围**： 不涉及。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | resource_id | 否 | Array of strings | **参数解释**： 资源ID，填写后按照ID进行过滤，支持传入多个ID过滤。 **取值范围**： 弹性网卡/辅助弹性网卡的资源ID。 | | resource_type | 否 | Array of strings | **参数解释**： 资源的类型，填写后按照资源类型进行过滤，支持传入多个资源类型过滤。 **取值范围**： - port：弹性网卡。 - subeni：辅助弹性网卡。 | | resource_project_id | 否 | String | **参数解释**： 资源所属的项目ID，填写后按照项目ID进行过滤。 **取值范围**： 不涉及。 | | instance_id | 否 | Array of strings | **参数解释**： 实例ID，填写后按照ID进行过滤，支持传入多个ID过滤。 **取值范围**： ELB实例的ID。 | | instance_type | 否 | Array of strings | **参数解释**： 实例的类型，填写后按照实例类型进行过滤，支持传入多个实例类型过滤。 **取值范围**： - ELB：ELB实例。 | | instance_project_id | 否 | String | **参数解释**： 实例所属的项目ID，填写后按照项目ID进行过滤。 **取值范围**： 不涉及。 | #### 请求参数 无 #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | request_id | String | **参数解释**： 请求ID。 **取值范围**： 不涉及。 | | resource_associations | Array of [ResourceAssociation] objects | **参数解释**： 资源关联实例信息列表。 **取值范围**： 不涉及。 | | page_info | [PageInfo] object | **参数解释**： 分页信息。 **取值范围**： 不涉及。 | 表4ResourceAssociation | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释**： 资源和实例关联关系的ID。 **取值范围**： 不涉及。 | | resource_id | String | **参数解释**： 资源ID。 **取值范围**： 不涉及。 | | resource_type | String | **参数解释**： 资源类型。 **取值范围**： - port：弹性网卡。 - subeni：辅助弹性网卡。 | | resource_project_id | String | **参数解释**： 资源所属的项目ID。 **取值范围**： 不涉及。 | | instance_id | String | **参数解释**： 实例ID。 **取值范围**： 不涉及。 | | instance_type | String | **参数解释**： 实例类型。 **取值范围**： - ELB：ELB实例。 | | instance_project_id | String | **参数解释**： 实例所属的项目ID。 **取值范围**： 不涉及。 | 表5PageInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | previous_marker | String | **参数解释**： 当前页的第一条记录。 **取值范围**： 不涉及。 | | current_count | Integer | **参数解释**： 当前页的资源总数。 **取值范围**： 不涉及。 | | next_marker | String | **参数解释**： 当前页的最后一条记录，最后一页时无next_marker字段。 **取值范围**： 不涉及。 | #### 请求示例 查询资源关联的实例信息列表。 ``` GET https://{Endpoint}/v3/{project_id}/vpc/resource-associations ``` #### 响应示例 **状态码：200** ``` { "request_id" : "7bf6704ac786da56fc1c517b5abd19b2", "resource_associations" : [ { "id" : "4aa73aa9-9402-461a-8cf0-31c8e6b612d1", "resource_type" : "subeni", "resource_id" : "c5fcc0cd-d025-41d6-8021-43d155e01031", "resource_project_id" : "5e122060ce2840e39c765feb7e6d5b6b", "instance_type" : "ELB", "instance_id" : "80489e14-30c2-4c60-a486-bdc1809740e5", "instance_project_id" : "5e122060ce2840e39c765feb7e6d5b6b" }, { "id" : "23775f49-927b-44b9-acba-5ddd1a53c187", "resource_type" : "subeni", "resource_id" : "c5fcc0cd-d025-41d6-8021-43d155e01031", "resource_project_id" : "5e122060ce2840e39c765feb7e6d5b6b", "instance_type" : "ELB", "instance_id" : "73980090-c383-4510-bfa2-433149a5b298", "instance_project_id" : "5e122060ce2840e39c765feb7e6d5b6b" } ], "page_info" : { "previous_marker" : "4aa73aa9-9402-461a-8cf0-31c8e6b612d1", "current_count" : 2 } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | GET操作正常返回，更多状态码请参见[状态码](https://support.huaweicloud.com/api-vpc/vpc_api_0002.html)。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-vpc/vpc_api_0003.html)。