DNS Provider::GetResourceRecord
The GetResourceRecord procedure allows you to return all data from a requested resource record as a tree of properties.
Note
Before using this procedure, security must be carfully considered. For detailed information about MPS DNS provider security, see DNS Provider Architecture.
Arguments
Input argument | Required | Description |
---|---|---|
ServerIdentifier |
Yes |
A string containing the dotted-quad IP address or the Fully Qualified Domain Nname (FQDN) of the server. |
{Credentials} |
No |
Optional authentication credentials for the target DNS server. |
ZoneName |
Yes |
A string containing the FQDN of the zone. |
RRtype |
Yes |
A string containing the resource record type. |
RRname |
Yes |
A string containing the name of the resource record to be modified. If more than one record with this type/name combination exists, additional information must exist in the property tree to distinguish the record to be changed. If no distinguishing information is supplied, or not enough information is supplied to either make the target unique or to select all targets with the same name, the operation FAILS. It is normal, for example, for a multiple-home computer to have several A records with the same name. |
{DebugLevel} |
No |
A string to control tracing and other debugging functionality. Values are:
|
{PropertyTree} |
No |
Properties vary by resource record type. Refer to DNS WMI Provider in the DNS SDK on MSDN for the properties required as input parameters to the GetResourceRecord method (see "Online Links"). |
Output argument | Description |
---|---|
OperationStatus |
A string containing a success/failure indication, any error messages, and input parameter validity flags. |
PropertyTree |
Resource record data. |
Remarks
No remarks.
Sample Code
Example XML Request
Following is an example of an XML request for the GetResourceRecord method of the DNS Provider:
<?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>
<rrType>MX</rrType>
<rrName>mail</rrName>
<debugLevel logging="high" check-only="on"/>
<properties>
</properties>
</data>
<procedure>
<execute namespace="DNS Provider" procedure="GetResourceRecord">
<before source="data" destination="executeData" mode="merge"/>
<before source="executeData" destination="data" mode="insert"/>
</execute>
</procedure>
</request>
Example XML Response
Following is an example of an XML response for the GetResourceRecord method of the DNS Provider:
<?xml version="1.0" encoding="iso-8859-1" ?>
<response>
<data>
<operationStatus>Success</operationStatus>
<properties>
<property name="ipAddress">100.100.100.10</property>
<property name="rrType">MX</property>
<property name="rrName">mail</property>
</properties>
</data>
</response>
Applies To
DNS Provider API for:
Hosted Messaging and Collaboration version 4.5
Hosted Messaging and Collaboration version 4.0
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
DNS Provider::CreateResourceRecord
DNS Provider::ModifyResourceRecord
DNS Provider::DeleteResourceRecord