All Products
Search
Document Center

Anti-DDoS:DescribeDomainTopFingerprint

Last Updated:Mar 20, 2026

Queries the top N client fingerprints for a website.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

Region

string

Yes

Region where the service is deployed. Valid values:

  • cn: the Chinese mainland.

  • cn-hongkong: outside the Chinese mainland.

cn

Domain

string

No

Domain name of the website service.

Note

The domain must have an active website forwarding rule. To list all domains, call DescribeDomains.

example.aliyundoc.com

StartTime

integer

Yes

Start time of the query. Specify as a UNIX timestamp in seconds.

Note

The value must be on the hour or half hour.

1719211800

EndTime

integer

Yes

End time of the query. Specify as a UNIX timestamp in seconds.

Note

The value must be on the hour or half hour.

1723552200

Limit

integer

Yes

The returned data.

10

Interval

integer

Yes

Time interval between returned data points, in seconds.

60

QueryType

string

No

Response elements

Element

Type

Description

Example

object

RequestId

string

ID of the request. Alibaba Cloud generates a unique ID for each request. Use this ID to troubleshoot issues.

C33EB3D5-AF96-43CA-9C7E-37A81BC06A1E

DomainTopFp

array<object>

List of client fingerprints for the website.

object

A client fingerprint for the website.

Fingerprinting

string

Client fingerprint.

8a374c9724582b14a4cfa58c8c9fb2bc

Pv

integer

Number of matched requests.

22121

Domain

string

Domain name of the website service.

example.aliyundoc.com

Examples

Success response

JSON format

{
  "RequestId": "C33EB3D5-AF96-43CA-9C7E-37A81BC06A1E",
  "DomainTopFp": [
    {
      "Fingerprinting": "8a374c9724582b14a4cfa58c8c9fb2bc",
      "Pv": 22121,
      "Domain": "example.aliyundoc.com\n"
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.