Table of contents

The purge process is the automatic deletion of contacts (contact purge) and zones (zone purge) that are no longer used. Once the process is complete, a notification is sent to the main user by default.

Trigger of the notification

This process runs automatically in the background using a cron job. The process is not triggered by an AutoDNS task.
The following conditions must be met for the notification to be sent:

  • In the AutoDNS user profile, the checkbox next to Purge Notifications must be checked. See here.

The following conditions must also be met for contacts:

  •  The domain contact must not have been changed or used in the last 12 months and must not currently be used by a domain or an ongoing request.

The following conditions must also be met for zones:

  • The zone must have the purge status AUTO.
  • The domain belonging to the zone has not been in the inventory for 60 days.


.arpa zones are excluded from the cleanup.

Recipient of the notifications

The notifications are sent to the main user. If the contacts of a subuser are deleted, the notifications are only sent to the subuser by default. If they should also be sent to the main user, this can be set in the user profile of the main user. See here.

Examples for contact purge notifications

Polling notification example

JSON
{
   "stid":"20220610-app4-226953",
   "status":{
      "code":"S0905",
      "text":"The notification was polled successfully.",
      "type":"SUCCESS"
   },
   "object":{
      "type":"Message",
      "value":"64774886",
      "summary":1
   },
   "data":[
      {
         "id":64774886,
         "notify":{
            "type":"contact_deleted",
            "object":{
               "type":"Contact",
               "data":{
                  "id":12345
               }
            }
         }
      }
   ]
}
XML
<response>
   <result>
      <data>
         <summary>1</summary>
         <message>
            <id>1005420303</id>
            <owner>
               <user>normal_user</user>
               <context>4</context>
            </owner>
            <notify>
               <handle>
                  <id>23307801</id>
               </handle>
               <type>contact_deleted</type>
               <msg>
                  <code>MSG01039</code>
                  <type>notice</type>
               </msg>
               <status>
                  <code>S0303</code>
                  <type>success</type>
               </status>
               <created>2021-05-10 15:06:16</created>
            </notify>
            <created>2021-05-10 15:06:16</created>
         </message>
      </data>
      <status>
         <code>S0905</code>
         <text>The notification was polled successfully.</text>
         <type>success</type>
         <object>
            <type>message</type>
            <value>1005420303</value>
         </object>
      </status>
   </result>
   <stid>20210510-app3-dev-9688</stid>
</response>

Push notification example

JSON
{
   "stid":"20220610-app4-226953",
   "status":{
      "code":"S0905",
      "text":"The notification was polled successfully.",
      "type":"SUCCESS"
   },
   "object":{
      "type":"Message",
      "value":"64774886",
      "summary":1
   },
   "data":[
      {
         "id":64774886,
         "notify":{
            "type":"contact_deleted",
            "object":{
               "type":"Contact",
               "data":{
                  "id":12345
               }
            }
         }
      }
   ]
}
XML
<response>
	<result>
		<data>
			<summary>1</summary>
			<message>
				<handle>
					<id>23308053</id>
				</handle>
				<type>contact_deleted</type>
				<msg>
					<code>MSG01039</code>
					<type>notice</type>
				</msg>
				<status>
					<code>S0303</code>
					<type>success</type>
				</status>
				<id>1005452585</id>
				<created>2021-05-11 10:53:21</created>
			</message>
		</data>
		<status>
			<code>S0905</code>
			<text>The notification was polled successfully.</text>
			<type>success</type>
			<object>
				<type>message</type>
				<value>1005420303</value>
			</object>
		</status>
	</result>
	<stid>20210510-app3-dev-9688</stid>
</response>

Examples for zone purge notifications

Polling notification examples

JSON
{
    "stid": "20240606-app2-dev-4108",
    "status": {
        "code": "S0905",
        "text": "The notification was polled successfully.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "Message",
        "value": "1018426234",
        "summary": 1
    },
    "data": [
        {
            "id": 1018426234,
            "notify": {
                "type": "zone_deleted"
            }
        }
    ]
}
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
	<result>
		<data>
			<summary>1</summary>
			<message>
				<id>1018426235</id>
				<owner>
					<user>customer</user>
					<context>4</context>
				</owner>
				<notify>
					<zone>
						<name>0-a-000000-ax-1135.com</name>
						<origin>0-a-000000-ax-1135.com</origin>
						<system_ns>pdns1.testsys.autodns2.de</system_ns>
					</zone>
					<type>zone_deleted</type>
					<msg>
						<code>MSG01202</code>
						<type>notice</type>
					</msg>
					<status>
						<code>S0203</code>
						<type>success</type>
					</status>
					<created>2024-06-04 16:38:25</created>
				</notify>
				<created>2024-06-04 16:38:25</created>
			</message>
		</data>
		<status>
			<code>S0905</code>
			<text>The notification was polled successfully.</text>
			<type>success</type>
			<object>
				<type>message</type>
				<value>1018426235</value>
			</object>
		</status>
	</result>
	<stid>20240606-app2-dev-4183</stid>
</response>

Push notification examples

JSON
{
   "stid":"20220610-app4-226953",
   "status":{
      "code":"S0905",
      "text":"The notification was polled successfully.",
      "type":"SUCCESS"
   },
   "object":{
      "type":"Message",
      "value":"64774886",
      "summary":1
   },
   "data":[
      {
         "id":64774886,
         "notify":{
            "type":"zone_deleted",
            "object":{
               "type":"zone",
               "data":{
                  "id":12345
               }
            }
         }
      }
   ]
}
XML
<response>
	<result>
		<data>
			<summary>1</summary>
			<message>     
				<zone>
                        <name>ax-1135.com</name>
                        <origin>ax-1135.com</origin>
                        <system_ns>pdns1.testsys.autodns2.de</system_ns>
                 </zone>     
				 <type>zone_deleted</type>
				<msg>
					<code>MSG01202</code>
					<type>notice</type>
				</msg>
				<status>
					<code>S0303</code>
					<type>success</type>
				</status>
				<id>1005452585</id>
				<created>2021-05-11 10:53:21</created>
			</message>
		</data>
		<status>
			<code>S0905</code>
			<text>The notification was polled successfully..</text>
			<type>success</type>
			<object>
				<type>message</type>
				<value>1005420303</value>
			</object>
		</status>
	</result>
	<stid>20210510-app3-dev-9688</stid>
</response>