Ascio Web Service v2

Java Axis CreateOrder - Nameserver_Update

Replaces the nameserver with a new handle. There are 2 ways to submit the new Nameserver:

  • Submit a Handle-ID. The handle linked to the domain will be replaced
  • Submit new data. A new handle will be created. The handle linked to the domain will be replaced

With the Nameserver Update, it is possible to change Tech Contact, DnsSec and Nameservers in one request.

For .com, .net and some other TLDs glue records are needed. Please contact support for help.

Response CreateOrder(string sessionId,Order order)

Response codes

ResultCodeMessageValue
200Order validated
200Order received
400Order not validatedMessages
401Authorization failed
405Access denied

CreateOrder Request

PropertyDescription
sessionIdExample: o58t9fjgw9bjarp6q7byv13e
order

CreateOrderResponse

Property
CreateOrderResult
order
PropertyValue
OrderTypeNameserver_Update

Java Axis example

package ascio.v2.examples;
import com.ascio.www._2007._01.*;
import com.ascio.www._2007._01.holders.*;
import ascio.lib.*;

public class Nameserver_UpdateExample {
	public static Response main() {
		AscioConfig config = new AscioConfig();
		V2 env = config.getTesting().getV2();

		Contact techContact =  new Contact();
		techContact.setStatus("StatusTest");
		techContact.setHandle("JD123");
		techContact.setFirstName("John");
		techContact.setLastName("Doe");
		techContact.setOrgName("Ascio");
		techContact.setAddress1("Address1Test");
		techContact.setAddress2("Address2Test");
		techContact.setPostalCode("888349");
		techContact.setCity("CityTest");
		techContact.setState("StateTest");
		techContact.setCountryCode("DK");
		techContact.setEmail(config.getEmail());
		techContact.setPhone("+45.123456789");
		techContact.setFax("+45.987654321");
		techContact.setType("owner");
		techContact.setDetails("DetailsTest");
		techContact.setOrganisationNumber("OrganisationNumberTest");
The Handle. Please don't use Handle and contact-data. The data won't be merged!All contacts have FirstName and LastName. This is different than Registrants.All contacts have FirstName and LastName. This is different than Registrants.The Address1 is required for every Registrant/Contact. (In case no handle is used)The PostalCode is required for every Registrant/Contact. (In case no handle is used).The City is required for every Registrant/Contact. (In case no handle is used)The ISO 3166-1 code for the Country (DE,GB,DK,CH,SE,...). The CountryCode is required for every Registrant/Contact. (In case no handle is used)The Email is required for every Registrant/Contact. (In case no handle is used)Phone numbers must be in E164a format, eg. +45.123456789 (no spaces, hyphens, etc.).Fax numbers must be in E164a format, eg. +45.123456789 (no spaces, hyphens, etc.)
		NameServer nameServer1 =  new NameServer();
		nameServer1.setHostName("ns1.ascio.net");
		nameServer1.setIpAddress("64.98.148.24");
		nameServer1.setStatus("StatusTest");
		nameServer1.setIpV6Address("xxxx:xxxx:xxx:xxx:xxxx");
		nameServer1.setDetails("DetailsTest");
For normal orders you only need the HostName. We will set the IP. Exceptions are, TLDs with a ZoneCheck (like de,it,fr). An if you want to set a glue-recordYou need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.You need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.
		NameServer nameServer2 =  new NameServer();
		nameServer2.setHostName("ns2.ascio.net");
		nameServer2.setIpAddress("216.40.47.100");
		nameServer2.setStatus("StatusTest");
		nameServer2.setIpV6Address("xxxx:xxxx:xxx:xxx:xxxx");
		nameServer2.setDetails("DetailsTest");
For normal orders you only need the HostName. We will set the IP. Exceptions are, TLDs with a ZoneCheck (like de,it,fr). An if you want to set a glue-recordYou need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.You need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.
		NameServer nameServer3 =  new NameServer();
		nameServer3.setHostName("ns3.ascio.net");
		nameServer3.setIpAddress("64.98.148.25");
		nameServer3.setStatus("StatusTest");
		nameServer3.setIpV6Address("xxxx:xxxx:xxx:xxx:xxxx");
		nameServer3.setDetails("DetailsTest");
For normal orders you only need the HostName. We will set the IP. Exceptions are, TLDs with a ZoneCheck (like de,it,fr). An if you want to set a glue-recordYou need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.You need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.
		NameServer nameServer4 =  new NameServer();
		nameServer4.setHostName("ns4.ascio.net");
		nameServer4.setIpAddress("216.40.47.101");
		nameServer4.setStatus("StatusTest");
		nameServer4.setIpV6Address("xxxx:xxxx:xxx:xxx:xxxx");
		nameServer4.setDetails("DetailsTest");
For normal orders you only need the HostName. We will set the IP. Exceptions are, TLDs with a ZoneCheck (like de,it,fr). An if you want to set a glue-recordYou need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.You need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.
		NameServer nameServer5 =  new NameServer();
		nameServer5.setHostName("HostNameTest");
		nameServer5.setIpAddress("IpAddressTest");
		nameServer5.setStatus("StatusTest");
		nameServer5.setIpV6Address("IpV6AddressTest");
		nameServer5.setDetails("DetailsTest");
For normal orders you only need the HostName. We will set the IP. Exceptions are, TLDs with a ZoneCheck (like de,it,fr). An if you want to set a glue-recordYou need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.You need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.
		NameServer nameServer6 =  new NameServer();
		nameServer6.setHostName("HostNameTest");
		nameServer6.setIpAddress("IpAddressTest");
		nameServer6.setStatus("StatusTest");
		nameServer6.setIpV6Address("IpV6AddressTest");
		nameServer6.setDetails("DetailsTest");
For normal orders you only need the HostName. We will set the IP. Exceptions are, TLDs with a ZoneCheck (like de,it,fr). An if you want to set a glue-recordYou need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.You need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.
		NameServer nameServer7 =  new NameServer();
		nameServer7.setHostName("HostNameTest");
		nameServer7.setIpAddress("IpAddressTest");
		nameServer7.setStatus("StatusTest");
		nameServer7.setIpV6Address("IpV6AddressTest");
		nameServer7.setDetails("DetailsTest");
For normal orders you only need the HostName. We will set the IP. Exceptions are, TLDs with a ZoneCheck (like de,it,fr). An if you want to set a glue-recordYou need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.You need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.
		NameServer nameServer8 =  new NameServer();
		nameServer8.setHostName("HostNameTest");
		nameServer8.setIpAddress("IpAddressTest");
		nameServer8.setStatus("StatusTest");
		nameServer8.setIpV6Address("IpV6AddressTest");
		nameServer8.setDetails("DetailsTest");
For normal orders you only need the HostName. We will set the IP. Exceptions are, TLDs with a ZoneCheck (like de,it,fr). An if you want to set a glue-recordYou need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.You need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.
		NameServer nameServer9 =  new NameServer();
		nameServer9.setHostName("HostNameTest");
		nameServer9.setIpAddress("IpAddressTest");
		nameServer9.setStatus("StatusTest");
		nameServer9.setIpV6Address("IpV6AddressTest");
		nameServer9.setDetails("DetailsTest");
For normal orders you only need the HostName. We will set the IP. Exceptions are, TLDs with a ZoneCheck (like de,it,fr). An if you want to set a glue-recordYou need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.You need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.
		NameServer nameServer10 =  new NameServer();
		nameServer10.setHostName("HostNameTest");
		nameServer10.setIpAddress("IpAddressTest");
		nameServer10.setStatus("StatusTest");
		nameServer10.setIpV6Address("IpV6AddressTest");
		nameServer10.setDetails("DetailsTest");
For normal orders you only need the HostName. We will set the IP. Exceptions are, TLDs with a ZoneCheck (like de,it,fr). An if you want to set a glue-recordYou need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.You need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.
		NameServer nameServer11 =  new NameServer();
		nameServer11.setHostName("HostNameTest");
		nameServer11.setIpAddress("IpAddressTest");
		nameServer11.setStatus("StatusTest");
		nameServer11.setIpV6Address("IpV6AddressTest");
		nameServer11.setDetails("DetailsTest");
For normal orders you only need the HostName. We will set the IP. Exceptions are, TLDs with a ZoneCheck (like de,it,fr). An if you want to set a glue-recordYou need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.You need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.
		NameServer nameServer12 =  new NameServer();
		nameServer12.setHostName("HostNameTest");
		nameServer12.setIpAddress("IpAddressTest");
		nameServer12.setStatus("StatusTest");
		nameServer12.setIpV6Address("IpV6AddressTest");
		nameServer12.setDetails("DetailsTest");
For normal orders you only need the HostName. We will set the IP. Exceptions are, TLDs with a ZoneCheck (like de,it,fr). An if you want to set a glue-recordYou need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.You need an IP Address if the ZoneCheck is used or you want to set at glue record. If you want to set a glue-record for ns1.mynsdomain.com then mynsdomain.com must be at ascio.
		NameServers nameServers =  new NameServers();
		nameServers.setNameServer1(nameServer1);
		nameServers.setNameServer2(nameServer2);
		nameServers.setNameServer3(nameServer3);
		nameServers.setNameServer4(nameServer4);
		nameServers.setNameServer5(nameServer5);
		nameServers.setNameServer6(nameServer6);
		nameServers.setNameServer7(nameServer7);
		nameServers.setNameServer8(nameServer8);
		nameServers.setNameServer9(nameServer9);
		nameServers.setNameServer10(nameServer10);
		nameServers.setNameServer11(nameServer11);
		nameServers.setNameServer12(nameServer12);

		DnsSecKey dnsSecKey1 =  new DnsSecKey();
		dnsSecKey1.setHandle("JD123");

		DnsSecKey dnsSecKey2 =  new DnsSecKey();
		dnsSecKey2.setHandle("JD123");

		DnsSecKey dnsSecKey3 =  new DnsSecKey();
		dnsSecKey3.setHandle("JD123");

		DnsSecKey dnsSecKey4 =  new DnsSecKey();
		dnsSecKey4.setHandle("JD123");

		DnsSecKey dnsSecKey5 =  new DnsSecKey();
		dnsSecKey5.setHandle("JD123");

		DnsSecKeys dnsSecKeys =  new DnsSecKeys();
		dnsSecKeys.setDnsSecKey1(dnsSecKey1);
		dnsSecKeys.setDnsSecKey2(dnsSecKey2);
		dnsSecKeys.setDnsSecKey3(dnsSecKey3);
		dnsSecKeys.setDnsSecKey4(dnsSecKey4);
		dnsSecKeys.setDnsSecKey5(dnsSecKey5);

		Domain domain =  new Domain();
		domain.setDomainName(env.getProperties().getProperty("DomainName"));
		domain.setTechContact(techContact);
		domain.setNameServers(nameServers);
		domain.setDnsSecKeys(dnsSecKeys);

		Order order =  new Order();
		order.setType(OrderType.Nameserver_Update);
		order.setDomain(domain);

		try {
			/**inputs holders*/

			OrderHolder orderHolder = new OrderHolder(order);

			Response response = env.getClient().createOrder(env.getSessionId(), orderHolder);


			System.out.println("CreateOrder ResultCode\t: " + response.getResultCode().toString());
			System.out.println("CreateOrder Message\t: " + response.getMessage());
			System.out.println("Created OrderId\t\t: " + orderHolder.value.getOrderId());
			if(response.getResultCode() == 400) {
				for( String value : response.getValues()) {
					System.out.println("Error:	" + value);
				}
			}
			env.repeatSync(orderHolder.value.getOrderId(), 10);
			return response;
		} catch (Exception e) {
			System.out.print(e);
		}
		return new Response();package ascio.v2.examples;
import com.ascio.www._2007._01.*;
import com.ascio.www._2007._01.holders.*;
import ascio.lib.*;

public class Nameserver_UpdateExample {
	public static Response main() {
		AscioConfig config = new AscioConfig();
		V2 env = config.getTesting().getV2();

		Contact techContact =  new Contact();
		techContact.setStatus("StatusTest");
		techContact.setHandle("JD123");
		techContact.setFirstName("John");
		techContact.setLastName("Doe");
		techContact.setOrgName("Ascio");
		techContact.setAddress1("Address1Test");
		techContact.setAddress2("Address2Test");
		techContact.setPostalCode("888349");
		techContact.setCity("CityTest");
		techContact.setState("StateTest");
		techContact.setCountryCode("DK");
		techContact.setEmail(config.getEmail());
		techContact.setPhone("+45.123456789");
		techContact.setFax("+45.987654321");
		techContact.setType("owner");
		techContact.setDetails("DetailsTest");
		techContact.setOrganisationNumber("OrganisationNumberTest");

		NameServer nameServer1 =  new NameServer();
		nameServer1.setHostName("ns1.ascio.net");
		nameServer1.setIpAddress("64.98.148.24");
		nameServer1.setStatus("StatusTest");
		nameServer1.setIpV6Address("xxxx:xxxx:xxx:xxx:xxxx");
		nameServer1.setDetails("DetailsTest");

		NameServer nameServer2 =  new NameServer();
		nameServer2.setHostName("ns2.ascio.net");
		nameServer2.setIpAddress("216.40.47.100");
		nameServer2.setStatus("StatusTest");
		nameServer2.setIpV6Address("xxxx:xxxx:xxx:xxx:xxxx");
		nameServer2.setDetails("DetailsTest");

		NameServer nameServer3 =  new NameServer();
		nameServer3.setHostName("ns3.ascio.net");
		nameServer3.setIpAddress("64.98.148.25");
		nameServer3.setStatus("StatusTest");
		nameServer3.setIpV6Address("xxxx:xxxx:xxx:xxx:xxxx");
		nameServer3.setDetails("DetailsTest");

		NameServer nameServer4 =  new NameServer();
		nameServer4.setHostName("ns4.ascio.net");
		nameServer4.setIpAddress("216.40.47.101");
		nameServer4.setStatus("StatusTest");
		nameServer4.setIpV6Address("xxxx:xxxx:xxx:xxx:xxxx");
		nameServer4.setDetails("DetailsTest");

		NameServer nameServer5 =  new NameServer();
		nameServer5.setHostName("HostNameTest");
		nameServer5.setIpAddress("IpAddressTest");
		nameServer5.setStatus("StatusTest");
		nameServer5.setIpV6Address("IpV6AddressTest");
		nameServer5.setDetails("DetailsTest");

		NameServer nameServer6 =  new NameServer();
		nameServer6.setHostName("HostNameTest");
		nameServer6.setIpAddress("IpAddressTest");
		nameServer6.setStatus("StatusTest");
		nameServer6.setIpV6Address("IpV6AddressTest");
		nameServer6.setDetails("DetailsTest");

		NameServer nameServer7 =  new NameServer();
		nameServer7.setHostName("HostNameTest");
		nameServer7.setIpAddress("IpAddressTest");
		nameServer7.setStatus("StatusTest");
		nameServer7.setIpV6Address("IpV6AddressTest");
		nameServer7.setDetails("DetailsTest");

		NameServer nameServer8 =  new NameServer();
		nameServer8.setHostName("HostNameTest");
		nameServer8.setIpAddress("IpAddressTest");
		nameServer8.setStatus("StatusTest");
		nameServer8.setIpV6Address("IpV6AddressTest");
		nameServer8.setDetails("DetailsTest");

		NameServer nameServer9 =  new NameServer();
		nameServer9.setHostName("HostNameTest");
		nameServer9.setIpAddress("IpAddressTest");
		nameServer9.setStatus("StatusTest");
		nameServer9.setIpV6Address("IpV6AddressTest");
		nameServer9.setDetails("DetailsTest");

		NameServer nameServer10 =  new NameServer();
		nameServer10.setHostName("HostNameTest");
		nameServer10.setIpAddress("IpAddressTest");
		nameServer10.setStatus("StatusTest");
		nameServer10.setIpV6Address("IpV6AddressTest");
		nameServer10.setDetails("DetailsTest");

		NameServer nameServer11 =  new NameServer();
		nameServer11.setHostName("HostNameTest");
		nameServer11.setIpAddress("IpAddressTest");
		nameServer11.setStatus("StatusTest");
		nameServer11.setIpV6Address("IpV6AddressTest");
		nameServer11.setDetails("DetailsTest");

		NameServer nameServer12 =  new NameServer();
		nameServer12.setHostName("HostNameTest");
		nameServer12.setIpAddress("IpAddressTest");
		nameServer12.setStatus("StatusTest");
		nameServer12.setIpV6Address("IpV6AddressTest");
		nameServer12.setDetails("DetailsTest");

		NameServers nameServers =  new NameServers();
		nameServers.setNameServer1(nameServer1);
		nameServers.setNameServer2(nameServer2);
		nameServers.setNameServer3(nameServer3);
		nameServers.setNameServer4(nameServer4);
		nameServers.setNameServer5(nameServer5);
		nameServers.setNameServer6(nameServer6);
		nameServers.setNameServer7(nameServer7);
		nameServers.setNameServer8(nameServer8);
		nameServers.setNameServer9(nameServer9);
		nameServers.setNameServer10(nameServer10);
		nameServers.setNameServer11(nameServer11);
		nameServers.setNameServer12(nameServer12);

		DnsSecKey dnsSecKey1 =  new DnsSecKey();
		dnsSecKey1.setHandle("JD123");

		DnsSecKey dnsSecKey2 =  new DnsSecKey();
		dnsSecKey2.setHandle("JD123");

		DnsSecKey dnsSecKey3 =  new DnsSecKey();
		dnsSecKey3.setHandle("JD123");

		DnsSecKey dnsSecKey4 =  new DnsSecKey();
		dnsSecKey4.setHandle("JD123");

		DnsSecKey dnsSecKey5 =  new DnsSecKey();
		dnsSecKey5.setHandle("JD123");

		DnsSecKeys dnsSecKeys =  new DnsSecKeys();
		dnsSecKeys.setDnsSecKey1(dnsSecKey1);
		dnsSecKeys.setDnsSecKey2(dnsSecKey2);
		dnsSecKeys.setDnsSecKey3(dnsSecKey3);
		dnsSecKeys.setDnsSecKey4(dnsSecKey4);
		dnsSecKeys.setDnsSecKey5(dnsSecKey5);

		Domain domain =  new Domain();
		domain.setDomainName(env.getProperties().getProperty("DomainName"));
		domain.setTechContact(techContact);
		domain.setNameServers(nameServers);
		domain.setDnsSecKeys(dnsSecKeys);

		Order order =  new Order();
		order.setType(OrderType.Nameserver_Update);
		order.setDomain(domain);

		try {
			/**inputs holders*/

			OrderHolder orderHolder = new OrderHolder(order);

			Response response = env.getClient().createOrder(env.getSessionId(), orderHolder);


			System.out.println("CreateOrder ResultCode\t: " + response.getResultCode().toString());
			System.out.println("CreateOrder Message\t: " + response.getMessage());
			System.out.println("Created OrderId\t\t: " + orderHolder.value.getOrderId());
			if(response.getResultCode() == 400) {
				for( String value : response.getValues()) {
					System.out.println("Error:	" + value);
				}
			}
			env.repeatSync(orderHolder.value.getOrderId(), 10);
			return response;
		} catch (Exception e) {
			System.out.print(e);
		}
		return new Response();
WSDL for AWS v2
https://aws.demo.ascio.com/2012/01/01/AscioService.wsdl (OTE)
https://aws.ascio.com/2012/01/01/AscioService.wsdl (Live)
Please configure the IP-Whitelisting in the portal/demo-portal.