调用DescribeExposedInstanceList接口查询暴露在互联网的服务器信息。

调试

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

请求参数

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

需要执行的操作。

取值：DescribeExposedInstanceList。

PageSize Integer 否 20

分页查询时，每页显示的数据最大条数。每页默认显示的数据条数为20条，PageSize参数值为空时，将默认返回20条数据。

说明 建议PageSize取值不要为空。
CurrentPage Integer 否 1

分页查询时，当前页的页码。
GroupId Long 否 9535356

指定要查询的服务器分组ID。

说明 您可以调用DescribeAllGroups接口查询服务器分组ID。
VulStatus Boolean 否 true

指定要查询的服务器是否存在漏洞。取值：

  • true：存在
  • false：不存在
ExposureComponent String 否 openssl

指定要查询的暴露在互联网中的系统组件名称。
ExposurePort String 否 22

指定要查询的暴露端口。
ExposureIp String 否 116.12.XX.XX

指定要查询的服务器公网IP。
InstanceId String 否 i-bp1g6wxdwps7s9dz****

指定要查询的服务器实例ID。
InstanceName String 否 abc_centos7.2_005

指定要查询的服务器名称。

调用API时，除了本文中该API的请求参数，还需加入阿里云API公共请求参数。公共请求参数的详细介绍，请参见公共参数。

调用API的请求格式，请参见本文示例中的请求示例。

返回数据

名称 类型 示例值 描述
ExposedInstances Array of ExposedInstance

资产暴露分析的列表信息。
AsapVulCount Integer 0

暴露在互联网上可被黑客利用的高危漏洞数量。
ExposureComponent String openssl,openssh

暴露在互联网上的系统组件。
ExposureIp String 116.12.XX.XX

暴露在互联网上的公网IP。
ExposurePort String 22

暴露在互联网上的端口。
ExposureType String INTERNET_IP

暴露方式。取值：

  • INTERNET_IP：ECS公网IP
  • SLB：负载均衡SLB公网IP
  • EIP：弹性公网IP
  • DNAT：使用DNAT功能连接互联网的NAT网关
ExposureTypeId String i-ew11313a****

暴露方式对应的实例ID。不同暴露方式对应不同的实例ID，取值：

  • ExposureType为INTERNET_IP时：取值为空。
  • ExposureType为SLB时：取值为负载均衡公网实例ID。
  • ExposureType为EIP时：取值为弹性公网IP的实例ID。
  • ExposureType为DNAT时：取值为NAT网关实例ID。
GroupId Long 9469268

服务器分组ID。
GroupName String 未分组

服务器分组名称。
InstanceId String i-bp1g6wxdwps7s9dz****

服务器实例ID。
InstanceName String abc_centos7.2_005

服务器名称。
InternetIp String 116.12.XX.XX

服务器公网IP。
IntranetIp String 192.168.XX.XX

服务器私网IP。
LaterVulCount Integer 0

暴露在互联网上可被黑客利用的中危漏洞数量。
NntfVulCount Integer 0

暴露在互联网上可被黑客利用的低危漏洞数量。
RegionId String cn-hangzhou

服务器所在区域的ID。

说明 Region ID和区域名称的对应关系，请参见地域和可用区。
TotalVulCount Integer 0

暴露在互联网上可被黑客利用的漏洞总数量。
Uuid String dd803d9e-a337-4add-9c5b-7d503e08****

服务器UUID。
PageInfo Struct

分页信息。
Count Integer 2

分页查询时，当前页显示的数据条数。
CurrentPage Integer 1

分页查询时，当前页的页码。
PageSize Integer 20

分页查询时，每页最多显示的数据条数。
TotalCount Integer 2

暴露在互联网的服务器数据的总条数。
RequestId String 598A4A61-ABA7-456B-8725-7378258276D9

阿里云为该请求生成的唯一标识符。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeExposedInstanceList
&<公共请求参数>

正常返回示例

XML格式 

<DescribeExposedInstanceListResponse>
      <PageInfo>
            <TotalCount>2</TotalCount>
            <PageSize>20</PageSize>
            <CurrentPage>1</CurrentPage>
            <Count>2</Count>
      </PageInfo>
      <RequestId>598A4A61-ABA7-456B-8725-7378258276D9</RequestId>
      <ExposedInstances>
            <TotalVulCount>0</TotalVulCount>
            <GroupName>未分组</GroupName>
            <ExposureType>INTERNET_IP</ExposureType>
            <InstanceId>i-bp1g6wxdwps7s9dz****</InstanceId>
            <ExposureComponent>openssh</ExposureComponent>
            <ExposurePort>22</ExposurePort>
            <AsapVulCount>0</AsapVulCount>
            <NntfVulCount>0</NntfVulCount>
            <IntranetIp>172.16.XX.XX</IntranetIp>
            <GroupId>9535356</GroupId>
            <InstanceName>abc_centos7.2_005</InstanceName>
            <Uuid>dd803d9e-a337-4add-9c5b-7d503e08****</Uuid>
            <InternetIp>47.114.XX.XX</InternetIp>
            <ExposureTypeId></ExposureTypeId>
            <ExposureIp>47.114.XX.XX</ExposureIp>
            <LaterVulCount>0</LaterVulCount>
            <RegionId>cn-hangzhou</RegionId>
      </ExposedInstances>
      <ExposedInstances>
            <TotalVulCount>0</TotalVulCount>
            <GroupName>未分组</GroupName>
            <ExposureType>INTERNET_IP</ExposureType>
            <InstanceId>i-bp1iy78ba3jgjyqp****</InstanceId>
            <ExposureComponent>rdp</ExposureComponent>
            <ExposurePort>3389</ExposurePort>
            <AsapVulCount>0</AsapVulCount>
            <NntfVulCount>0</NntfVulCount>
            <IntranetIp>172.16.XX.XX</IntranetIp>
            <GroupId>9535356</GroupId>
            <InstanceName>efd_centos7.2_005</InstanceName>
            <Uuid>c9782b85-7015-4359-8b75-5e26f854****</Uuid>
            <InternetIp>120.26.XX.XX</InternetIp>
            <ExposureTypeId></ExposureTypeId>
            <ExposureIp>120.26.XX.XX</ExposureIp>
            <LaterVulCount>0</LaterVulCount>
            <RegionId>cn-hangzhou</RegionId>
      </ExposedInstances>
</DescribeExposedInstanceListResponse>

JSON格式 

{
	"PageInfo": {
		"TotalCount": 2,
		"PageSize": 20,
		"CurrentPage": 1,
		"Count": 2
	},
	"RequestId": "598A4A61-ABA7-456B-8725-7378258276D9",
	"ExposedInstances": [
		{
			"TotalVulCount": 0,
			"GroupName": "未分组",
			"ExposureType": "INTERNET_IP",
			"InstanceId": "i-bp1g6wxdwps7s9dz****",
			"ExposureComponent": "openssh",
			"ExposurePort": "22",
			"AsapVulCount": 0,
			"NntfVulCount": 0,
			"IntranetIp": "172.16.XX.XX",
			"GroupId": 9535356,
			"InstanceName": "abc_centos7.2_005",
			"Uuid": "dd803d9e-a337-4add-9c5b-7d503e08****",
			"InternetIp": "47.114.XX.XX",
			"ExposureTypeId": "",
			"ExposureIp": "47.114.XX.XX",
			"LaterVulCount": 0,
			"RegionId": "cn-hangzhou"
		},
		{
			"TotalVulCount": 0,
			"GroupName": "未分组",
			"ExposureType": "INTERNET_IP",
			"InstanceId": "i-bp1iy78ba3jgjyqp****",
			"ExposureComponent": "rdp",
			"ExposurePort": "3389",
			"AsapVulCount": 0,
			"NntfVulCount": 0,
			"IntranetIp": "172.16.XX.XX",
			"GroupId": 9535356,
			"InstanceName": "efd_centos7.2_005",
			"Uuid": "c9782b85-7015-4359-8b75-5e26f854****",
			"InternetIp": "120.26.XX.XX",
			"ExposureTypeId": "",
			"ExposureIp": "120.26.XX.XX",
			"LaterVulCount": 0,
			"RegionId": "cn-hangzhou"
		}
	]
}

错误码

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