Create DNS Record operation

The Create DNS Record operation creates the following types of Domain Name System (DNS) records in the Infoblox NIOS application:

  • A: Maps a domain name to an IPv4 address and can be added only to an authoritative forward-mapping zone.
  • PTR: Maps an IP address to a host name and can be only added to a reverse-mapping zone.
  • CNAME: Maps an alias to a canonical (official) name and can be added to both forward-mapping and reverse-mapping zones.
  • SRV: Directs queries to hosts that provide specific services. For example, if you have an FTP server, then you might create an SRV record that specifies the host which provides the service.
  • TXT: Specifies some additional information about the host name.
  • MX: Maps a domain name to a mail server

For more information about DNS Records Management in the Infoblox application, see Infoblox_API_Documentation_6.3.pdf. You can view the Infoblox API documentation at https://<ipAddressOfInfobloxApplicance>/api/doc/.

Create DNS Record for record type A

The Create DNS Record operation enables you to create an A type of DNS record.

The following table describes the input elements for the Create DNS record operation if you want to create an A record.

Adapter request elements for the Create DNS Record operation

Element

Description

Required

<operation-name>

Specifies the name of the operation: create-dns-record

Yes

<target>

Contains the following elements:

  • <host>
  • <user-name>
  • <password>
  • <timeout-secs>

Conditional:

  • Required if not specified in the configuration
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<host>

Specifies the host name (fully qualified domain name) or IP address of the Infoblox Grid Manager

Valid value: Any string

Conditional:

  • Required if not specified in the configuration
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<user-name>

Specifies the user name required to connect to the Infoblox Grid Manager

Valid value: Any string

Conditional:

  • Required if not specified in the configuration
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<password>

Specifies the password that corresponds to <user-name>

The <password> element can contain an encryption-type attribute (the Encryption Type field on the form in the form view) that specifies whether the password is encrypted.

Valid value for <password>: Any string

Valid values for encryption-type: base64, plain (default)

Conditional:

  • Required if not specified in the request
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<timeout-secs>

Specifies the time, in seconds, after which the request expires

Valid values: Any integer

Default value: 60 seconds

No

<parameters>

Contains the elements required to execute the operation

Yes

<record-type>

Specifies the type of DNS record that you want to create

Valid value: A

Yes

<comment>

Specifies a user comment

No

<dns-view>

Specifies the DNS view in which the record gets created

By default, a record is created in the default DNS view.

No

<disable>

Specifies whether to disable the DNS record after it is created

Valid values: true, false (default)

No

<scheduled-at>

Specifies the date and time, in ISO 8601 extended format, at which you want to execute the operation

Example: 2008-10-21T10:56:00Z

No

<extensible-attributes>

Contains the <attribute> element

No

<attribute>

Contains a key-value pair designated by the <key> and <value> elements that contain location-specific information for the host, such as building, site, and so on

Multiple instances of <attribute> are permitted.

Example:

<extensible-attributes>
<attribute>
<key>Building</key>
<value>Building 101</value>
</attribute>
<attribute>
<key>Floor</key>
<value>4</value>
</attribute>
</extensible-attributes>

No

<ip-address>

Specifies the IP address to which you want to map the domain name

Valid values: Any IPv4 address

Note: You can create an A record type only for an IPv4 address.

Yes

<a-name>

Specifies the host name that you want to map to an IPv4 address in a Fully Qualified Domain Name (FQDN) format

An A record is created in a zone that must be associated with a network.

Example: admin.demo.com

Here, admin is the host name and demo.com is the authoritative forward-mapping zone name. You may provide the name of any zone that exists in the application.

Yes

Sample <items> XML for creating a DNS record with type A
<items>
   <item>
       <target>
           <host>localhost</host>
           <user-name>admin</user-name>
           <password encryption-type="Base64">YWRtaW4=</password>
           <timeout-secs>120</timeout-secs>
       </target>
          <parameters>
           <record-type>A</record-type>
           <comment>user comment</comment>
           <dns-view>default</dns-view>
           <disable>true</disable>
           <ip-address>10.0.0.0</ip-address>
           <a-name>admin.demo.com</a-name>
           <scheduled-at>2012-11-29T18:30:19+05:30</scheduled-at>
           <extensible-attributes>
               <attribute>
                   <key>Site</key>
                   <value>sample site</value>
               </attribute>
           </extensible-attributes>
          </parameters>
     </item>
</items>
Sample adapter response for creating the DNS Record with type A
<infoblox-vnios-response>
 <metadata>
   <response-count>1</response-count>
   <status>success</status>
 </metadata>
 <responses>
   <create-dns-record-response>
     <metadata>
       <os-id>Windows 2003</os-id>
       <os-version>5.2</os-version>
       <os-arch>x86</os-arch>
       <status>success</status>
       <target>10.128.36.17</target>
     </metadata>
     <commands-output>
       <command-output>
         <metadata>
           <command>perl "C:\BMC Software\AO\Server\7_6_02_01\CDP\server\grids\GRID1\library\adapters\implementations\bmc-adapter-infoblox-nios-actor_20.13.01.00_9\create_dns_record.pl"  "10.128.36.17" "admin" "infoblox" "record-type:A" "comment:user comment" "disable:true" "ttl:1" "dns-view:default" "extensible-attributes:{'Site'=&gt;'sample site',}," "ip-address:10.0.0.0" "a-name:admin.demo.com"</command>
           <line-count>2</line-count>
           <execution-milliseconds>4406</execution-milliseconds>
           <exit-code>0</exit-code>
           <status>success</status>
         </metadata>
         <output>
           <line index="1">Response Code:0</line>
           <line index="2">Response Description:Operation succeeded</line>
         </output>
       </command-output>
     </commands-output>
   </create-dns-record-response>
 </responses>
</infoblox-vnios-response>

 

Back to top

Create DNS Record for record type PTR

The Create DNS Record operation enables you to create a PTR type of DNS record.

The following table describes the input elements for the Create DNS record operation if you want to create a PTR record.

Adapter request elements for the Create DNS Record operation

Element

Description

Required

<operation-name>

Specifies the name of the operation: create-dns-record

Yes

<target>

Contains the following elements:

  • <host>
  • <user-name>
  • <password>
  • <timeout-secs>

Conditional:

  • Required if not specified in the configuration
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<host>

Specifies the host name (fully qualified domain name) or IP address of the Infoblox Grid Manager

Valid value: Any string

Conditional:

  • Required if not specified in the configuration
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<user-name>

Specifies the user name required to connect to the Infoblox Grid Manager

Valid value: Any string

Conditional:

  • Required if not specified in the configuration
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<password>

Specifies the password that corresponds to <user-name>

The <password> element can contain an encryption-type attribute (the Encryption Type field on the form in the form view) that specifies whether the password is encrypted.

Valid value for <password>: Any string

Valid values for encryption-type: base64, plain (default)

Conditional:

  • Required if not specified in the request
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<timeout-secs>

Specifies the time, in seconds, after which the request expires

Valid values: Any integer

Default value: 60 seconds

No

<parameters>

Contains the elements required to execute the operation

Yes

<record-type>

Specifies the type of DNS record that you want to create

Valid value: PTR

Yes

<comment>

Specifies a user comment

No

<dns-view>

Specifies the DNS view in which the record gets created

By default, a record is created in the default DNS view.

No

<disable>

Specifies whether to disable the DNS record after it is created

Valid values: true, false (default)

No

<scheduled-at>

Specifies the date and time, in ISO 8601 extended format, at which you want to execute the operation

Example: 2008-10-21T10:56:00Z

No

<extensible-attributes>

Contains the <attribute> element

No

<attribute>

Contains a key-value pair designated by the <key> and <value> elements that contain location-specific information for the host, such as building, site, and so on

Multiple instances of <attribute> are permitted.

Example:

<extensible-attributes>
<attribute>
<key>Building</key>
<value>Building 101</value>
</attribute>
<attribute>
<key>Floor</key>
<value>4</value>
</attribute>
</extensible-attributes>

No

<ip-address>

Specifies the IP address to which you want to map the domain name

Valid values: Any IPv4 or IPv6 address

Yes

<ptr-name>

Specifies the host name to which you want the PTR record to point

A PTR record can only be added to a reverse-mapping zone.

Example: www.corp100.com

Yes

 

Sample <items> XML for creating a DNS record with type PTR
<items>
   <item>
       <target>
           <host>localhost</host>
           <user-name>admin</user-name>
           <password encryption-type="Base64">YWRtaW4=</password>
           <timeout-secs>120</timeout-secs>
       </target>
          <parameters>
           <record-type>PTR</record-type>
           <comment>user comment</comment>
           <dns-view>default</dns-view>
           <disable>true</disable>
           <ip-address>10.0.0.11</ip-address>
                <ptr-name>www.corp100.com</ptr-name>
           <scheduled-at>2012-11-29T18:30:19+05:30</scheduled-at>
           <extensible-attributes>
               <attribute>
                   <key>Site</key>
                   <value>sample site</value>
               </attribute>
           </extensible-attributes>
          </parameters>
     </item>
</items>
Sample adapter response for creating the DNS Record with type PTR
<infoblox-vnios-response>
 <metadata>
   <response-count>1</response-count>
   <status>success</status>
 </metadata>
 <responses>
   <create-dns-record-response>
     <metadata>
       <os-id>Windows 2003</os-id>
       <os-version>5.2</os-version>
       <os-arch>x86</os-arch>
       <status>success</status>
       <target>10.128.36.17</target>
     </metadata>
     <commands-output>
       <command-output>
         <metadata>
           <command>perl "C:\BMC Software\AO\Server\7_6_02_01\CDP\server\grids\GRID1\library\adapters\implementations\bmc-adapter-infoblox-nios-actor_20.13.01.00_14\create_dns_record.pl"  "10.128.36.17" "admin" "infoblox" "record-type:PTR" "comment:user comment" "disable:true" "dns-view:default" "extensible-attributes:{'Site'=&gt;'sample site',}," "ip-address:10.0.0.61" "ptr-name:host123.demo.com"</command>
           <line-count>2</line-count>
           <execution-milliseconds>24698</execution-milliseconds>
           <exit-code>0</exit-code>
           <status>success</status>
         </metadata>
         <output>
           <line index="1">Response Code:0</line>
           <line index="2">Response Description:Operation succeeded</line>
         </output>
       </command-output>
     </commands-output>
   </create-dns-record-response>
 </responses>
</infoblox-vnios-response>

 

Back to top

Create DNS Record for record type CNAME

The Create DNS Record operation enables you to create a CNAME type of DNS record.

The following table describes the input elements for the Create DNS record operation if you want to create a CNAME record.

Note

You cannot create a CNAME record with IPv6 reverse-mapping zones.

Adapter request elements for the Create DNS Record operation

Element

Description

Required

<operation-name>

Specifies the name of the operation: create-dns-record

Yes

<target>

Contains the following elements:

  • <host>
  • <user-name>
  • <password>
  • <timeout-secs>

Conditional:

  • Required if not specified in the configuration
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<host>

Specifies the host name (fully qualified domain name) or IP address of the Infoblox Grid Manager

Valid value: Any string

Conditional:

  • Required if not specified in the configuration
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<user-name>

Specifies the user name required to connect to the Infoblox Grid Manager

Valid value: Any string

Conditional:

  • Required if not specified in the configuration
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<password>

Specifies the password that corresponds to <user-name>

The <password> element can contain an encryption-type attribute (the Encryption Type field on the form in the form view) that specifies whether the password is encrypted.

Valid value for <password>: Any string

Valid values for encryption-type: base64, plain (default)

Conditional:

  • Required if not specified in the request
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<timeout-secs>

Specifies the time, in seconds, after which the request expires

Valid values: Any integer

Default value: 60 seconds

No

<parameters>

Contains the elements required to execute the operation

Yes

<record-type>

Specifies the type of DNS record that you want to create

Valid value: CNAME

Yes

<comment>

Specifies a user comment

No

<dns-view>

Specifies the DNS view in which the record gets created

By default, a record is created in the default DNS view.

No

<disable>

Specifies whether to disable the DNS record after it is created

Valid values: true, false (default)

No

<scheduled-at>

Specifies the date and time, in ISO 8601 extended format, at which you want to execute the operation

Example: 2008-10-21T10:56:00Z

No

<extensible-attributes>

Contains the <attribute> element

No

<attribute>

Contains a key-value pair designated by the <key> and <value> elements that contain location-specific information for the host, such as building, site, and so on

Multiple instances of <attribute> are permitted.

Example:

<extensible-attributes>
<attribute>
<key>Building</key>
<value>Building 101</value>
</attribute>
<attribute>
<key>Floor</key>
<value>4</value>
</attribute>
</extensible-attributes>

No

<canonical-name>

Specifies the complete canonical or official host name to create a CNAME record to a forward mapping zone

To create a CNAME record for a reverse-mapping zone, specify the host name in the host_ip_addr.prefix.network.in-addr.arpa format.

Example: 10.0.0.1.0.0.10.in-addr.arpa. (For a reverse-mapping zone)

Yes

<cname-name>

Specifies the host name in the FQDN format, that is, host name followed by the domain name

Example: 1.0.0.10.in-addr.arpa

Yes

 

Sample <items> XML for creating a DNS record with type CNAME
<items>
   <item>
       <target>
           <host>localhost</host>
           <user-name>admin</user-name>
           <password encryption-type="Base64">YWRtaW4=</password>
           <timeout-secs>120</timeout-secs>
       </target>
          <parameters>
           <record-type>CNAME</record-type>
           <comment>user comment</comment>
           <dns-view>default</dns-view>
           <disable>true</disable>
           <canonical-name>10.0.0.1.0.0.10.in-addr.arpa</canonical-name>
           <cname-name>1.0.0.10.in-addr.arpa</cname-name>
           <scheduled-at>2012-11-29T18:30:19+05:30</scheduled-at>
           <extensible-attributes>
               <attribute>
                   <key>Site</key>
                   <value>sample site</value>
               </attribute>
           </extensible-attributes>
         </parameters>
     </item>
</items>

The [expand] macro is a standalone macro and it cannot be used inline.
Back to top

Create DNS Record for record type SRV

The Create DNS Record operation enables you to create an SRV type of DNS record.

The following table describes the input elements for the Create DNS record operation if you want to create a SRV record.

Adapter request elements for the Create DNS Record operation

Element

Description

Required

<operation-name>

Specifies the name of the operation: create-dns-record

Yes

<target>

Contains the following elements:

  • <host>
  • <user-name>
  • <password>
  • <timeout-secs>

Conditional:

  • Required if not specified in the configuration
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<host>

Specifies the host name (fully qualified domain name) or IP address of the Infoblox Grid Manager

Valid value: Any string

Conditional:

  • Required if not specified in the configuration
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<user-name>

Specifies the user name required to connect to the Infoblox Grid Manager

Valid value: Any string

Conditional:

  • Required if not specified in the configuration
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<password>

Specifies the password that corresponds to <user-name>

The <password> element can contain an encryption-type attribute (the Encryption Type field on the form in the form view) that specifies whether the password is encrypted.

Valid value for <password>: Any string

Valid values for encryption-type: base64, plain (default)

Conditional:

  • Required if not specified in the request
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<timeout-secs>

Specifies the time, in seconds, after which the request expires

Valid values: Any integer

Default value: 60 seconds

No

<parameters>

Contains the elements required to execute the operation

Yes

<record-type>

Specifies the type of DNS record that you want to create

Valid value: CNAME

Yes

<comment>

Specifies a user comment

No

<dns-view>

Specifies the DNS view in which the record gets created

By default, a record is created in the default DNS view.

No

<disable>

Specifies whether to disable the DNS record after it is created

Valid values: true, false (default)

No

<srv-name>

Specifies the host name in the FQDN format, that is, host name followed by the authoritative forward-mapping zone name

Example: admin.demo.com

Yes

<srv-port>

Specifies the port number for the SRV record

Yes

<srv-priority>

Specifies the priority for the SRV record 

The priority determines the order in which the client attempts to contact the target host.

Valid values: Any integer between 0 to 65535

Yes

<srv-weight>

Specifies the weight of the SRV record 

Valid values: Any integer between 0 to 65535

Yes

<srv-target>

Specifies the canonical domain name for the host with the name of the authoritative forward-mapping zone

Example: admin.demo.com

Here demo.com is the name of the authoritative forward-mapping zone.

No

<scheduled-at>

Specifies the date and time, in ISO 8601 extended format, at which you want to execute the operation

Example: 2008-10-21T10:56:00Z

No

<extensible-attributes>

Contains the <attribute> element

No

<attribute>

Contains a key-value pair designated by the <key> and <value> elements that contain location-specific information for the host, such as building, site, and so on

Multiple instances of <attribute> are permitted.

Example:

<extensible-attributes>
<attribute>
<key>Building</key>
<value>Building 101</value>
</attribute>
<attribute>
<key>Floor</key>
<value>4</value>
</attribute>
</extensible-attributes>

No

 

Sample <items> XML for creating a DNS record with type SRV
<items>
   <item>
       <target>
           <host>localhost</host>
           <user-name>admin</user-name>
           <password encryption-type="Base64">YWRtaW4=</password>
           <timeout-secs>120</timeout-secs>
       </target>
          <parameters>
           <record-type>SRV</record-type>
           <comment>user comment</comment>
           <dns-view>default</dns-view>
           <disable>true</disable>
           <srv-name>admin.demo.com</srv-name>
           <srv-port>11</srv-port>
           <srv-priority>10</srv-priority>
           <srv-weight>10</srv-weight>
           <srv-target>admin.demo.com</srv-target>
           <scheduled-at>2012-11-29T18:30:19+05:30</scheduled-at>
           <extensible-attributes>
               <attribute>
                   <key>Site</key>
                   <value>sample site</value>
               </attribute>
           </extensible-attributes>
          </parameters>
     </item>
</items>

The [expand] macro is a standalone macro and it cannot be used inline.
Back to top

Create DNS Record for record type TXT

The Create DNS Record operation enables you to create a TXT type of DNS record.

The following table describes the input elements for the Create DNS record operation if you want to create a TXT record.

Adapter request elements for the Create DNS Record operation

Element

Description

Required

<operation-name>

Specifies the name of the operation: create-dns-record

Yes

<target>

Contains the following elements:

  • <host>
  • <user-name>
  • <password>
  • <timeout-secs>

Conditional:

  • Required if not specified in the configuration
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<host>

Specifies the host name (fully qualified domain name) or IP address of the Infoblox Grid Manager

Valid value: Any string

Conditional:

  • Required if not specified in the configuration
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<user-name>

Specifies the user name required to connect to the Infoblox Grid Manager

Valid value: Any string

Conditional:

  • Required if not specified in the configuration
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<password>

Specifies the password that corresponds to <user-name>

The <password> element can contain an encryption-type attribute (the Encryption Type field on the form in the form view) that specifies whether the password is encrypted.

Valid value for <password>: Any string

Valid values for encryption-type: base64, plain (default)

Conditional:

  • Required if not specified in the request
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<timeout-secs>

Specifies the time, in seconds, after which the request expires

Valid values: Any integer

Default value: 60 seconds

No

<parameters>

Contains the elements required to execute the operation

Yes

<record-type>

Specifies the type of DNS record that you want to create

Valid value: TXT

Yes

<comment>

Specifies a user comment

No

<dns-view>

Specifies the DNS view in which the record gets created

By default, a record is created in the default DNS view.

No

<disable>

Specifies whether to disable the DNS record after it is created

Valid values: true, false (default)

No

<scheduled-at>

Specifies the date and time, in ISO 8601 extended format, at which you want to execute the operation

Example: 2008-10-21T10:56:00Z

No

<extensible-attributes>

Contains the <attribute> element

No

<attribute>

Contains a key-value pair designated by the <key> and <value> elements that contain location-specific information for the host, such as building, site, and so on

Multiple instances of <attribute> are permitted.

Example:

<extensible-attributes>
<attribute>
<key>Building</key>
<value>Building 101</value>
</attribute>
<attribute>
<key>Floor</key>
<value>4</value>
</attribute>
</extensible-attributes>

No

<txt-string>

Specifies the text that you want to associate with a record 

You can specify text strings up to 512 bytes.

Yes

<txt-name>

Specifies the host name of the web server with the authoritative forward-mapping zone for which you are creating aTXT record

Example: admin.demo.com

Yes

 

Sample <items> XML for creating a DNS record with type TXT
<items>
   <item>
       <target>
           <host>localhost</host>
           <user-name>admin</user-name>
           <password encryption-type="Base64">YWRtaW4=</password>
           <timeout-secs>120</timeout-secs>
       </target>
          <parameters>
           <record-type>TXT</record-type>
           <comment>user comment</comment>
           <dns-view>default</dns-view>
           <disable>true</disable>
           <txt-string>This is the infomrations which will be associated with the TXT record</txt-string>
           <txt-name>admin.demo.com</txt-name>
           <scheduled-at>2012-11-29T18:30:19+05:30</scheduled-at>
           <extensible-attributes>
               <attribute>
                   <key>Site</key>
                   <value>sample site</value>
               </attribute>
           </extensible-attributes>
          </parameters>
     </item>
</items>

The [expand] macro is a standalone macro and it cannot be used inline.
Back to top

Create DNS Record for record type MX

The Create DNS Record operation enables you to create a MX type of DNS record.

The following table describes the input elements for the Create DNS record operation if you want to create a PTR record.

Adapter request elements for the Create DNS Record operation

Element

Description

Required

<operation-name>

Specifies the name of the operation: create-dns-record

Yes

<target>

Contains the following elements:

  • <host>
  • <user-name>
  • <password>
  • <timeout-secs>

Conditional:

  • Required if not specified in the configuration
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<host>

Specifies the host name (fully qualified domain name) or IP address of the Infoblox Grid Manager

Valid value: Any string

Conditional:

  • Required if not specified in the configuration
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<user-name>

Specifies the user name required to connect to the Infoblox Grid Manager

Valid value: Any string

Conditional:

  • Required if not specified in the configuration
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<password>

Specifies the password that corresponds to <user-name>

The <password> element can contain an encryption-type attribute (the Encryption Type field on the form in the form view) that specifies whether the password is encrypted.

Valid value for <password>: Any string

Valid values for encryption-type: base64, plain (default)

Conditional:

  • Required if not specified in the request
  • If specified in the configuration and request, the value in the request overrides the value in the configuration
<timeout-secs>

Specifies the time, in seconds, after which the request expires

Valid values: Any integer

Default value: 60 seconds

No

<parameters>

Contains the elements required to execute the operation

Yes

<record-type>

Specifies the type of DNS record that you want to create

Valid value: PTR

Yes

<comment>

Specifies a user comment

No

<dns-view>

Specifies the DNS view in which the record gets created

By default, a record is created in the default DNS view.

No

<disable>

Specifies whether to disable the DNS record after it is created

Valid values: true, false (default)

No

<scheduled-at>

Specifies the date and time, in ISO 8601 extended format, at which you want to execute the operation

Example: 2008-10-21T10:56:00Z

No

<extensible-attributes>

Contains the <attribute> element

No

<attribute>

Contains a key-value pair designated by the <key> and <value> elements that contain location-specific information for the host, such as building, site, and so on

Multiple instances of <attribute> are permitted.

Example:

<extensible-attributes>
<attribute>
<key>Building</key>
<value>Building 101</value>
</attribute>
<attribute>
<key>Floor</key>
<value>4</value>
</attribute>
</extensible-attributes>

No

<mx-preference>

Specifies the value that for the DNS shared MX record

The preference value determines the order in which a client attempts to contact the target mail exchange sever.

Valid value: Any integer between 0 to 65535

Yes

<mx-exchanger>

Specifies the name of the mail exchange sever in an FQDN format

Yes

<mx-domain-name>

Specifies the domain name of the mail exchange server in an FQDN format

Example: If you want to create an MX record for a mail exchanger serving admin.demo.com, a subdomain of demo.com and you define the MX record in the demo.com zone, enter admin.demo.com in this field. If you want to define an MX record for a domain and all its subdomains, enter an asterisk (*.demo.com ) to create a wildcard MX record.

Yes

 

Sample <items> XML for creating a DNS record with type MX
<items>
   <item>
       <target>
           <host>localhost</host>
           <user-name>admin</user-name>
           <password encryption-type="Base64">YWRtaW4=</password>
           <timeout-secs>120</timeout-secs>
       </target>
          <parameters>
           <record-type>MX</record-type>
           <comment>user comment</comment>
           <dns-view>default</dns-view>
           <disable>true</disable>
           <mx-preference>10</mx-preference>
           <mx-exchanger>10.0.0.12</mx-exchanger>
           <mx-domain-name>admin.demo.com</mx-domain-name>
           <scheduled-at>2012-11-29T18:30:19+05:30</scheduled-at>
           <extensible-attributes>
               <attribute>
                   <key>Site</key>
                   <value>sample site</value>
               </attribute>
           </extensible-attributes>
          </parameters>
     </item>
</items>

The [expand] macro is a standalone macro and it cannot be used inline.
Back to top

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*