调用ListResourceRelationships查询指定资源关联的资源列表-阿里云帮助中心

前提条件

调用前，请确保开通资源元数据中心服务。更多信息，请参见跨资源组搜索资源。

使用说明

支持查询的资源类型如下所示，支持双向查询。例如：您既可以通过ECS实例（ACS::ECS::Instance）查询到关联的磁盘（ACS::ECS::Disk），也可以通过磁盘（ACS::ECS::Disk）查询到关联的ECS实例（ACS::ECS::Instance）。

ECS实例（ACS::ECS::Instance）关联的资源类型
- ACS::ECS::Disk
- ACS::EIP::EipAddress
- ACS::VPC::VPC
- ACS::ECS::KeyPair
- ACS::ECS::SecurityGroup
- ACS::ECS::NetworkInterface
- ACS::ECS::Image
VPC实例（ACS::VPC::VPC）关联的资源类型
- ACS::ECS::Instance
- ACS::RDS::DBInstance
- ACS::SLB::LoadBalancer
- ACS::ALB::LoadBalancer
- ACS::Elasticsearch::Instance
- ACS::Redis::DBInstance
- ACS::PolarDB::DBCluster
- ACS::MongoDB::DBInstance
- ACS::DRDS::PolarDBXInstance
- ACS::EDAS::Cluster
- ACS::ECI::ContainerGroup
- ACS::ADB::DBCluster
- ACS::DRDS::DBInstance
- ACS::HBase::Cluster
- ACS::EMR::Cluster

本文将提供一个示例，查询华东2（上海）地域下的ECS实例i-uf6imlgyr1nudhud****关联的资源列表。

QPS限制

本API的单用户QPS限制为20次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	ListResourceRelationships	要执行的操作。取值：ListResourceRelationships。
NextToken	String	否	eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd****	查询返回结果下一页的令牌。当返回结果数据总条数超过`MaxResults`限制，则数据会被截断，您可以使用`NextToken`查询下一页数据。
MaxResults	Integer	否	20	每页的最大数据条数。取值范围：1~100。默认值：20。
SourceRegionId	String	是	cn-shanghai	要查询的源资源所在的地域ID。
SourceResourceType	String	是	ACS::ECS::Instance	要查询的源资源类型。
SourceResourceId.N	String	是	i-uf6imlgyr1nudhud****	要查询的源资源ID。最多添加10个源资源ID。
TargetResourceType.N	String	否	ACS::VPC::VPC	关联的目标资源类型。最多添加10个目标资源类型。

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

返回数据


名称	类型	示例值	描述
NextToken	String	eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd****	查询返回结果下一页的令牌。
RequestId	String	97765772-7E65-5D5E-BBB7-0CAF4D6260AA	请求ID。
MaxResults	Integer	20	每页的最大数据条数。
ResourceRelationships	Array of ResourceRelationship		关联的目标资源列表。
AccountId	String	154035569884****	阿里云账号ID。
SourceRegionId	String	cn-shanghai	源资源所在的地域ID。
SourceResourceType	String	ACS::ECS::Instance	源资源类型。
SourceResourceId	String	i-uf6imlgyr1nudhud****	源资源ID。
TargetRegionId	String	cn-shanghai	关联的目标资源所在地域ID。
TargetResourceType	String	ACS::VPC::VPC	关联的目标资源类型。
TargetResourceId	String	vpc-uf6gvyids4utxhxe1****	关联的目标资源ID。

示例

请求示例

https://rmc.aliyuncs.com/?Action=ListResourceRelationships
&SourceRegionId=cn-shanghai
&SourceResourceType=ACS::ECS::Instance
&SourceResourceId.1=i-uf6imlgyr1nudhud****
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ListResourceRelationshipsResponse>
	<ResourceRelationships>
		<ResourceRelationship>
			<TargetResourceType>ACS::ECS::NetworkInterface</TargetResourceType>
			<SourceRegionId>cn-shanghai</SourceRegionId>
			<AccountId>154035569884****</AccountId>
			<TargetResourceId>eni-uf68v6tepfijeia5****</TargetResourceId>
			<SourceResourceId>i-uf6imlgyr1nudhud****</SourceResourceId>
			<TargetRegionId>cn-shanghai</TargetRegionId>
			<SourceResourceType>ACS::ECS::Instance</SourceResourceType>
		</ResourceRelationship>
		<ResourceRelationship>
			<TargetResourceType>ACS::VPC::VPC</TargetResourceType>
			<SourceRegionId>cn-shanghai</SourceRegionId>
			<AccountId>154035569884****</AccountId>
			<TargetResourceId>vpc-uf6gvyids4utxhxe1****</TargetResourceId>
			<SourceResourceId>i-uf6imlgyr1nudhud****</SourceResourceId>
			<TargetRegionId>cn-shanghai</TargetRegionId>
			<SourceResourceType>ACS::ECS::Instance</SourceResourceType>
		</ResourceRelationship>
		<ResourceRelationship>
			<TargetResourceType>ACS::ECS::SecurityGroup</TargetResourceType>
			<SourceRegionId>cn-shanghai</SourceRegionId>
			<AccountId>154035569884****</AccountId>
			<TargetResourceId>sg-uf62urehb0clpmvu****</TargetResourceId>
			<SourceResourceId>i-uf6imlgyr1nudhud****</SourceResourceId>
			<TargetRegionId>cn-shanghai</TargetRegionId>
			<SourceResourceType>ACS::ECS::Instance</SourceResourceType>
		</ResourceRelationship>
		<ResourceRelationship>
			<TargetResourceType>ACS::ECS::Disk</TargetResourceType>
			<SourceRegionId>cn-shanghai</SourceRegionId>
			<AccountId>154035569884****</AccountId>
			<TargetResourceId>d-uf624ee9ow9seg0l****</TargetResourceId>
			<SourceResourceId>i-uf6imlgyr1nudhud****</SourceResourceId>
			<TargetRegionId>cn-shanghai</TargetRegionId>
			<SourceResourceType>ACS::ECS::Instance</SourceResourceType>
		</ResourceRelationship>
	</ResourceRelationships>
	<RequestId>97765772-7E65-5D5E-BBB7-0CAF4D6260AA</RequestId>
	<MaxResults>20</MaxResults>
</ListResourceRelationshipsResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "ResourceRelationships" : [ {
    "TargetResourceType" : "ACS::ECS::NetworkInterface",
    "SourceRegionId" : "cn-shanghai",
    "AccountId" : "154035569884****",
    "TargetResourceId" : "eni-uf68v6tepfijeia5****",
    "SourceResourceId" : "i-uf6imlgyr1nudhud****",
    "TargetRegionId" : "cn-shanghai",
    "SourceResourceType" : "ACS::ECS::Instance"
  }, {
    "TargetResourceType" : "ACS::VPC::VPC",
    "SourceRegionId" : "cn-shanghai",
    "AccountId" : "154035569884****",
    "TargetResourceId" : "vpc-uf6gvyids4utxhxe1****",
    "SourceResourceId" : "i-uf6imlgyr1nudhud****",
    "TargetRegionId" : "cn-shanghai",
    "SourceResourceType" : "ACS::ECS::Instance"
  }, {
    "TargetResourceType" : "ACS::ECS::SecurityGroup",
    "SourceRegionId" : "cn-shanghai",
    "AccountId" : "154035569884****",
    "TargetResourceId" : "sg-uf62urehb0clpmvu****",
    "SourceResourceId" : "i-uf6imlgyr1nudhud****",
    "TargetRegionId" : "cn-shanghai",
    "SourceResourceType" : "ACS::ECS::Instance"
  }, {
    "TargetResourceType" : "ACS::ECS::Disk",
    "SourceRegionId" : "cn-shanghai",
    "AccountId" : "154035569884****",
    "TargetResourceId" : "d-uf624ee9ow9seg0l****",
    "SourceResourceId" : "i-uf6imlgyr1nudhud****",
    "TargetRegionId" : "cn-shanghai",
    "SourceResourceType" : "ACS::ECS::Instance"
  } ],
  "RequestId" : "97765772-7E65-5D5E-BBB7-0CAF4D6260AA",
  "MaxResults" : 20
}

错误码

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