调用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"
		}
	]
}

错误码

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