DNS Provider::CreateResourceRecord

  • Article

The CreateResourceRecord procedure allows you to create an resource record on a specified server regardless of whether it is primary for the zone. The resource record is temporary (not written to the zone file) unless you explicitly override the default value for CommitFlag (NOCOMMIT).

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.

{CommitFlag}

No

Values are: { COMMIT | <NOCOMMIT> }.

{DebugLevel}

No

A string to control tracing and other debugging functionality. Values are:

  • Logging = { HIGH | MEDIUM | LOW }

  • Check-only = { ON | OFF }

PropertyTree

Yes

Properties vary by resource record type. Refer to DNS WMI Provider in the DNS software development kit (SDK) on MSDN for the properties required as input parameters to the CreateResourceRecord method (see "Online Links").
Output argument Description

OperationStatus

A string containing a success/failure indication, any error messages, and input parameter validity flags.

Remarks

For the CreateResourceRecord method, the following condition applies:

  • This method cannot be used to create SOA records. These records are created automatically when a DNS zone is created.

Sample Code

Example XML Request

The following is an example of an XML request for the CreateResourceRecord 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> 
 
         <commitFlag>COMMIT</commitFlag> 
 
             <debugLevel logging="high" check-only="on"/> 
 
              <properties> 
 
              </properties> 
 
     </data> 
 
   <procedure> 
 
               <execute namespace="DNS Provider" procedure="CreateResourceRecord"> 
 
                       <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 CreateResourceRecord method of the DNS Provider:

<?xml version="1.0" encoding="iso-8859-1" ?> 
<response> 
 
       <data> 
 
            <operationStatus>Success</operationStatus> 
 
  </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::ModifyResourceRecord
DNS Provider::DeleteResourceRecord
DNS Provider::GetResourceRecord