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


 Sample adapter request for the Create Host Record operation


<infoblox-vnios-actor-request>
    <operation-name>create-host-record</operation-name>
    <parameters>
      <ipv4-hosts>10.128.249.60,10.128.249.61</ipv4-hosts>
      <name>myhostname</name>
      <zone>test.com</zone>
      <aliases>host1,host2</aliases>
      <comment>create by adapter</comment>
      <disable>true</disable>
      <configure-for-dns>false</configure-for-dns>
      <scheduled-at>2012-11-29T18:30:19+05:30</scheduled-at>
    </parameters>
</infoblox-vnios-actor-request>


 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>

Was this page helpful? Yes No Submitting... Thank you

Comments