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

错误码

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