Create Host Record operation

The Create Host Record operation creates a host record in the Infoblox Grid Manager. You can create a host record for IPv4 or IPv6 addresses.

Adapter request elements for the Create Host Record operation

Element

Description

Required

<operation-name>

Specifies the name of the operation: create-host-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 times out

Valid values: Any integer

Default value: 60 seconds

No

<parameters>

Contains the elements required to execute the request

Yes

<ipv4-hosts>

Specifies the comma-separated list of IPv4 addresses for which the host record is created

Example: 10.0.0.1,10.0.0.2

Yes

<name>

Specifies the name for the host record

Yes

<zone>

Specifies the zone for which the host record is created

Note: <zone> must be a valid zone in the Infoblox Grid Manager.

Yes

<aliases>

Specifies the comma-separated list of aliases for the host record

Example: host1,host2,host3

No

<ipv6-hosts>

Specifies the comma-separated list of IPv6 address for which the host record is created

Example: 2001:a000::0000,2001:b000::0000

Conditional; required if you want the host record for IPv6 addresses

<disable>

Marks the host as disabled

Valid values: true, false (default)

No

<configure-for-dns>

Indicates if the host is configured for a domain name server (DNS) entry

Valid values: false, true (default)

No

<dns-view>

Specifies the DNS view in which you want to create the host record

Default value: default

Conditional; required if you want to create the host record in any other DNS view than default

<network-view>

Specifies the network view in which you want to create the host record

Default value: default

Conditional; required if you want to create the host record in any other network view than default

<comment>

Specifies a user comment for the host record

Valid value: Any string

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>test</value>
 </attribute>
 <attribute>
   <key>Site</key>
   <value>ICC</value>
 </attribute>
</extensible-attributes>

No

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

Sample adapter response for the Create Host Record operation

 


<infoblox-vnios-response>
 <metadata>
   <response-count>1</response-count>
   <status>success</status>
 </metadata>
 <responses>
   <create-host-response>
     <metadata>
       <os-id>Linux</os-id>
       <os-version>2.6.18-1.2747.el5</os-version>
       <os-arch>i386</os-arch>
       <status>success</status>
       <target>10.128.249.111</target>
     </metadata>
     <commands-output>
       <command-output>
         <metadata>
           <command>perl "/home/user/LAPfor118/server/grids/GRID1/library/adapters/implementations/bmc-adapter-infoblox-vnios-actor_20.12.03.00_3/create_host.pl"
"10.128.249.111" "ad***" "i@cbol" "ipv4-hosts:10.128.249.60,10.128.249.61"
"name:myhostname" "zone:test.com" "aliases:host1,host2" "configure-for-dns:false"
"comment:create by adapter" "disable:true"</command>
           <line-count>2</line-count>
           <execution-milliseconds>3475</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-host-response>
 </responses>
</infoblox-vnios-response>

 

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