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
| | |
|---|
| Specifies the name of the operation: release-addresses | |
| 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
|
| 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
|
| 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
|
| 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
|
| Specifies the time, in seconds, after which the attempt to connect to the Infoblox application expires
Valid values: Any integer
Default value: 60 seconds | |
| Contains the following elements: - <network>
- <mask>
- <network-view>
- <ip-address>
| |
| 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. | |
| Sets the subnet mask for the network
The value for <mask> must be compatible with the network range. | |
| 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. | |
| 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
|
The [expand] macro is a standalone macro and it cannot be used inline.
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>