- Home
- API reference
- API documentation (JSON/XML)
- Tasks
- Domain tasks
Domain update
Function
The task DomainUpdate updates the data of a domain.
With the DomainUpdatePlus task, unlike DomainUpdate, you can specify the data of a domain contact (handle) in order to have it created automatically. If a contact already exists with this data, a new one is not created, but the existing one is used. Within the "Domain" element all keywords are possible, which you can also use for the DomainUpdate. In the respective domain contact elements (ownerc, adminc, techc, zonec) you can use all keywords that are also valid when editing a domain contact.
If you do not specify certain keywords, they are loaded from the database.
If an ownerchange is sent to the system, an existing AuthInfo1 is deleted. If there is a cancelation order of type PREACK in the system, a new AuthInfo1 is automatically generated.
The keywords for the domain element are described on the Domain object page.
The keywords for the domain contact elements (ownerc, adminc, techc, zonec) for the DomainCreatePlus task are described on the Contact page.
The keyword description for DNSSsec can be found on the DNSSec object page.
Description
Route: PUT /domain/ {name}
{
"name": "example.com",
"ownerc": {
"id": 23142212
},
"adminc": {
"id": 21606248
},
"techc": {
"id": 21606248
},
"confirmOrder": false,
"nameServers": [
{
"name": "ns1.example.com"
},
{
"name": "ns2.example.com"
}
]
}{
"stid": "20190701-app3-dev-9048",
"status": {
"code": "N0102",
"text": "Domain update has been started successfully.",
"type": "NOTIFY"
},
"object": {
"type": "Domain",
"value": "example.com"
},
"data": [
{
"created": "2019-07-01T09:41:58.000+0200",
"updated": "2019-07-01T09:41:58.000+0200",
"owner": {
"context": 4,
"user": "customer"
},
"updater": {
"context": 4,
"user": "customer"
},
"status": "RUNNING",
"execution": "2019-07-01T09:41:57.000+0200",
"id": 4297543151
}
]
}Task code: 0102
Uses Domain object
Single request
<request>
<auth>
<user>customer</user>
<password>password</password>
<context>4</context>
</auth>
<task>
<code>0102</code>
<domain>
<name>example.com</name>
<ownerc>9925345</ownerc>
<adminc>9925345</adminc>
<techc>9925346</techc>
<zonec>9925346</zonec>
<nserver>
<name>ns1.example.com</name>
</nserver>
<nserver>
<name>ns2.example.com</name>
<ip>172.16.100.1</ip>
<ip6>2001:0DB8::1</ip6>
</nserver>
<use_privacy>1</use_privacy>
<confirm_owner_consent>1</confirm_owner_consent>
<dnssec>
<flags>257</flags>
<protocol>3</protocol>
<algorithm>5</algorithm>
<publickey>key...</publickey>
</dnssec>
</domain>
<reply_to>customer@example.com</reply_to>
</task>
</request><response>
<result>
<data>
<domain_job>
<job>
<id>4295210826</id>
<status>NOT_SET</status>
</job>
</domain_job>
</data>
<status>
<code>N0102</code>
<text>Domain update has been started successfully.</text>
<type>notify</type>
<object>
<type>domain</type>
<value>example.com</value>
</object>
</status>
</result>
<stid>20180213-app2-17296</stid>
</response>Bulk request
<request>
<auth>
<user>customer</user>
<password>password</password>
<context>4</context>
</auth>
<task>
<code>0102</code>
<ctid></ctid>
<default>
<ownerc>9925345</ownerc>
<adminc>9925345</adminc>
<techc>9925345</techc>
<zonec>9925345</zonec>
<nserver>
<name>ns1.example.org</name>
<ip>172.16.100.1</ip>
</nserver>
<nserver>
<name>ns2.example.org</name>
<ip>172.16.100.2</ip>
</nserver>
<dns_checks>soa</dns_checks>
<confirm_owner_consent>1</confirm_owner_consent>
</default>
<domain>
<name>example.org</name>
</domain>
<domain>
<name>example.net</name>
</domain>
<domain>
<name>example.biz</name>
</domain>
<reply_to>customer@example.com</reply_to>
</task>
</request><response>
<result>
<msg>
<text>Domain update has been started successfully.</text>
<code>N0102</code>
<type>notify</type>
<object>
<type>domain</type>
<value>example.org</value>
</object>
</msg>
<msg>
<text>Domain update has been started successfully.</text>
<code>N0102</code>
<type>notify</type>
<object>
<type>domain</type>
<value>example.net</value>
</object>
</msg>
<msg>
<text>Domain update has been started successfully.</text>
<code>N0102</code>
<type>notify</type>
<object>
<type>domain</type>
<value>example.biz</value>
</object>
</msg>
<status>
<code>N0102001</code>
<text>Domain update has been started successfully.</text>
<type>notify</type>
</status>
</result>
<ctid/>
<stid>20180213-app3-10304</stid>
</response>