Suche in diesem Bereich
Table of Contents
Here we describe the notifications generated in context of an automatic domain update.
autoupdate_dns_success
Affects only TLDs with manual processing.
Description
Notification sent upon successful connectivity check.
Notification trigger
The process consists of 2 steps:
Step 1 is acknowledged with status code MSG01055 ("The domain was updated successfully, but the name server update is still pending.").
Step 2 is acknowledged with the notification type autoupdate_dns_success. This completes the manual process.
Recipient of the notification
The recipient of the notification is the AutoDNS user who started the job.
POLLING notification examples
JSON
{
"stid": "20210512-app3-dev-10824",
"status": {
"code": "S0905",
"text": "The notification was polled successfully.",
"type": "SUCCESS"
},
"object": {
"type": "Message",
"value": "1005491836",
"summary": 1
},
"data": [
{
"id": 1005491836,
"notify": {
"type": "autoupdate_dns_success"
},
"stid": "20210512-app3-dev-10782",
"object": {
"type": "Domain",
"value": "example.aq",
"data": {
"created": "2021-05-12T14:42:26.000+0200",
"owner": {
"context": 4,
"user": "normal_user"
},
"updater": {
"context": 1,
"user": "support"
},
"name": "example.aq",
"registryStatus": "ACTIVE",
"nameServers": [
{
"name": "ns1.examplenameserver.com"
},
{
"name": "ns2.examplenameserver.com"
}
],
"period": {
"unit": "YEAR",
"period": 1
},
"registrarStatus": "ACTIVE",
"rddsOptIn": "NOT_SET",
"techc": {
"id": 23252437
},
"zonec": {
"id": 23252437
},
"adminc": {
"id": 23252437
},
"ownerc": {
"id": 23252437
},
"action": "AUTOUPDATE_DNS",
"autoRenewStatus": "TRUE"
}
}
}
]
}
XML
<response>
<result>
<data>
<summary>1</summary>
<message>
<id>1005491836</id>
<owner>
<user>normal_user</user>
<context>4</context>
</owner>
<notify>
<domain>
<name>example.aq</name>
<ownerc>23252437</ownerc>
<adminc>23252437</adminc>
<techc>23252437</techc>
<zonec>23252437</zonec>
<nic_member_label>AQ-TEST</nic_member_label>
<registry_status>ACTIVE</registry_status>
<nserver>
<name>ns1.examplenameserver.com</name>
</nserver>
<nserver>
<name>ns2.examplenameserver.com</name>
</nserver>
<ip>1.2.3.4</ip>
<period>1</period>
<action>AUTOUPDATE_DNS</action>
<autorenew>true</autorenew>
<registrar_status>ACTIVE</registrar_status>
<rdds_opt_in>NOT_SET</rdds_opt_in>
<owner>
<user>normal_user</user>
<context>4</context>
</owner>
<updater>
<user>support</user>
<context>1</context>
</updater>
<created>2021-05-12 14:42:26</created>
</domain>
<type>autoupdate_dns_success</type>
<status>
<code>S0102</code>
<type>success</type>
</status>
<stid>20210512-app3-dev-10782</stid>
<created>2021-05-12 14:43:12</created>
</notify>
<created>2021-05-12 14:43:12</created>
</message>
</data>
<status>
<code>S0905</code>
<text>The notification was polled successfully.</text>
<type>success</type>
<object>
<type>message</type>
<value>1005491836</value>
</object>
</status>
</result>
<stid>20210512-app3-dev-10801</stid>
</response>
PUSH notification examples
JSON
{
"id": 1005491844,
"notify": {
"type": "autoupdate_dns_success"
},
"stid": "20210512-app3-dev-10965",
"object": {
"type": "Domain",
"value": "example.aq",
"data": {
"created": "2021-05-12T14:58:01.000+0200",
"owner": {
"context": 4,
"user": "normal_user"
},
"updater": {
"context": 1,
"user": "support"
},
"name": "example.aq",
"registryStatus": "ACTIVE",
"nameServers": [
{
"name": "ns1.examplenameserver.com"
},
{
"name": "ns2.examplenameserver.com"
}
],
"period": {
"unit": "YEAR",
"period": 1
},
"registrarStatus": "ACTIVE",
"rddsOptIn": "NOT_SET",
"adminc": {
"id": 23252437
},
"ownerc": {
"id": 23252437
},
"techc": {
"id": 23252437
},
"zonec": {
"id": 23252437
},
"action": "AUTOUPDATE_DNS",
"autoRenewStatus": "TRUE"
}
}
}
XML
message>
<domain>
<name>example.aq</name>
<ownerc>23252437</ownerc>
<adminc>23252437</adminc>
<techc>23252437</techc>
<zonec>23252437</zonec>
<nic_member_label>AQ-TEST</nic_member_label>
<registry_status>ACTIVE</registry_status>
<nserver>
<name>ns1.examplenameserver.com</name>
</nserver>
<nserver>
<name>ns2.examplenameserver.com</name>
</nserver>
<ip>1.2.3.4</ip>
<period>1</period>
<action>AUTOUPDATE_DNS</action>
<autorenew>true</autorenew>
<extension />
<registrar_status>ACTIVE</registrar_status>
<rdds_opt_in>NOT_SET</rdds_opt_in>
<owner>
<user>normal_user</user>
<context>4</context>
</owner>
<updater>
<user>support</user>
<context>1</context>
</updater>
<created>2021-05-12 14:51:49</created>
</domain>
<type>autoupdate_dns_success</type>
<status>
<code>S0102</code>
<type>success</type>
</status>
<id>1005491840</id>
<stid>20210512-app3-dev-10891</stid>
<created>2021-05-12 14:52:44</created>
</message>
autoupdate_dns_error
Description
This notification is sent upon successful execution of an automatic update. An automatic update is performed only if the connectivity check, which is a part of the registration process, has failed.
Only for .de domains.
Notification trigger
This notification is sent directly after a registration or transfer if the DNS check ("NAST check") of DENIC (.de) fails.
This notification is triggered in case of a transfer where name servers have an incorrectly configured zone or no zone for the domain. A general inaccessibility of the name servers also triggers this notification.
Recipient of the notification
The recipient of the notification is the AutoDNS user who started the job.
POLLING notification examples
JSON
{
"stid": "20220121-app3-dev-68409",
"status": {
"code": "S0905",
"text": "The notification was polled successfully.",
"type": "SUCCESS"
},
"object": {
"type": "Message",
"value": "1012057723",
"summary": 1
},
"data": [
{
"id": 1012057723,
"notify": {
"type": "autoupdate_dns_error"
},
"stid": "20220121-app2-dev-131365",
"notice": "53300102912\n53300102912\n53300102912\nNameserver error\n ERROR: 904 Port unreachable\n53300102912\nNameserver error\n ERROR: 902 Timeout (target, entity, rtype) (ns1.broken-nameserver.com./64.190.62.111:53, example.de, SoaRecord)\n13000000011\n",
"object": {
"type": "Domain",
"value": "example.de",
"data": {
"created": "2022-01-21T14:32:18.000+0100",
"owner": {
"context": 4,
"user": "customer"
},
"updater": {
"context": 1,
"user": "support"
},
"name": "example.de",
"registryStatus": "ACTIVE",
"nameServers": [
{
"name": "ns1.broken-nameserver.com"
},
{
"name": "ns2.broken-nameserver.com"
}
],
"period": {
"unit": "YEAR",
"period": 1
},
"registrarStatus": "ACTIVE",
"rddsOptIn": "NOT_SET",
"ownerc": {
"id": 21642636
},
"adminc": {
"id": 21642636
},
"techc": {
"id": 21642636
},
"zonec": {
"id": 21642636
},
"action": "AUTOUPDATE_DNS",
"autoRenewStatus": "TRUE"
}
}
}
]
}
XML
response> <result> <data> <summary>1</summary> <message> <id>1012057852</id> <owner> <user>customer</user> <context>4</context> </owner> <notify> <domain> <name>example.de</name> <ownerc>21642636</ownerc> <adminc>21642636</adminc> <techc>21642636</techc> <zonec>21642636</zonec> <nic_member_label>DE-TEST</nic_member_label> <registry_status>ACTIVE</registry_status> <nserver> <name>ns1.nameserver-broken.com</name> </nserver> <nserver> <name>ns2.nameserver-broken.com</name> </nserver> <ip>1.2.3.4</ip> <period>1</period> <action>AUTOUPDATE_DNS</action> <autorenew>true</autorenew> <registrar_status>ACTIVE</registrar_status> <rdds_opt_in>NOT_SET</rdds_opt_in> <owner> <user>customer</user> <context>4</context> </owner> <updater> <user>support</user> <context>1</context> </updater> <created>2022-01-21 15:01:07</created> </domain> <type>autoupdate_dns_error</type> <nic_response><![CDATA[53300102912 53300102912 53300102912 Nameserver error ERROR: 901 Unexpected RCODE (target, entity, RCODE) (/127.0.0.1:53, ns2.nameserver-broken.com, 13000000011]]></nic_response> <status> <code>E0102</code> <type>error</type> </status> <stid>20220121-app3-dev-68843</stid> <created>2022-01-21 15:01:15</created> </notify> <created>2022-01-21 15:01:15</created> </message> </data> <status> <code>S0905</code> <text>The notification was polled successfully.</text> <type>success</type> <object> <type>message</type> <value>1012057852</value> </object> </status> </result> <stid>20220121-app2-dev-135503</stid> </response>
PUSH notification examples
JSON
{
"id": 1012057877,
"notify": {
"type": "autoupdate_dns_error"
},
"stid": "20220121-app2-dev-136539",
"notice": "53300102912 53300102912 53300102912 Name server error ERROR: 901 Unexpected RCODE (target, entity, RCODE) (/127.0.0.1:53, ns1.nameserver-broken.com, NXDOMAIN) 13000000011 ",
"object": {
"type": "Domain",
"value": "example.de",
"data": {
"created": "2022-01-21T15:12:33.000+0100",
"owner": {
"context": 4,
"user": "customer"
},
"updater": {
"context": 1,
"user": "support"
},
"name": "example.de",
"registryStatus": "ACTIVE",
"nameServers": [
{
"name": "ns1.nameserver-broken.com"
},
{
"name": "ns2.nameserver-broken.com"
}
],
"period": {
"unit": "YEAR",
"period": 1
},
"registrarStatus": "ACTIVE",
"rddsOptIn": "NOT_SET",
"adminc": {
"id": 21642636
},
"ownerc": {
"id": 21642636
},
"techc": {
"id": 21642636
},
"zonec": {
"id": 21642636
},
"action": "AUTOUPDATE_DNS",
"autoRenewStatus": "TRUE"
}
}
}
XML
<message>
<domain>
<name>example.de</name>
<ownerc>21642636</ownerc>
<adminc>21642636</adminc>
<techc>21642636</techc>
<zonec>21642636</zonec>
<nic_member_label>DE-TEST</nic_member_label>
<registry_status>ACTIVE</registry_status>
<nserver>
<name>ns1.nameserver-broken.com</name>
</nserver>
<nserver>
<name>ns2.nameserver-broken.com</name>
</nserver>
<ip>1.2.3.4</ip>
<period>1</period>
<action>AUTOUPDATE_DNS</action>
<autorenew>true</autorenew>
<extension>
<registrar_status>ACTIVE</registrar_status>
<rdds_opt_in>NOT_SET</rdds_opt_in>
<owner>
<user>customer</user>
<context>4</context>
</owner>
<updater>
<user>support</user>
<context>1</context>
</updater>
<created>2022-01-21 15:19:04</created>
</extension>
</domain>
<type>autoupdate_dns_error</type>
<nic_response>
<!--[CDATA[53300102912
53300102912
53300102912
Nameserver error
ERROR: 901 Unexpected RCODE (target, entity, RCODE) (/127.0.0.1:53, ns2.nameserver-broken.com, NXDOMAIN)
13000000011]]-->
</nic_response>
<status>
<code>E0102</code>
<type>error</type>
</status>
<id>1012057886</id>
<stid>20220121-app2-dev-137443</stid>
<created>2022-01-21 15:19:11</created>
</message>
autoupdate_deferred_success
Concerns TLDs with manual processing.
Description
This notification is sent in the context of a successful subsequent AutoUpdate.
Notification trigger
The process consists of 2 steps:
Step 1 is indicated by the status code MSG01086 ("The domain action was successfully processed. However, there is still a need to update the domain data..").
Step 2 is acknowledged with the autoupdate_deferred_success notification type and thus completes the manual operation.
Recipient of the notification
The recipient of the notification is the AutoDNS user who started the job.
POLLING notification examples
JSON
{
"stid": "20210507-app3-dev-10535",
"status": {
"code": "S0905",
"text": "The notification was polled successfully.",
"type": "SUCCESS"
},
"object": {
"type": "Message",
"value": "1005373215",
"summary": 1
},
"data": [
{
"id": 1005373215,
"notify": {
"type": "autoupdate_deferred_success"
},
"stid": "20210507-app2-dev-19111",
"object": {
"type": "Domain",
"value": "example.aq",
"data": {
"created": "2021-05-07T14:52:54.000+0200",
"owner": {
"context": 4,
"user": "normal_user"
},
"updater": {
"context": 4,
"user": "normal_user"
},
"name": "example.aq",
"registryStatus": "ACTIVE",
"nameServers": [
{
"name": "ns1.examplenameserver.com"
},
{
"name": "ns2.examplenameserver.com"
}
],
"period": {
"unit": "YEAR",
"period": 1
},
"registrarStatus": "ACTIVE",
"rddsOptIn": "NOT_SET",
"techc": {
"id": 23252437
},
"zonec": {
"id": 23252437
},
"ownerc": {
"id": 23252437
},
"adminc": {
"id": 23252437
},
"action": "AUTOUPDATE_DEFERRED",
"autoRenewStatus": "TRUE"
}
}
}
]
}
XML
<response>
<result>
<data>
<summary>1</summary>
<message>
<id>1005373215</id>
<owner>
<user>normal_user</user>
<context>4</context>
</owner>
<notify>
<domain>
<name>example.aq</name>
<ownerc>23252437</ownerc>
<adminc>23252437</adminc>
<techc>23252437</techc>
<zonec>23252437</zonec>
<nic_member_label>AQ-TEST</nic_member_label>
<registry_status>ACTIVE</registry_status>
<nserver>
<name>ns1.examplenameserver.com</name>
</nserver>
<nserver>
<name>ns2.examplenameserver.com</name>
</nserver>
<ip>1.2.3.4</ip>
<period>1</period>
<action>AUTOUPDATE_DEFERRED</action>
<autorenew>true</autorenew>
<registrar_status>ACTIVE</registrar_status>
<rdds_opt_in>NOT_SET</rdds_opt_in>
<owner>
<user>normal_user</user>
<context>4</context>
</owner>
<updater>
<user>normal_user</user>
<context>4</context>
</updater>
<created>2021-05-07 14:53:59</created>
</domain>
<type>autoupdate_deferred_success</type>
<status>
<code>S0102</code>
<type>success</type>
</status>
<stid>20210507-app2-dev-19111</stid>
<created>2021-05-07 14:53:59</created>
</notify>
<created>2021-05-07 14:53:59</created>
</message>
</data>
<status>
<code>S0905</code>
<text>The notification was polled successfully.</text>
<type>success</type>
<object>
<type>message</type>
<value>1005373215</value>
</object>
</status>
</result>
<stid>20210507-app3-dev-10543</stid>
</response>
PUSH notification examples
JSON
{
"id": 1005453071,
"notify": {
"type": "autoupdate_deferred_success"
},
"stid": "20210511-app3-dev-7540",
"object": {
"type": "Domain",
"value": "example.aq",
"data": {
"created": "2021-05-11T11:17:15.000+0200",
"owner": {
"context": 4,
"user": "normal_user"
},
"updater": {
"context": 4,
"user": "normal_user"
},
"name": "example.aq",
"registryStatus": "ACTIVE",
"nameServers": [
{
"name": "ns1.examplenameserver.com"
},
{
"name": "ns2.examplenameserver.com"
}
],
"period": {
"unit": "YEAR",
"period": 1
},
"registrarStatus": "ACTIVE",
"rddsOptIn": "NOT_SET",
"adminc": {
"id": 23252437
},
"ownerc": {
"id": 23252437
},
"zonec": {
"id": 23252437
},
"techc": {
"id": 23252437
},
"action": "AUTOUPDATE_DEFERRED",
"autoRenewStatus": "TRUE"
}
}
}
XML
<message>
<domain>
<name>example.aq</name>
<ownerc>23252437</ownerc>
<adminc>23252437</adminc>
<techc>23252437</techc>
<zonec>23252437</zonec>
<nic_member_label>AQ-TEST</nic_member_label>
<registry_status>ACTIVE</registry_status>
<nserver>
<name>ns1.examplenameserver.com</name>
</nserver>
<nserver>
<name>ns2.examplenameserver.com</name>
</nserver>
<ip>1.2.3.4</ip>
<period>1</period>
<action>AUTOUPDATE_DEFERRED</action>
<autorenew>true</autorenew>
<extension />
<registrar_status>ACTIVE</registrar_status>
<rdds_opt_in>NOT_SET</rdds_opt_in>
<owner>
<user>normal_user</user>
<context>4</context>
</owner>
<updater>
<user>normal_user</user>
<context>4</context>
</updater>
<created>2021-05-11 11:11:50</created>
</domain>
<type>autoupdate_deferred_success</type>
<status>
<code>S0102</code>
<type>success</type>
</status>
<id>1005452977</id>
<stid>20210511-app3-dev-7370</stid>
<created>2021-05-11 11:13:27</created>
</message>
autoupdate_deferred_error
Description
This notification is sent in the context of a failed downstream AutoUpdate.
Concerns TLDs with manual processing.
Notification trigger
Step 1 is displayed with the status code MSG01086 (" The domain action was successfully processed. However, there is still a need to update the domain data.").
Step 2 is acknowledged with notification type autoupdate_deferred_error and thus completes the manual operation.
Recipient of the notification
The recipient of the notification is the AutoDNS user who started the job.
POLLING notification examples
JSON
{
"stid": "20210507-app3-dev-10868",
"status": {
"code": "S0905",
"text": "The notification was polled successfully.",
"type": "SUCCESS"
},
"object": {
"type": "Message",
"value": "1005373399",
"summary": 1
},
"data": [
{
"id": 1005373399,
"notify": {
"type": "autoupdate_deferred_error"
},
"stid": "20210507-app2-dev-19938",
"object": {
"type": "Domain",
"value": "example.aq",
"data": {
"created": "2021-05-07T15:38:31.000+0200",
"owner": {
"context": 4,
"user": "normal_user"
},
"updater": {
"context": 4,
"user": "normal_user"
},
"name": "example.aq",
"registryStatus": "ACTIVE",
"nameServers": [
{
"name": "ns1.examplenameserver.com"
},
{
"name": "ns2.examplenameserver.com"
}
],
"period": {
"unit": "YEAR",
"period": 1
},
"registrarStatus": "ACTIVE",
"rddsOptIn": "NOT_SET",
"adminc": {
"id": 23252437
},
"techc": {
"id": 23252437
},
"zonec": {
"id": 23252437
},
"ownerc": {
"id": 23252437
},
"action": "AUTOUPDATE_DEFERRED",
"autoRenewStatus": "TRUE"
}
}
}
]
}
XML
<response>
<result>
<data>
<summary>1</summary>
<message>
<id>1005373399</id>
<owner>
<user>normal_user</user>
<context>4</context>
</owner>
<notify>
<domain>
<name>example.aq</name>
<ownerc>23252437</ownerc>
<adminc>23252437</adminc>
<techc>23252437</techc>
<zonec>23252437</zonec>
<nic_member_label>AQ-TEST</nic_member_label>
<registry_status>ACTIVE</registry_status>
<nserver>
<name>ns1.examplenameserver.com</name>
</nserver>
<nserver>
<name>ns2.examplenameserver.com</name>
</nserver>
<ip>1.2.3.4</ip>
<period>1</period>
<action>AUTOUPDATE_DEFERRED</action>
<autorenew>true</autorenew>
<registrar_status>ACTIVE</registrar_status>
<rdds_opt_in>NOT_SET</rdds_opt_in>
<owner>
<user>normal_user</user>
<context>4</context>
</owner>
<updater>
<user>normal_user</user>
<context>4</context>
</updater>
<created>2021-05-07 15:38:31</created>
</domain>
<type>autoupdate_deferred_error</type>
<status>
<code>E0102</code>
<type>error</type>
</status>
<stid>20210507-app2-dev-19938</stid>
<created>2021-05-07 15:39:13</created>
</notify>
<created>2021-05-07 15:39:13</created>
</message>
</data>
<status>
<code>S0905</code>
<text>The notification was polled successfully.</text>
<type>success</type>
<object>
<type>message</type>
<value>1005373399</value>
</object>
</status>
</result>
<stid>20210507-app3-dev-10855</stid>
</response>
PUSH notification examples
JSON
{
"id": 1005453335,
"notify": {
"type": "autoupdate_deferred_error"
},
"stid": "20210511-app3-dev-7828",
"object": {
"type": "Domain",
"value": "example.aq",
"data": {
"created": "2021-05-11T11:31:14.000+0200",
"owner": {
"context": 4,
"user": "normal_user"
},
"updater": {
"context": 4,
"user": "normal_user"
},
"name": "example.aq",
"registryStatus": "ACTIVE",
"nameServers": [
{
"name": "ns1.examplenameserver.com"
},
{
"name": "ns2.examplenameserver.com"
}
],
"period": {
"unit": "YEAR",
"period": 1
},
"registrarStatus": "ACTIVE",
"rddsOptIn": "NOT_SET",
"adminc": {
"id": 23252437
},
"ownerc": {
"id": 23252437
},
"zonec": {
"id": 23252437
},
"techc": {
"id": 23252437
},
"action": "AUTOUPDATE_DEFERRED",
"autoRenewStatus": "TRUE"
}
}
}
XML
<message>
<domain>
<name>example.aq</name>
<ownerc>23252437</ownerc>
<adminc>23252437</adminc>
<techc>23252437</techc>
<zonec>23252437</zonec>
<nic_member_label>AQ-TEST</nic_member_label>
<registry_status>ACTIVE</registry_status>
<nserver>
<name>ns1.examplenameserver.com</name>
</nserver>
<nserver>
<name>ns2.examplenameserver.com</name>
</nserver>
<ip>1.2.3.4</ip>
<period>1</period>
<action>AUTOUPDATE_DEFERRED</action>
<autorenew>true</autorenew>
<extension />
<registrar_status>ACTIVE</registrar_status>
<rdds_opt_in>NOT_SET</rdds_opt_in>
<owner>
<user>normal_user</user>
<context>4</context>
</owner>
<updater>
<user>normal_user</user>
<context>4</context>
</updater>
<created>2021-05-11 11:34:36</created>
</domain>
<type>autoupdate_deferred_error</type>
<status>
<code>E0102</code>
<type>error</type>
</status>
<id>1005453409</id>
<stid>20210511-app3-dev-7920</stid>
<created>2021-05-11 11:35:30</created>
</message>
Overview
Content Tools