Infoblox AllocateNextAvailable
CertifiedEnterprise EditionAllocate the next available address from a subnet or address block in Infoblox Universal DDI
Infoblox AllocateNextAvailable
Allocate the next available address from a subnet or address block in Infoblox Universal DDI
Calls the Cloud Services Portal nextavailableip endpoint on parentId (a subnet or address block id) to obtain a candidate address, then creates an ipam/address object for it.
Unlike the confirmed-atomic NIOS WAPI func: nextavailableip expression (which selects AND reserves the address in a single request), this task implements a best-effort "get candidate then create" pattern: the candidate is fetched with one request and reserved with a second. Universal DDI's exact atomicity guarantee for this sequence has not been verified against a live tenant — under concurrent callers a race is possible where two callers are handed the same candidate before either creates its reservation. Serialize calls to this task per subnet/address block if you need a stronger guarantee.
type: io.kestra.plugin.ee.infoblox.csp.ipam.address.AllocateNextAvailableExamples
Reserve the next free address from a subnet.
id: infoblox_csp_allocate_ip
namespace: company.team
tasks:
- id: allocate_ip
type: io.kestra.plugin.ee.infoblox.csp.ipam.address.AllocateNextAvailable
url: "https://csp.infoblox.com"
apiKey: "{{ secret('INFOBLOX_CSP_API_KEY') }}"
parentId: "ipam/subnet/11111111-1111-1111-1111-111111111111"
space: "ipam/ip_space/11111111-1111-1111-1111-111111111111"
Properties
apiKey *string
API key
Infoblox Cloud Services Portal API key, sent as Authorization: Token <apiKey>. Generate it from the CSP under Administration > Authentication > API Keys.
parentId *string
Parent subnet or address block identifier
id of the ipam/subnet or ipam/address_block to draw the next available address from.
space *string
IP space
id of the ipam/ip_space the reserved address belongs to (for example: ipam/ip_space/
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150comment string
Comment
Optional comment stored with the reserved address.
options
HTTP client configuration
Optional HTTP client overrides (timeouts, TLS settings, proxies). Uses platform defaults when omitted.
io.kestra.core.http.client.configurations.HttpConfiguration
falseIf true, allow a failed response code (response code >= 400)
List of response code allowed for this request
The authentication to use.
io.kestra.core.http.client.configurations.BasicAuthConfiguration
The password for HTTP basic authentication.
The username for HTTP basic authentication.
io.kestra.core.http.client.configurations.BearerAuthConfiguration
The token for bearer token authentication.
io.kestra.core.http.client.configurations.DigestAuthConfiguration
The password for HTTP Digest authentication.
The username for HTTP Digest authentication.
UTF-8The default charset for the request.
java.nio.charset.Charset
trueWhether to enable TCP Keep-Alive extended socket options (TCP_KEEPIDLE, TCP_KEEPINTERVAL, TCP_KEEPCOUNT).
Set to false when running on Windows workers, as these extended socket options are not supported by the Windows JDK and will cause connection failures.
trueWhether redirects should be followed automatically.
REQUEST_HEADERSREQUEST_BODYRESPONSE_HEADERSRESPONSE_BODYThe enabled log.
The proxy configuration.
io.kestra.core.http.client.configurations.ProxyConfiguration
The address of the proxy server.
The password for proxy authentication.
The port of the proxy server.
DIRECTDIRECTHTTPSOCKSThe type of proxy to use.
The username for proxy authentication.
The SSL request options
io.kestra.core.http.client.configurations.SslOptions
Whether to disable checking of the remote SSL certificate.
Only applies if no trust store is configured. Note: This makes the SSL connection insecure and should only be used for testing. If you are using a self-signed certificate, set up a trust store instead.
The timeout configuration.
io.kestra.core.http.client.configurations.TimeoutConfiguration
The time allowed to establish a connection to the server before failing.
PT5MThe time allowed for a read connection to remain idle before closing it.
url string
https://csp.infoblox.comInfoblox Universal DDI (Cloud Services Portal) URL
Base URL of the Infoblox Cloud Services Portal. Defaults to https://csp.infoblox.com (US region). Use the regional host matching your tenant, for example https://csp.eu.infoblox.com (EU) or another Infoblox-published regional endpoint. Trailing slash is optional.
Outputs
address string
Allocated address
The address that was selected and reserved.
id string
Reserved address identifier
Universal DDI id of the created address. Pass this to Release to delete the reservation.
