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>

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

Comments