Retrieve DNS Record operation

The Retrieve DNS Record operation finds the type of DNS record that you specify from the Infoblox application.

For retrieving a DNS record, you can use the following elements in the adapter request:

<name>
<dns-view>
<zone>
<comment>
<extensible-attributes>

You must specify at least one element in the adapter request to retrieve the DNS records.

Adapter request elements for the Retrieve 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 the DNS record that you want to retrieve Valid values: A PTR SRV CNAME TXT MX You can specify only one type of record to retrieve in one request.	Yes
<name>	Specifies the name of the record that you want to retrieve You can specify the name of the DNS record based on the type of record that you want to retrieve. Values for each record type: A: Host name in an FQDN format. PTR: Host name to which the PTR record is pointed to. SRV: Name in an FQDN format. CNAME: Host name in an FQDN format. TXT: Host name in an FQDN format. MX: Domain name in an FQDN format.	Conditional; required if you want to retrieve DNS that match the <name>
<dns-view>	Specifies the DNS view in which the record is created, which you want to retrieve If you do not specify a view, by default, records from all the DNS views appear.	Conditional; required if you want to retrieve DNS that match the <dns-view>
<zone>	Specifies the zone in which the DNS record is created Note: If you specify just the zone and no DNS view, then records in the Default DNS view only are retrieved.	Conditional; required if you want to retrieve DNS that match the <zone>
<comment>	Specifies any additional information provided in the record by the user	Conditional; required if you want to retrieve DNS that match the <name>
<extensible-attributes>	Specifies the key-value pair that contains any additional information about the record You can retrieve records based on multiple attributes.	Conditional; required if you want to retrieve DNS that match the <extensible-attributes>

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

Sample <items> XML for retrieving all DNS records based on the DNS view

<infoblox-vnios-response>
<metadata>
   <response-count>1</response-count>
   <status>success</status>
</metadata>
<responses>
   <retrieve-dns-record-response>
     <metadata>
       <os-id>Linux</os-id>
       <os-version>2.6.18-164.el5</os-version>
       <os-arch>amd64</os-arch>
       <status>success</status>
       <target>10.128.36.17</target>
     </metadata>
     <commands-output>
       <command-output>
         <metadata>
           <command>perl "/home/shantanu/760205/cdp/server/grids/GRID1/library/adapters/implementations/bmc-adapter-infoblox-nios-actor_20.13.01.00_2/retrieve_dns_record.pl" "10.128.36.17" "admin" "infoblox" "dns-view:Test DNS View" "record-type:TXT"</command>
           <line-count>29</line-count>
           <execution-milliseconds>4071</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>
           <items>
             <item>
               <record-type>TXT</record-type>
               <name>txt1.demo.com</name>
               <comment>from retrieving</comment>
               <disable>false</disable>
               <zone>demo.com</zone>
               <dns-view>Test DNS View</dns-view>
               <ttl />
               <txt-string>test record</txt-string>
               <extensible_attributes />
             </item>
             <item>
               <record-type>TXT</record-type>
               <name>qqqqq.forwardmappingzone</name>
               <comment />
               <disable>false</disable>
               <zone>forwardmappingzone</zone>
               <dns-view>Test DNS View</dns-view>
               <ttl />
               <txt-string>!@#$%^&*()_+~ASM,.?/|}{[]</txt-string>
               <extensible-attributes>
                 <attribute>
                   <key>Site</key>
                   <value>main</value>
                 </attribute>
                 <attribute>
                   <key>State</key>
                   <value>NY</value>
                 </attribute>
               </extensible-attributes>
             </item>
             <item>
               <record-type>TXT</record-type>
               <name>forwardmappingzone_testview</name>
               <comment>This is demo TXT record</comment>
               <disable>false</disable>
               <zone>forwardmappingzone_testview</zone>
               <dns-view>Test DNS View</dns-view>
               <ttl>1</ttl>
               <txt-string>10.0.0.2</txt-string>
               <extensible-attributes>
                 <attribute>
                   <key>Site</key>
                   <value>sample site</value>
                 </attribute>
               </extensible-attributes>
             </item>
           </items>
         </output>
       </command-output>
     </commands-output>
   </retrieve-dns-record-response>
</responses>
</infoblox-vnios-response>

Retrieve DNS Record operation

On this page