DNS Provider::CreateDNSZone

The CreateDNSZone procedure allows you to create a requested zone on a specified server. This method does not update any secondary servers.

Note: Before using this procedure, security must be carfully considered. For detailed information about MPS DNS provider security, see DNS Provider Architecture.

Note

Zone files are not actually created unless the CommitFlag is set. Creating zones is a multi-step process and zones are not valid until many of the steps are successfully completed. The default value of the CommitFlag, NOCOMMIT, allows for rapid completion of those steps prior to making the zone public, which also avoids having partially valid zone files on the server. After all of the characterization steps are completed, the WriteBackZoneFile method is called and the zone can be un-PAUSED.

Arguments

Remarks

Sample Code

Example XML Request

<?xml version="1.0" encoding="iso-8859-1" ?>

<request>

	<data>

			<serverIdentifier>100.100.100.125</serverIdentifier>

				<userName>myuser</userName>

		 <password>password</password>

			 <zoneName>mydomain.com</zoneName>

		 <zoneType>primary</zoneType>

				<adminEmail>admin@mydomain.com</adminEmail>

		 <commitFlag>COMMIT</commitFlag>

			 <debugLevel logging="high" check-only="on"/>

			<properties>

					<property name="IpAddr"></property>

				 <property name="DataFile">mydomain.com.dns</property>

					 <property name="SecondaryServers">

								<value>100.100.100.10</value>

					 </property>

			 </properties>

	 </data>

   <procedure>

			 <execute namespace="DNS Provider" procedure="CreateDNSZone">

					<before source="data" destination="executeData" mode="merge"/>

					<before source="executeData" destination="data" mode="insert"/>

		 </execute>

		</procedure>

</request>

Example XML Response

The following is an example of an XML response for the CreateDNSZone method of the DNS Provider:

<?xml version="1.0" encoding="iso-8859-1" ?>

	<response>

				<data>

					<operationStatus>Success</operationStatus>

				<zoneFileName>c:\winnt\system32\dns\mydomain.com.dns</zoneFileName>

 </data>

</response>

Applies To