Create Network operation for the Infoblox NIOS adapter

The Create Network operation creates an IPv4 or IPv6 network in the Infoblox Grid Manager.

Adapter request elements for the Create Network operation

Element

Description

Required

<operation-name>

Specifies the name of the operation: create-network

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

<network>

Specifies the IPv4 or IPv6 network or subnetwork to be created in a Classless Inter-Domain Routing (CIDR) format

Yes

<mask>

Sets the mask for the network

The value for <mask> must be compatible with the network range.

Yes

<disable>

Marks the network as disabled

Valid values: true, false (default)

No

<authority>

Sets the authority flag for the network, which specifies whether a Dynamic Host Configuration Protocol (DHCP) server is authoritative for a domain

Valid values: true, false (defult)

No

<comment>

Specifies a user comment for the network

Valid value: Any string

No

<template>

Specifies the template that must be used to create the network

If you specify a template, the values specified in the template take precedence over those specified in the request and the request elements are ignored.

Valid values: Any string

No

<auto-create-reversezone>

Sets the auto-create reverse zone flag of the network, which automatically creates reverse-mapping zones for the subnet

Valid values: true, false

No

<lease-settings>

Contains the following elements:

  • <lease-time>
  • <routers>
  • <domain-name>
  • <broadcast-address>
  • <dns-servers>

No

<lease-time>

Specifies the lease time of an IP address to a DHCP client

No

<routers>

Specifies the comma-separated IP addresses of routers

Example: 10.0.0.1,10.0.0.2

The <routers> element is valid only if you specify <failover-association> or <grid-member-address>.

No

<domain-name>

Specifies the name of the domain for which the server serves DHCP data

The <domain-name> element is valid only if you specify <failover-association> or <grid-member-address>.

No

<broadcast-address>

Specifies the broadcast IP address of the network to which the DHCP server is attached

The <broadcast-address> element is valid only if you specify <failover-association> or <grid-member-address>.

No

<dns-servers>

Specifies the comma-separated list of DNS servers to which this network is to be connected

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 network, 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>Floor</key>
    <value>4</value>
  </attribute>
</extensible-attributes>

No

 Sample adapter request for the Create Network operation


<infoblox-vnios-actor-request>
<operation-name>create-network</operation-name>
    <target>
        <host>10.128.249.111</host>
        <user-name>ad***</user-name>
        <password>i@cbol</password>
    </target>
<parameters>
    <network>55.0.0.0</network>
    <mask>24</mask>
    <disable>true</disable>
    <authority>true</authority>
    <comment>this is the sample comment using the adapter xml.</comment>
    <template>test template</template>
    <auto-create-reversezone>true</auto-create-reversezone>
        <lease-settings>
            <lease-time>360</lease-time>
            <routers>10.0.0.1,10.0.0.2</routers>
            <domain-name>domain.com</domain-name>
            <broadcast-address>10.0.0.3</broadcast-address>
            <dns-servers>10.0.0.4,10.0.0.5</dns-servers>
    </lease-settings>
    <scheduled-at>2012-11-29T18:30:19+05:30</scheduled-at>
    <extensible-attributes>
            <attribute>
            <key>Building</key>
            <value>sample</value>
            </attribute>
    </extensible-attributes>
</parameters>
</infoblox-vnios-actor-request>


 Sample adapter response for the Create Network operation


<infoblox-vnios-response>
  <metadata>
    <response-count>1</response-count>
    <status>success</status>
  </metadata>
  <responses>
    <create-network-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_6/create_network.pl"  "10.128.249.111" "ad***" "i@cbol" "network:28.0.0.0" "mask:24"</command>
            <line-count>2</line-count>
            <execution-milliseconds>3219</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-network-response>
  </responses>
</infoblox-vnios-response>

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

Comments