Windows-based Hosting::DeleteResourceRecord
The DeleteResourceRecord procedure deletes a resource record for a specified zone on a specified DNS server.
Arguments
The DeleteResourceRecord procedure has the following input parameters.
Input Argument | Description |
---|---|
<org> |
The Lightweight Directory Access Protocol (LDAP) path of the owning organization. |
<preferredDomainController> |
The name of the preferred domain controller. |
<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 FQDN of the DNS server. |
<zoneName> |
The name of the DNS zone to delete, for example fabrikam.com. |
<rrType> |
The DNS record type, for example, MicrosoftDNS_AType, or MicrosoftDNS_MXType. |
<debugLevel>/<@logging> |
Controls the level of detail provided [ high | medium | low ]. |
<properties> |
The password for connecting to the SQL server via SQL Authentication, using the username indicated by <sqlUserName/>. If the <sqlUserName/> node is not present, this node is ignored. |
<rrName> |
A string containing the name of the resource record to be deleted. |
Output Arguments
The DeleteResourceRecord procedure has no return values.
Remarks
Security
The DeleteResourceRecord 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 resource record with the DeleteResourceRecord procedure of the Managed Windows-based Hosting Namespace:
- Call DNS Provider::DeleteResourceRecord
Sample Code
Example XML Request
The following is an example of an XML request for the DeleteResourceRecord 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>
<rrType>MicrosoftDNS_RType</rrType>
<commitFlag>COMMIT</commitFlag>
<debugLevel logging="high" check-only="on" />
<properties></properties>
</data>
<procedure>
<execute namespace="Windows-based Hosting"
procedure="DeleteResourceRecord">
<before source="data" destination="executeData" mode="merge" />
<before 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