Windows-based Hosting::DeleteDNSZone

  • Article

The DeleteDNSZone procedure deletes a zone on a specified DNS server.

Arguments

The DeleteDNSZone procedure has the following input parameters.

Input Argument Description

<userName>

Authentication credentials for the target DNS server. Only required when using Basic Authentication to talk to the DNS Provider Client.

<password>

Authentication credentials for the target DNS server. Only required when using Basic Authentication to talk to the DNS Provider Client.

<serverIdentifier>

A string containing the IP address or the Fully Qualified Domain Name (FQDN) of the DNS server.

<zoneName>

The name of the DNS zone to create, for example fabrikam.com.

<org>

The Lightweight Directory Access Protocol (LDAP) path of the owning organization.

<preferredDomainController>

<debugLevel>/<@logging>

Controls the level of detail provided [ high | medium | low ].

Output Arguments

The DeleteDNSZone procedure has no return values.

Remarks

Security

The DeleteDNSZone procedure has the following security requirements:

  • The caller is impersonated.

  • The caller is tested for OrgCreator permissions.

Process Steps

The following step occurs when deleting a DNS zone with the DeleteDNSZone procedure of the Managed Windows-based Hosting Namespace:

  • Call DNS Provider:DeleteDNSZone

Sample Code

Example XML Request

The following is an example of an XML request for the DeleteDNSZone procedure of the Managed Windows-based Hosting Namespace:

<request> 
        <data> 
                <org>LDAP://ou=WbHOrg2,ou=WbHReseller,ou=hosting, 
                dc=fabrikam,dc=com</org> 
                <preferredDomainController>AD01-WH.fabrikam.Com 
                </preferredDomainController> 
                <serverIdentifier>10.18.0.20</serverIdentifier> 
                <userName>fabrikam\administrator</userName> 
                <password>!Zam*ps1</password> 
                <zoneName>myDomain.com</zoneName> 
                <commitFlag>COMMIT</commitFlag> 
                <debugLevel logging="high" check-only="on"/> 
        </data> 
        <procedure> 
                <execute namespace="Windows-based Hosting"  
                procedure="DeleteDNSZone"> 
                <before source="data" destination="executeData" mode="merge"/> 
                <after source="executeData" destination="data" mode="insert"/> 
                </execute> 
        </procedure> 
</request>

Applies To

Managed Windows-based Hosting Namespace API for:

  • Hosted Messaging and Collaboration version 3.5

  • Hosted Messaging and Collaboration version 3.0

  • Windows-based Hosting version 4.5

  • Windows-based Hosting version 4.0

  • Windows-based Hosting version 3.5

  • Windows-based Hosting for Applications version 1.0

See also

Tasks

Windows-based Hosting::CreateDNSZone