Release Addresses operation

The Release Addresses operation frees the specified used IPv4 or IPv6 addresses within a network and makes them available. When you release an IP address, the its status changes from used to unused. You can specify a single IP address or multiple IP addresses.

Adapter request elements for the Release Addresses operation

Element	Description	Required
`<operation-name>`	Specifies the name of the operation: `release-addresses`	No
`<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 attempt to connect to the Infoblox application expires Valid values: Any integer Default value: 60 seconds	No
`<parameters>`	Contains the following elements: `<network>` `<mask>` `<network-view>` `<ip-address>`	Yes
`<network>`	Specifies the network or subnetwork that contains the IP address that you want to release You must specify `<network>` in a Classless Inter-Domain Routing (CIDR) format.	Yes
`<mask>`	Sets the subnet mask for the network The value for `<mask>` must be compatible with the network range.	Yes
`<network-view>`	Specifies the single routing domain in which the IPv4 or IPv6 network is located If not specified, by default, the IP addresses in the default network view are retrieved.	No
`<ip-address>`	Specifies the IP address that you want to release Note: If you do not specify an IP address, all the IP addresses in the specified network are released.	Conditional: Required if a single or a specific IP address needs to be released. If not specified in the request, all the addresses from given network are released

Sample adapter request for the Release Addresses operation


<infoblox-vnios-actor-request>
  <operation-name>release-addresses</operation-name>
			<host>localhost</host>
			<user-name>ad***</user-name>
			<password encryption-type="Base64">YWRtaW4=</password>
			<timeout-secs>120</timeout-secs>
		</target>
           <parameters>
		    <network>10.0.0.0</network>
		    <mask>24</mask>
                   <network-view>default</network-view>
		    <ip-address>10.0.0.3</ip-address>
           </parameters>
</infoblox-vnios-actor-request>

Sample adapter response for Release Addresses operation

<infoblox-vnios-response>
  <metadata>
    <response-count>1</response-count>
    <status>success</status>
  </metadata>
  <responses>
    <release-addresses-response>
      <metadata>
        <os-id>Windows 2003</os-id>
        <os-version>5.2</os-version>
        <os-arch>x86</os-arch>
        <status>success</status>
        <target>10.128.36.17</target>
      </metadata>
      <commands-output>
        <command-output>
          <metadata>
            <command>perl "C:\BMC Software\AO\Server\7_6_02_01\CDP\server\grids\GRID1\library
\adapters\implementations\bmc-adapter-infoblox-nios-actor_20.13.01.00_5\
release_addresses.pl"  "10.128.36.17" "ad***" "i@cbol" "network:55.5.10.0" "mask:24"</command>
            <line-count>2</line-count>
            <execution-milliseconds>8687</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>
    </release-addresses-response>
  </responses>
</infoblox-vnios-response>

Release Addresses operation

Comments