Queries the information about servers that are exposed on the Internet.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

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:

  • true
  • false
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:

  • INTERNET_IP: the public IP address of an Elastic Compute Service (ECS) instance
  • SLB: the public IP address of a Server Load Balancer (SLB) instance
  • EIP: the elastic IP address (EIP)
  • DNAT: the Network Address Translation (NAT) gateway that connects to the Internet by using the Destination Network Address Translation (DNAT) feature
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.

  • If the value of the ExposureType parameter is INTERNET_IP, this parameter is empty.
  • If the value of the ExposureType parameter is SLB, the value of this parameter is the ID of the SLB instance.
  • If the value of the ExposureType parameter is EIP, the value of this parameter is the ID of the EIP.
  • If the value of the ExposureType parameter is DNAT, the value of this parameter is the ID of the NAT gateway.
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.