EdgeCenter DNS
EdgeCenter API token setup: create a permanent EdgeCenter token with Users for preview or Engineers for DNS changes.
On this page
EdgeCenter API token permissions
- Credential type
- Permanent API token
- Preview access
- **Users**
- Apply access
- **Engineers**
- API endpoint
- DNSMigrator uses the provider's fixed API endpoint.
Additional access
DNSControl id
This provider does not have a DNSControl id.
Create credentials
Create a permanent EdgeCenter token with Users for preview or Engineers for DNS changes.
Access you'll grant
Users
Engineers
Before you start
- An EdgeCenter account with a paid DNS plan or active two-week DNS trial.
- A token issuer whose role is at least as high as the role selected for the token.
Setup steps
0 of 5 done
Open API tokens
Sign in to the EdgeCenter account, select the gear icon, and open API-токены (API tokens).
Start a permanent token
Select Создать токен (Create token), enter the token name, and optionally add a description.
Choose the role and expiry
Under Роль, choose Users for preview only or Engineers for apply. Under Срок действия, choose Бессрочный or Задать срок действия and a date that covers the migration.
Preview roleUsersApply roleEngineersCreate and copy the token
Select Создать, copy the generated token immediately, then select Ок, токен скопирован. EdgeCenter displays the secret only once.
Paste the token
Paste the value into Permanent API token here. A token can contain
$, as in7711$…; do not include theAPIKeyauthorization prefix.
Troubleshooting
EdgeCenter rejects the token
Paste the complete one-time token without the APIKey prefix and check that it has not expired or been deleted.
Preview works but apply is forbidden
A Users token is view-only for product settings. Create an Engineers token for DNS changes.
The issuer cannot select Engineers
A user can create only an equal or lower-role token. Ask an Engineers or Administrators user to issue it.
DNS is unavailable in the account
Activate a paid DNS plan or the two-week DNS trial before connecting the provider.
Official documentation
- Create a permanent API token
- User roles and rights
- EdgeCenter API documentation
- EdgeCenter DNS plans and trial
Guide checked against the official documentation on .
Credential fields
| Field | Requirement | Where to find it |
|---|---|---|
| Permanent API tokenapiToken | Required | The permanent token displayed only once after Создать; paste the token value without APIKey. |
Capabilities
- Create zones
- Yes
- List zones
- Yes
- DNSSEC
- Managed through the API
- Minimum TTL
- 60 seconds
- Apex CNAME
- No
- Read only
- No
Record types
- A
- AAAA
- CNAME
- MX
- TXT
- NS
- SRV
- CAA
- DNAME
Caveats
- Record sets that use GeoDNS, weighted balancing or DNS Failover filters, answer metadata or disabled answers are copied as plain answers and never changed by us.
- The API allows about 4 requests per second, so large zones are written one record set at a time.
- The minimum TTL depends on your EdgeCenter plan (usually 60 seconds); lower values are rejected by EdgeCenter.
- ALIAS, PTR, HTTPS and SVCB records aren't available, and a CNAME can't sit at the zone apex.
Troubleshooting
- EdgeCenter rejects the token
- Paste the complete one-time token without the APIKey prefix and check that it has not expired or been deleted.
- Preview works but apply is forbidden
- A Users token is view-only for product settings. Create an Engineers token for DNS changes.
- The issuer cannot select Engineers
- A user can create only an equal or lower-role token. Ask an Engineers or Administrators user to issue it.
- DNS is unavailable in the account
- Activate a paid DNS plan or the two-week DNS trial before connecting the provider.