Queries the attack surface statistics of your assets.

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 ListUserAttackSurfaceFacets

The operation that you want to perform. Set the value to ListUserAttackSurfaceFacets.

Response parameters

Parameter Type Example Description
DNSMap Struct

The DNS records of assets.

New Integer 10

The number of added DNS records.

Total Integer 20

The total number of DNS records.

Domains Struct

The domain names under your account.

New Integer 10

The number of added domain names.

Total Integer 20

The total number of domain names.

Hosts Struct

The hosts under your account.

New Integer 10

The number of added hosts.

Total Integer 20

The total number of hosts under your account.

Ports Struct

The ports opened on your hosts.

New Integer 10

The number of added ports.

Total Integer 20

The total number of ports opened on hosts.

RequestId String 714FE3CF-1755-440D-856A-97E8A082EE63

The ID of the request.

Subdomains Struct

The subdomains under your account.

New Integer 10

The number of added subdomains.

Total Integer 20

The total number of subdomains under your account.

WebPaths Struct

The web file paths of your websites.

New Integer 10

The number of added web file paths.

Total Integer 20

The total number of web file paths.

WebTechs Struct

The web applications used in all your websites.

New Integer 10

The number of added web applications.

Total Integer 20

The total number of web applications in all your websites.

Examples

Sample requests

http(s)://[Endpoint]/?Action=ListUserAttackSurfaceFacets
&<Common request parameters>

Sample success responses

XML format

<ListUserAttackSurfaceFacetsResponse>
  <DNSMap>
        <New>37097</New>
        <Total>37097</Total>
  </DNSMap>
  <WebPaths>
        <New>5599</New>
        <Total>5599</Total>
  </WebPaths>
  <Subdomains>
        <New>193901</New>
        <Total>193901</Total>
  </Subdomains>
  <RequestId>FED005E5-833F-4C61-AF07-B0C8AF03A554</RequestId>
  <WebTechs>
        <New>33177</New>
        <Total>33177</Total>
  </WebTechs>
  <Hosts>
        <New>603</New>
        <Total>603</Total>
  </Hosts>
  <Domains>
        <New>57</New>
        <Total>57</Total>
  </Domains>
  <Ports>
        <New>2417</New>
        <Total>2417</Total>
  </Ports>
</ListUserAttackSurfaceFacetsResponse>

JSON format

{
    "DNSMap": {
        "New": 37097,
        "Total": 37097
    },
    "WebPaths": {
        "New": 5599,
        "Total": 5599
    },
    "Subdomains": {
        "New": 193901,
        "Total": 193901
    },
    "RequestId": "FED005E5-833F-4C61-AF07-B0C8AF03A554",
    "WebTechs": {
        "New": 33177,
        "Total": 33177
    },
    "Hosts": {
        "New": 603,
        "Total": 603
    },
    "Domains": {
        "New": 57,
        "Total": 57
    },
    "Ports": {
        "New": 2417,
        "Total": 2417
    }
}

Error codes

For a list of error codes, visit the API Error Center.