调用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 |
指定要查询的服务器是否存在漏洞。取值:
|
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 |
暴露方式。取值:
|
ExposureTypeId | String | i-ew11313a**** |
暴露方式对应的实例ID。不同暴露方式对应不同的实例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"
}
]
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交