DNS Protection API¶
Manage DNS Protection configuration.
See the guide for a narrative walkthrough of this API.
Base URL¶
https://api-{dataRegion}.central.sophos.com/dns-protection/v2 — Regional service in the production environment.
| Variable | Description | Default | Allowed values |
|---|---|---|---|
dataRegion | Data region where tenant data is stored. | eu01 | eu01, eu02, us01, us03, ca01, au01, jp01, in01, br01 |
Authentication¶
Every request carries an Authorization: Bearer header with an access token obtained through the client-credentials flow — see Get started.
Required permissions¶
This API's operations require one or more of the following, depending on the operation — see each operation's own page for the exact requirement:
swgaas.config:read OR swgaas.config.dataplane:readswgaas.config:write
Operations¶
Custom Domains List¶
- List Custom Domains
GET/custom-domains - Create Custom Domain
POST/custom-domains - Get Custom Domain
GET/custom-domains/{id} - Update CDL by ID
PATCH/custom-domains/{id} - Delete CDL by ID
DELETE/custom-domains/{id}
Locations¶
- List Locations
GET/locations - Create Location
POST/locations - Get Location
GET/locations/{id} - Update Location
PATCH/locations/{id} - Delete Location
DELETE/locations/{id}
Policies¶
- List Policies
GET/policies - Create Policy
POST/policies - Get Policy
GET/policies/{id} - Update Policy
PATCH/policies/{id} - Delete Policy
DELETE/policies/{id}
Download¶