Personal tools

From HEXONET Wiki

Jump to: navigation, search
(removed obsolete content)
 
(7 intermediate revisions by one user not shown)
Line 1: Line 1:
{{Sidebar}}
+
#REDIRECT [[DNS_API]]
<div style="font-size: 150%;">'''Premium DNS'''</div><br/>
+
<p>
+
 
+
{{Warnbox|The DNS API has been extended to support new Premium DNS service starting on October 15, 2018. Current DNS zone system will continue to work unchanged and unaffected until October 15, 2019. Please make sure to read accordingly to see how the new changes will affect your DNS zone system.}}
+
 
+
HEXONET's Premium DNS is a powerful, yet simple DNS solution that is built on our brand new, globally connected Anycast DNS network. Our highly-reliable Premium DNS service can optimize your DNS resolution, leading to faster response rates for your website and ensuring that your website is always responsive with our globally accessible DNS network. On top of that, Premium DNS adds multiple layers of security and protection against cybersecurity threats such as DDoS attacks. With today's standard on faster speed, tighter security and websites that are always accessible, Premium DNS is a must-have for anyone with a personal website, business, e-commerce and more! Read below to learn more about Premium DNS.
+
 
+
= Features =
+
* DNSSEC support
+
* Analytics dashboard to track DNS traffic
+
* Access to DNS traffic query log for up to one year
+
* 99.99% SLA
+
 
+
= Upgrade Policy =
+
=== Upgrade from Basic DNS to Premium DNS ===
+
DNS zone will be upgraded to a new Premium DNS plan with an expiration date set to 1 year after the upgrade.
+
 
+
==== Upgrade using API ====
+
You can upgrade from Basic DNS to Premium DNS with the following command
+
 
+
<pre>
+
COMMAND = CreatePremiumDNS
+
DNSZONE = (DNS zone name)
+
CLASS = (Premium DNS plan)
+
</pre>
+
 
+
==== Upgrade using Control Panel ====
+
 
+
1. Go to DNS Service > Basic DNS Zones and click on Manage for the selected DNS zone.
+
 
+
[[File:Upgradebasic-1.png]]
+
 
+
2. Click on Upgrade to Premium DNS and select your new Premium DNS plan. 
+
 
+
[[File:Upgradebasic-2.png]]
+
 
+
3. Click on Upgrade to create an order in the Shopping cart.
+
 
+
[[File:Upgradebasic-3.png]]
+
 
+
4. Your DNS zone will immediately upgrade to Premium DNS once you've completed the purchase transaction.
+
 
+
=== Upgrade Premium DNS zone to a higher tiered plan ===
+
Credit refund will be calculated based on the number of months left for existing Premium DNS plan. DNS zone will then be upgraded to a higher tiered plan, which will be registered for 1 year starting on the day of upgrade.
+
 
+
{{Warnbox|Note, it is not possible to change Premium DNS zone to a lower tiered plan while the current plan is still ongoing such as changing from a Premium 15M plan to a Premium 5M plan. Instead, you must wait for the current plan to expire and create a new DNS zone with the lower tiered Premium DNS plan.}}
+
 
+
==== Upgrade using API ====
+
 
+
You can upgrade Premium DNS zone to another Premium DNS plan with the following command
+
 
+
<pre>
+
COMMAND = UpgradePremiumDNS
+
CLASS = (Premium DNS plan)
+
OBJECTID = (Premium DNS object ID)
+
</pre>
+
 
+
To get the OBJECTID for your Premium DNS zone, use the following command
+
 
+
<pre>
+
[COMMAND]
+
COMMAND = StatusDNSZone
+
DNSZONE = (DNS zone name)
+
EOF
+
 
+
[RESPONSE]
+
PROPERTY[PREMIUMDNS][0] = (Premium DNS object ID)
+
EOF
+
</pre>
+
 
+
==== Upgrade using Control Panel ====
+
 
+
1. Go to DNS Service > Premium DNS Zones and click on Manage for the selected DNS zone.
+
 
+
[[File:Upgradepremium-1.png]]
+
 
+
2. Click on Change plan and select your new Premium DNS plan.
+
 
+
[[File:Upgradepremium-2.png]]
+
 
+
3. Click on Upgrade to create an order in the Shopping cart.
+
 
+
[[File:Upgradepremium-3.png]]
+
 
+
4. Your DNS zone will immediately upgrade to a new Premium DNS plan once you've completed the purchase transaction.
+
 
+
= Over Limit and Suspension Policy =
+
The monthly query usage of DNS zone is calculated based on the calendar month, not by the created date of the zone. A DNS zone query counter will reset to zero on the 1st of every calendar month. For example, if a DNS zone was created on March 15th, 2018 with a Premium 2M plan,
+
 
+
{| class="wikitable" style="width:100% !important"
+
|-
+
! scope="col" style="text-align:left; border:1px solid darkgray" | Monthly cycle
+
! scope="col" style="text-align:left; border:1px solid darkgray" | Description
+
|-
+
| style="text-align:left" | March 2018 || The zone is allowed to make 2 million queries in total starting from March 15th, 2018 (created date) to March 31st, 2018.
+
|-
+
| style="text-align:left" | April 2018 to February 2019 || The zone is allowed to make 2 million queries in total each month, starting from the 1st to the end of the current month
+
|-
+
| style="text-align:left" | March 2019 || The zone is allowed to make 2 million queries in total starting from March 1st, 2019 to March 14th, 2019 (expiration date)
+
|}
+
 
+
If a DNS zone exceeds the query limit before the end of the calendar month, the following over limit and suspension policy will apply:
+
 
+
{| class="wikitable" style="width:100% !important"
+
|-
+
! style="width:150px; border:1px solid darkgray" | Over limit
+
| style="padding: 5px" |  Once the DNS zone exceeds the monthly query limit, the user must upgrade to a higher tiered plan within 72 hours. Failing to do so will result in an immediate suspension of the DNS zone.
+
<br>
+
An email notice will be sent to the user regarding this event.
+
|-
+
! style="border:1px solid darkgray" | Suspension
+
| style="padding: 5px" | If the DNS zone is not upgraded within 72 hours after exceeding the monthly query limit, the DNS zone will be suspended and will not resolve any further queries.
+
<br>
+
An email notice will be sent to the user regarding this event.
+
|}
+
 
+
=== How to restore suspended Premium DNS zone ===
+
Once a Premium DNS zone is suspended, a user can do one of the following to restore the zone:
+
 
+
* Upgrade to a higher tiered plan to immediately restore the zone, or
+
* Wait for an automated restore at the start of the following month. Note, query counter is always reset at the beginning of each month so all DNS zones that were suspended in the previous month will be automatically restored due to the counter reset.
+
 
+
See [https://wiki.hexonet.net/wiki/Premium_DNS#Upgrade_Premium_DNS_zone_to_a_higher_tiered_plan Upgrade Premium DNS zone to a higher tiered plan] on how to immediately restore suspended Premium DNS zone.
+
 
+
=== Warning status using Control Panel ===
+
There are 4 warning types for Premium DNS zone in the Control Panel
+
 
+
{| class="wikitable" style="width:100% !important"
+
|-
+
! scope="col" style="width:120px; text-align:left; border:1px solid darkgray" | Warning type
+
! scope="col" style="text-align:left; border:1px solid darkgray" | Description
+
|-
+
| style="text-align:left" | High usage rate warning || Triggered if the Premium DNS zone is expected to exceed the monthly query limit, which is determined based on the current query usage rate.
+
|-
+
| style="text-align:left" | 80% usage warning  || Triggered if the Premium DNS zone uses 80% of the monthly query limit before the end of the calendar month.
+
|-
+
| style="text-align:left" | 100% usage warning || Triggered if the Premium DNS zone uses 100% of the monthly query limit before the end of the calendar month. Following the over limit policy, the user must upgrade to a higher tiered plan within 72 hours. Otherwise, the DNS zone will be immediately suspended.
+
<br>
+
The user will also receive an email notice for this event.
+
|-
+
| style="text-align:left" | Suspension warning || Triggered if the Premium DNS zone is not upgraded within 72 hours after exceeding query quota, leading to a subsequent suspension of the DNS zone. Any queries to the DNS zone will stop resolving.
+
<br>
+
The user will also receive an email notice for this event.
+
|}
+
 
+
=== Warning status using API ===
+
You can determine the warning status of Premium DNS zone with the following command:
+
 
+
<pre>
+
COMMAND = StatusDNSZone
+
DNSZONE = (DNS zone name)
+
</pre>
+
 
+
The command will return QUERY-QUOTA-STATUS to represent the warning status of DNS zone:
+
 
+
{| class="wikitable" style="width:100% !important"
+
|-
+
! scope="col" style="width:120px; text-align:left; border:1px solid darkgray" | QUERY-QUOTA-STATUS
+
! scope="col" style="text-align:left; border:1px solid darkgray" | Warning status of DNS zone
+
|-
+
| style="text-align:left" | OK || No warning issued for DNS zone
+
|-
+
| style="text-align:left" | WARNING  || The DNS zone has used 80% of its monthly query limit and is at risk of exceeding the monthly query limit.
+
|-
+
| style="text-align:left" | EXCEEDED || The DNS zone has used 100% of its monthly query limit. User has 72 hours to upgrade to a higher tiered plan. Otherwise, the DNS zone will be suspended.
+
|-
+
| style="text-align:left" | SUSPENDED || The DNS zone is suspended and will stop resolving to any queries
+
|}
+
 
+
The command will also return 3 other properties that will allow you to keep track of the DNS zone's query count:
+
 
+
{| class="wikitable" style="width:100% !important"
+
|-
+
! scope="col" style="width:120px; text-align:left; border:1px solid darkgray" | Properties
+
! scope="col" style="text-align:left; border:1px solid darkgray" | Description
+
|-
+
| style="text-align:left" | QUERY-QUOTA-COUNT || Query count for the current month
+
|-
+
| style="text-align:left" | QUERY-QUOTA-PREDICTION  || Expected query count for the whole month, which is dynamically calculated based on current quota count
+
|-
+
| style="text-align:left" | QUERY-QUOTA-LIMIT || Monthly query limit of the DNS zone
+
|}
+
 
+
= Manage Legacy DNS Zones =
+
All DNS zones that were created before October 15th, 2018 will be classified as Legacy DNS zones. These DNS zones will continue to operate unaffected and unchanged. However, Legacy DNS zones will only be available until October 15th, 2019. Operation and migration of Legacy DNS zones are as follows:
+
 
+
<b><u>Legacy DNS zone where HEXONET is the registrar of the domain:</u></b>
+
 
+
These DNS zones will continue to operate unaffected and unchanged under the original agreed terms and conditions until October 15th, 2019. After the one-year grace period, these DNS zones that have not been upgraded to Premium DNS will be automatically (and without charge) converted to DNS zones under the new and free Basic DNS terms and conditions. The following apply:
+
 
+
* Customers can convert and upgrade these Legacy DNS zones into the paid Premium DNS at anytime during the year.
+
* If the respective domain name for a Legacy DNS zone is transferred to another registrar or expires during the one-year grace period, the DNS zone will be permanently deleted. 
+
 
+
<b><u>Legacy DNS zone where HEXONET is NOT the registrar of the domain (External):</u></b>
+
 
+
These DNS zones will continue to operate unaffected and unchanged under the original agreed terms and conditions until October 15th, 2019, including the monthly service fees. After the one-year grace period, these DNS zones that have not been upgraded to Premium DNS will be automatically deleted (only Premium DNS allows for DNS zones with domain names registered at other registrars). The following apply:
+
 
+
* Customers can convert and upgrade these Legacy DNS zones into the paid Premium DNS at anytime during the year.
+
 
+
{{Warnbox|Once upgraded to Premium DNS, the DNS zone will no longer be classified as a Legacy DNS zone and the new Premium DNS zone cannot be reverted back to Legacy DNS zone.}}
+
 
+
=== Using Control Panel ===
+
Legacy DNS zones will be listed under DNS Service > Legacy DNS Zones
+
 
+
[[File:Legacyzone.png]]
+
 
+
=== Using API ===
+
You can see all of your Legacy DNS zones with the following command:
+
 
+
<pre>
+
COMMAND = QueryDNSZoneList
+
MAXCREATEDDATE = 2018-10-01
+
PREMIUMDNSCLASS = !*
+
PROPERTIES = PREMIUMDNS
+
WIDE = 1
+
USERDEPTH = Self
+
</pre>
+
 
+
You can upgrade your Legacy DNS zone to Premium DNS with the following command:
+
 
+
<pre>
+
COMMAND = CreatePremiumDNS
+
DNSZONE = (DNS zone name)
+
CLASS = (Premium DNS plan)
+
</pre>
+
 
+
= How to Use and Monitor DNS Analytics =
+
{{Warnbox|Note, analytics is not available in OTE.}}
+
 
+
=== Using Control Panel ===
+
 
+
1. Go to DNS Service > Premium DNS Zones and click on Manage for the selected DNS zone.
+
 
+
[[File:Analytics-1.png]]
+
 
+
 
+
2. Click on View analytics.
+
 
+
[[File:Analytics-2.png]]
+
 
+
=== Using API ===
+
You can get the query log for a Premium DNS zone with the following command
+
 
+
<pre>
+
COMMAND = QueryDNSZoneStats
+
DNSZONE = (DNS zone name)
+
PERIODICITY = HOURLY | DAILY | MONTHLY
+
</pre>
+
 
+
The command will return the date, error count and response count for each query, given the selected time frame.
+
 
+
<pre>
+
[RESPONSE]
+
CODE = 200
+
DESCRIPTION = Command completed successfully
+
PROPERTY[DATE][0] = 2018-09-02
+
PROPERTY[DATE][1] = 2018-09-03
+
PROPERTY[DATE][2] = 2018-09-04
+
PROPERTY[DATE][3] = 2018-09-05
+
PROPERTY[DATE][4] = 2018-09-06
+
PROPERTY[ERROR-COUNT][0] = 15
+
PROPERTY[ERROR-COUNT][1] = 9
+
PROPERTY[ERROR-COUNT][2] = 7
+
PROPERTY[ERROR-COUNT][3] = 5
+
PROPERTY[ERROR-COUNT][4] = 19
+
PROPERTY[RESPONSE-COUNT][0] = 38
+
PROPERTY[RESPONSE-COUNT][1] = 20
+
PROPERTY[RESPONSE-COUNT][2] = 14
+
PROPERTY[RESPONSE-COUNT][3] = 16
+
PROPERTY[RESPONSE-COUNT][4] = 42
+
EOF
+
</pre>
+

Latest revision as of 09:40, 24 September 2021

  1. REDIRECT DNS_API