All Products
Search

This Product

    Edge Security Acceleration:TraceSite

    Document Center

    Edge Security Acceleration:TraceSite

    Last Updated:Aug 07, 2026

    Performs Tracing Analysis. You can use this operation to construct and initiate an impersonation HTTP/HTTPS request to the ESA platform, displaying the site configuration matching and effective settings on the ESA platform for the request.

    Operation description

    Important Before you use this operation, make sure that the site is connected to the ESA platform and enabled.

    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
    Url

    string

    Yes

    The URL of the request.

    http://example.com/test
    Protocol

    string

    No

    The HTTP protocol.

    Valid values:

    • HTTP/1.0 :

      HTTP/1.0

    • HTTP/3 :

      HTTP/3

    • HTTP/1.1 :

      HTTP/1.1

    • HTTP/2 :

      HTTP/2

    HTTP/1.1
    Method

    string

    No

    The HTTP method.

    Valid values:

    • DELETE :

      DELETE

    • POST :

      POST

    • GET :

      GET

    • OPTIONS :

      OPTIONS

    • PUT :

      PUT

    • PATCH :

      PATCH

    GET
    Headers

    array<object>

    No

    The request headers.

    []

    object

    No

    The request headers.

    Name

    string

    No

    The HTTP request header name.

    User-Agent
    Value

    string

    No

    The HTTP request header value.

    trace-test
    Cookies

    array<object>

    No

    The cookie parameters.

    []

    object

    No

    The cookie parameters.

    Name

    string

    No

    The cookie name.

    sessionId
    Value

    string

    No

    The cookie value.

    f9ca1f7d-15bb-4c60-ad99-71b8e3e4985b
    Context

    object

    No

    The environment context. This parameter is optional.

    GeoLocation

    object

    No

    The simulated geolocation information.

    CountryCode

    string

    No

    The country/region code.

    Valid values:

    • PR :

      Puerto Rico.

    • PS :

      Palestine.

    • PT :

      Portugal.

    • PW :

      Palau.

    • PY :

      Paraguay.

    • QA :

      Qatar.

    • AC :

      Ascension Island.

    • AD :

      Andorra.

    • AE :

      United Arab Emirates.

    • AF :

      Afghanistan.

    • AG :

      Antigua and Barbuda.

    • AI :

      Anguilla.

    • AL :

      Albania.

    • AM :

      Armenia.

    • AN :

      Netherlands Antilles.

    • AO :

      Angola.

    • AR :

      Argentina.

    • AS :

      American Samoa.

    • AT :

      Austria.

    • RE :

      Réunion.

    • AU :

      Australia.

    • AW :

      Aruba.

    • AX :

      Åland Islands.

    • AZ :

      Azerbaijan.

    • RO :

      Romania.

    • BA :

      Bosnia and Herzegovina.

    • BB :

      Barbados.

    • RS :

      Serbia.

    • BD :

      Bangladesh.

    • BE :

      Belgium.

    • RU :

      Russia.

    • BF :

      Burkina Faso.

    • BG :

      Bulgaria.

    • RW :

      Rwanda.

    • BH :

      Bahrain.

    • BI :

      Burundi.

    • BJ :

      Benin.

    • BL :

      Saint Barthélemy.

    • BM :

      Bermuda.

    • BN :

      Brunei.

    • BO :

      Bolivia.

    • SA :

      Saudi Arabia.

    • BQ :

      Bonaire, Sint Eustatius and Saba.

    • SB :

      Solomon Islands.

    • BR :

      Brazil.

    • SC :

      Seychelles.

    • BS :

      Bahamas.

    • SD :

      Sudan.

    • BT :

      Bhutan.

    • SE :

      Sweden.

    • BV :

      Bouvet Island.

    • SG :

      Singapore.

    • BW :

      Botswana.

    • SH :

      Saint Helena.

    • SI :

      Slovenia.

    • BY :

      Belarus.

    • SJ :

      Svalbard and Jan Mayen.

    • BZ :

      Belize.

    • SK :

      Slovakia.

    • SL :

      Sierra Leone.

    • SM :

      San Marino.

    • SN :

      Senegal.

    • SO :

      Somalia.

    • CA :

      Canada.

    • SR :

      Suriname.

    • CC :

      Cocos (Keeling) Islands.

    • SS :

      South Sudan.

    • CD :

      Democratic Republic of the Congo.

    • ST :

      São Tomé and Príncipe.

    • CF :

      Central African Republic.

    • SV :

      El Salvador.

    • CG :

      Republic of the Congo.

    • CH :

      Switzerland.

    • SX :

      Sint Maarten.

    • CI :

      Côte d'Ivoire.

    • SZ :

      Eswatini.

    • CK :

      Cook Islands.

    • CL :

      Chile.

    • CM :

      Cameroon.

    • CN :

      the Chinese mainland.

    • CO :

      Colombia.

    • CR :

      Costa Rica.

    • TC :

      Turks and Caicos Islands.

    • TD :

      Chad.

    • TF :

      French Southern Territories.

    • CV :

      Cape Verde.

    • TG :

      Togo.

    • TH :

      Thailand.

    • CW :

      Curaçao.

    • CX :

      Christmas Island.

    • TJ :

      Tajikistan.

    • CZ :

      Czech Republic.

    • TK :

      Tokelau.

    • TL :

      Timor-Leste.

    • TM :

      Turkmenistan.

    • TN :

      Tunisia.

    • TO :

      Tonga.

    • TR :

      Turkey.

    • TT :

      Trinidad and Tobago.

    • DE :

      Germany.

    • TV :

      Tuvalu.

    • DJ :

      Djibouti.

    • TZ :

      Tanzania.

    • DK :

      Denmark.

    • DM :

      Dominica.

    • DO :

      Dominican Republic.

    • UA :

      Ukraine.

    • UG :

      Uganda.

    • DZ :

      Algeria.

    • UM :

      United States Minor Outlying Islands.

    • EC :

      Ecuador.

    • US :

      United States.

    • EE :

      Estonia.

    • EG :

      Egypt.

    • EH :

      Western Sahara.

    • UY :

      Uruguay.

    • UZ :

      Uzbekistan.

    • VA :

      Vatican City.

    • ER :

      Eritrea.

    • VC :

      Saint Vincent and the Grenadines.

    • ES :

      Spain.

    • ET :

      Ethiopia.

    • VE :

      Venezuela.

    • VG :

      British Virgin Islands.

    • VI :

      U.S. Virgin Islands.

    • VN :

      Vietnam.

    • VU :

      Vanuatu.

    • FI :

      Finland.

    • FJ :

      Fiji.

    • FK :

      Falkland Islands.

    • FM :

      Micronesia.

    • FO :

      Faroe Islands.

    • FR :

      France.

    • WF :

      Wallis and Futuna.

    • GA :

      Gabon.

    • GB :

      United Kingdom.

    • WS :

      Samoa.

    • GD :

      Grenada.

    • GE :

      Georgia.

    • GF :

      French Guiana.

    • GG :

      Guernsey.

    • GH :

      Ghana.

    • GI :

      Gibraltar.

    • GL :

      Greenland.

    • GM :

      Gambia.

    • GN :

      Guinea.

    • GP :

      Guadeloupe.

    • GQ :

      Equatorial Guinea.

    • GR :

      Greece.

    • GS :

      South Georgia and the South Sandwich Islands.

    • GT :

      Guatemala.

    • GU :

      Guam.

    • GW :

      Guinea-Bissau.

    • GY :

      Guyana.

    • HK :

      Hong Kong (China)

    • HM :

      Heard Island and McDonald Islands.

    • HN :

      Honduras.

    • HR :

      Croatia.

    • HT :

      Haiti.

    • YE :

      Yemen.

    • HU :

      Hungary.

    • ID :

      Indonesia.

    • YT :

      Mayotte.

    • IE :

      Ireland.

    • IL :

      Israel.

    • IM :

      Isle of Man.

    • IN :

      India.

    • IO :

      British Indian Ocean Territory.

    • ZA :

      South Africa.

    • IQ :

      Iraq.

    • IS :

      Iceland.

    • IT :

      Italy.

    • ZM :

      Zambia.

    • JE :

      Jersey.

    • ZW :

      Zimbabwe.

    • JM :

      Jamaica.

    • JO :

      Jordan.

    • JP :

      Japan.

    • KE :

      Kenya.

    • KG :

      Kyrgyzstan.

    • KH :

      Cambodia.

    • KI :

      Kiribati.

    • KM :

      Comoros.

    • KN :

      Saint Kitts and Nevis.

    • KR :

      South Korea.

    • KW :

      Kuwait.

    • KY :

      Cayman Islands.

    • KZ :

      Kazakhstan.

    • LA :

      Laos.

    • LB :

      Lebanon.

    • LC :

      Saint Lucia.

    • LI :

      Liechtenstein.

    • LK :

      Sri Lanka.

    • LR :

      Liberia.

    • LS :

      Lesotho.

    • LT :

      Lithuania.

    • LU :

      Luxembourg.

    • LV :

      Latvia.

    • LY :

      Libya.

    • MA :

      Morocco.

    • MC :

      Monaco.

    • MD :

      Moldova.

    • ME :

      Montenegro.

    • MF :

      Saint Martin.

    • MG :

      Madagascar.

    • MH :

      Marshall Islands.

    • MK :

      North Macedonia.

    • ML :

      Mali.

    • MM :

      Myanmar.

    • MN :

      Mongolia.

    • MP :

      Northern Mariana Islands.

    • MQ :

      Martinique.

    • MR :

      Mauritania.

    • MS :

      Montserrat.

    • MT :

      Malta.

    • MU :

      Mauritius.

    • MV :

      Maldives.

    • MW :

      Malawi.

    • MX :

      Mexico.

    • MY :

      Malaysia.

    • MZ :

      Mozambique.

    • NA :

      Namibia.

    • NC :

      New Caledonia.

    • NE :

      Niger.

    • NF :

      Norfolk Island.

    • NG :

      Nigeria.

    • NI :

      Nicaragua.

    • NK :

      Nagorno-Karabakh.

    • NL :

      Netherlands.

    • NO :

      Norway.

    • NP :

      Nepal.

    • NR :

      Nauru.

    • NU :

      Niue.

    • NZ :

      New Zealand.

    • OM :

      Oman.

    • PA :

      Panama.

    • PE :

      Peru.

    • PF :

      French Polynesia.

    • PG :

      Papua New Guinea.

    • PH :

      Philippines.

    • PK :

      Pakistan.

    • PL :

      Poland.

    • PM :

      Saint Pierre and Miquelon.

    • PN :

      Pitcairn Islands.

    CN
    RegionCode

    string

    No

    The region or province code. This parameter is valid only when the country or region is the Chinese mainland.

    Valid values:

    • CN-XJ :

      Xinjiang Uygur Autonomous Region.

    • CN-GZ :

      Guizhou Province.

    • CN-CQ :

      Chongqing Municipality.

    • CN-ZJ :

      Zhejiang Province.

    • CN-GX :

      Guangxi Zhuang Autonomous Region.

    • CN-HB :

      Hubei Province.

    • CN-HE :

      Hebei Province.

    • CN-TJ :

      Tianjin Municipality.

    • CN-HA :

      Henan Province.

    • CN-SX :

      Shanxi Province.

    • CN-GS :

      Gansu Province.

    • CN-AH :

      Anhui Province.

    • CN-SH :

      Shanghai Municipality.

    • CN-YN :

      Yunnan Province.

    • CN-JX :

      Jiangxi Province.

    • CN-SC :

      Sichuan Province.

    • CN-SD :

      Shandong Province.

    • CN-SN :

      Shaanxi Province.

    • CN-GD :

      Guangdong Province.

    • CN-QH :

      Qinghai Province.

    • CN-JL :

      Jilin Province.

    • CN-LN :

      Liaoning Province.

    • CN-XZ :

      Tibet Autonomous Region.

    • CN-FJ :

      Fujian Province.

    • CN-HL :

      Heilongjiang Province.

    • CN-NM :

      Inner Mongolia Autonomous Region.

    • CN-HI :

      Hainan Province.

    • CN-NX :

      Ningxia Hui Autonomous Region.

    • CN-HN :

      Hunan Province.

    • CN-BJ :

      Beijing Municipality.

    • CN-JS :

      Jiangsu Province.

    CN-BJ
    IspCode

    string

    No

    The Internet service provider (ISP) code. This parameter is valid only when the country or region is the Chinese mainland.

    Valid values:

    • 100017 :

      China Telecom.

    • 100025 :

      China Mobile.

    • 100026 :

      China Unicom.

    100025
    SkipChallenge

    boolean

    No

    Specifies whether to skip the security challenge test.

    true
    Body

    object

    No

    The HTTP request body.

    {"PlainText":"bc58c54211db"}
    Json

    any

    No

    The content in JSON format. If both JSON format content and plain text content are specified, the JSON format content takes precedence.

    {"request_id","3f809c32"}
    PlainText

    string

    No

    The plain text content.

    bc58c54211db

    Response elements

    Element

    Type

    Description

    Example

    object

    Schema of Response

    RequestId

    string

    The request ID.

    9574AFDC-ABF1-5068-AAE3-6958CEBD8740
    StatusCode

    integer

    The HTTP status code of the request.

    200
    Trace

    array<object>

    The trace information of the call chain.

    array<object>

    The matching result of a feature module.

    StepModuleName

    string

    The feature module.

    Valid values:

    • WafRules :

      WAF

    • RedirectRules :

      redirect rules.

    • TransformRules :

      transform rules.

    • CacheRules :

      cache rules.

    • SmartRouting :

      smart routing.

    • SecRules :

      security rules.

    • LoadBalancers :

      load balancers.

    • RoutineRoutes :

      routine routes.

    • SiteVersion :

      site version.

    • DdosRules :

      DDos

    • BotRules :

      Bot

    SecRules
    Matched

    boolean

    Indicates whether the module is matched. Valid values: true and false.

    true
    Trace

    array<object>

    The matching results of rules in the feature module.

    object

    The matched rule information.

    RuleName

    string

    cache_test
    Expression

    string

    (ip.geoip.country eq \"CN\")
    RoutineId

    string

    test.1097011697834102
    Type

    string

    l4_ddos
    OriginPoolName

    string

    21212.origin-pool.example.com
    SiteVersion

    integer

    0
    EnvName

    string

    Production
    ConfigType

    string

    rule
    LoadBalancerName

    string

    Ib.test.example.com
    RuleId

    integer

    1297141
    Level

    string

    week
    DdosLevelDomestic

    string

    cn300
    DdosLevelOversea

    string

    unlimit
    Action

    string

    deny
    Value

    string

    1.1.1.1
    Success

    boolean

    Indicates whether the request was successful.

    true

    Examples

    Success response

    JSON format

    {
  "RequestId": "9574AFDC-ABF1-5068-AAE3-6958CEBD8740",
  "StatusCode": 200,
  "Trace": [
    {
      "StepModuleName": "SecRules",
      "Matched": true,
      "Trace": [
        {
          "RuleName": "cache_test",
          "Expression": "(ip.geoip.country eq \\\"CN\\\")",
          "RoutineId": "test.1097011697834102",
          "Type": "l4_ddos",
          "OriginPoolName": "21212.origin-pool.example.com",
          "SiteVersion": 0,
          "EnvName": "Production",
          "ConfigType": "rule",
          "LoadBalancerName": "Ib.test.example.com",
          "RuleId": 1297141,
          "Level": "week",
          "DdosLevelDomestic": "cn300",
          "DdosLevelOversea": "unlimit",
          "Action": "deny",
          "Value": "1.1.1.1"
        }
      ]
    }
  ],
  "Success": true
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidParameter The specified parameter is invalid. The specified parameter is invalid.
    400 InvalidURLParameter The URL you entered is invalid. Please check the records of the site or the status of the site.
    500 InternalError Failed to call the service. Try again later or contact technical support. Failed to call the service. Try again later or contact technical support.
    403 InvalidParameter.URL The domain name in the URL you entered does not belong to this account. Please try another URL.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.