Queries the information about servers that are exposed on the Internet.
Debugging
Request parameters
| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
| Action | String | Yes | DescribeExposedInstanceList |
The operation that you want to perform. Set the value to DescribeExposedInstanceList. |
| PageSize | Integer | No | 20 |
The number of entries to return on each page. Default value: 20. If you leave this parameter empty, 20 entries will be returned. Note We recommend that you do not leave this parameter empty.
|
| CurrentPage | Integer | No | 1 |
The page number of the current page. |
| GroupId | Long | No | 9535356 |
The ID of the server group. Note You can call the DescribeAllGroups operation to query the IDs of server groups.
|
| VulStatus | Boolean | No | true |
Specifies whether the servers have vulnerabilities. Valid values:
|
| ExposureComponent | String | No | openssl |
The server component that is exposed on the Internet. |
| ExposurePort | String | No | 22 |
The port that is exposed on the Internet. |
| ExposureIp | String | No | 116.12.XX.XX |
The public IP address of the server. |
| InstanceId | String | No | i-bp1g6wxdwps7s9dz**** |
The ID of the server. |
| InstanceName | String | No | abc_centos7.2_005 |
The name of the server. |
All Alibaba Cloud API operations must include common request parameters. For more information about common request parameters, see Common parameters.
For more information about sample requests, see the "Examples" section of this topic.
Response parameters
| Parameter | Type | Example | Description |
|---|---|---|---|
| ExposedInstances | Array of ExposedInstance |
The details of the exposures. |
|
| AsapVulCount | Integer | 0 |
The number of high-risk vulnerabilities that are exposed on the Internet and can be exploited by attackers. |
| ExposureComponent | String | openssl,openssh |
The server component that is exposed on the Internet. |
| ExposureIp | String | 116.12.XX.XX |
The public IP address that is exposed to the Internet. |
| ExposurePort | String | 22 |
The port that is exposed on the Internet. |
| ExposureType | String | INTERNET_IP |
The resource from which the asset is exposed. Valid values:
|
| ExposureTypeId | String | i-ew11313a**** |
The ID of the instance to which the resource belongs. The valid values of this parameter vary based on the ExposureType parameter.
|
| GroupId | Long | 9469268 |
The ID of the server group. |
| GroupName | String | Ungrouped |
The name of the server group. |
| InstanceId | String | i-bp1g6wxdwps7s9dz**** |
The ID of the server. |
| InstanceName | String | abc_centos7.2_005 |
The name of the server. |
| InternetIp | String | 116.12.XX.XX |
The public IP address of the server. |
| IntranetIp | String | 192.168.XX.XX |
The private IP address of the server. |
| LaterVulCount | Integer | 0 |
The number of medium-risk vulnerabilities that are exposed on the Internet and can be exploited by attackers. |
| NntfVulCount | Integer | 0 |
The number of low-risk vulnerabilities that are exposed on the Internet and can be exploited by attackers. |
| RegionId | String | cn-hangzhou |
The ID of the region where the server resides. Note For more information about the mapping between the region IDs and region names, see
Regions and zones.
|
| TotalVulCount | Integer | 0 |
The total number of vulnerabilities that are exposed on the Internet and can be exploited by attackers. |
| Uuid | String | dd803d9e-a337-4add-9c5b-7d503e08**** |
The UUID of the server. |
| PageInfo | Struct |
The page information. |
|
| Count | Integer | 2 |
The number of entries returned on the current page. |
| CurrentPage | Integer | 1 |
The page number of the current page. |
| PageSize | Integer | 20 |
The number of entries returned per page. |
| TotalCount | Integer | 2 |
The total number of entries about the servers that are exposed on the Internet. |
| RequestId | String | 598A4A61-ABA7-456B-8725-7378258276D9 |
The ID of the request. |
Examples
Sample requests
http(s)://[Endpoint]/? Action=DescribeExposedInstanceList
&<Common request parameters>Sample success responses
XML format
<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>Ungrouped</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>Ungrouped</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 format
{
"PageInfo": {
"TotalCount": 2,
"PageSize": 20,
"CurrentPage": 1,
"Count": 2
},
"RequestId": "598A4A61-ABA7-456B-8725-7378258276D9",
"ExposedInstances": [
{
"TotalVulCount": 0,
"GroupName": "Ungrouped",
"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": "Ungrouped",
"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"
}
]
}Error codes
For a list of error codes, visit the API Error Center.