You can run five operations for a Site Shield hostname:
- Test network connectivity with MTR,
- Request content with cURL,
- Run the URL health check,
- Run the Connectivity problems scenario,
- Run the Content problems scenario.
Test network connectivity with MTR is different from other operations as you run the request for specific test and target IPs of a hostname.
For other operations, you need to use the runFromSiteShield member to mark the URL of the request as a Site Shield hostname. With runFromSiteShield set to true, Edge Diagnostics verifies if a Site Shield map is available for the URL. However, depending on other provided data, Edge Diagnostics runs the request in different ways.
If you:
- Provide only
edgeLocationIdoredgeIp, Edge Diagnostics finds an edge server in that location or with that IP and uses it to run the operation. - Provide
edgeLocationIdand setrunFromSiteShieldtotrue, Edge Diagnostics finds the Site Shield machine in the location and runs the operation from there. - Only set
runFromSiteShieldtotrue, withoutedgeLocationIdnoredgeIp, Edge Diagnostics finds any Site Shield machine and uses it to run the operation.
ZAM hostnames and hostnames lacking a CNAME limitations for Site Shield requests
There are following limitations for Site Shield requests:
- The Request content with cURL, Run the URL health check, Run the connectivity problems scenario, and Run the content problems scenario operations don't support requests for zone apex mapped (ZAM) and hostnames lacking a CNAME when
runFromSiteShieldis set totrue.- The Test network connectivity with MTR operation doesn't support requests for Site Shield hostnames, if the hostname is a ZAM or a hostname lacking a CNAME.
