Release IP Range operation

The Release IP Range operation removes an existing reserved IPv4 or IPv6 range from an existing network.

Adapter request elements for the Release IP Range operation

Element

Description

Required

<operation-name>

Specifies the name of the operation: release-ip-range

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 operation

Yes

<network>

Specifies the network or subnetwork, in Classless Inter-Domain Routing (CIDR) format, from which the IP range is to be released

Yes

<start-address>

Specifies the start address of the range to be released

Conditional; required if you specify an IPv4 network

<end-address>

Specifies the end address of the range to be released

Conditional; required if you specify an IPv4 network

<ipv6-start-prefix>

Specifies the start prefix of the IPv6 range that is used to renumber the network

Conditional; required if you use an IPv6 network

<ipv6-end-prefix>

Specifies the end prefix of the IPv6 range that is used to renumber the network

Conditional; required if you use an IPv6 network

<ipv6-prefix-bits>

Specifies the prefix bits of the IPv6 range that are used to specify the network

Conditional; required if you use an IPv6 network

<comment>

Specifies a user comment for the range to be released

Valid value: Any string

No

<failover-association>

Specifies the failover association for the range to be released

Note: Specify either the <failover-association> element or the <grid-member-address> element. If you specify both the elements, <failover-association> takes precedence.

No

<grid-member-address>

Specifies the IP address of the grid member for the created range

Note: Specify either the <failover-association> element or the <grid-member-address> element. If you specify both the elements, <failover-association> takes precedence.

No

<server-association-type>

Specifies the server association type

Valid values for an IPv4 range: NONE, MEMBER, FAILOVER, MS_SERVER

Valid values for an IPv6 range: NONE, MEMBER

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 Release IP Range operation


<infoblox-vnios-actor-request>
<operation-name>release-ip-range</operation-name>
    <target>
        <host>10.128.249.111</host>
        <user-name>ad***</user-name>
        <password>i@cbol</password>
    </target>
    <parameters>
         <network>10.10.10.0/24</network>
         <start-address>10.10.10.20</start-address>
         <end-address>10.10.10.30</end-address>
         <ipv6-start-prefix>2001:db8:0:c000:0011::</ipv6-start-prefix>
         <ipv6-end-prefix>2001:db8:0:c000:0021::</ipv6-end-prefix>
         <comment>user comment</comment>
         <failover-association>Test_Assoc</failover-association>
         <server-association-type>Member</server-association-type>
         <grid-member-address>10.0.0.0</grid-member-address>
            <extensible-attributes>
            <attribute>
                 <key>Building</key>
                 <value>value1</value>
             </attribute>
             <attribute>
                 <key>Site</key>
                 <value>value2</value>
             </attribute>
         </extensible-attributes>
    </parameters>
</infoblox-vnios-actor-request>>


 Sample adapter response for the Release IP Range 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/release_ip_range.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