Infoblox Triggers IpAllocationTrigger

Infoblox Triggers IpAllocationTrigger
Certified
Enterprise Edition
Trigger on IPv4/IPv6 address allocation or release events in Infoblox

Polls the Infoblox WAPI ipv4address or ipv6address endpoint at a configured interval and fires an execution only when the set of matching addresses changes since the last poll. Each state change (addresses added or removed) produces one execution containing only the delta. Use watchStatus=USED to detect allocated addresses, watchStatus=UNUSED to detect released ones.

yaml
type: io.kestra.plugin.ee.infoblox.ipam.trigger.IpAllocationTrigger

Examples

Trigger when IP addresses are allocated in a network.

yaml
id: infoblox_ip_allocation_trigger
namespace: company.team

tasks:
  - id: log_allocation
    type: io.kestra.plugin.core.log.Log
    message: "IP events: {{ trigger.addedCount }} added, {{ trigger.removedCount }} removed in {{ trigger.network }}"

triggers:
  - id: watch_allocations
    type: io.kestra.plugin.ee.infoblox.ipam.trigger.IpAllocationTrigger
    url: "{{ secret('INFOBLOX_URL') }}"
    username: "{{ secret('INFOBLOX_USERNAME') }}"
    password: "{{ secret('INFOBLOX_PASSWORD') }}"
    network: "10.0.0.0/24"
    interval: PT1M
    watchStatus: USED

Properties

network *string

Network CIDR

IPv4 or IPv6 network CIDR to watch (for example: 10.0.0.0/24).

password *string

WAPI password

Password for HTTP Basic authentication.

url *string

Infoblox Grid Manager URL

Base URL of the Grid Manager (for example: https://infoblox.example.com).

username *string

WAPI username

Username for HTTP Basic authentication.

allowConcurrent boolean

Defaultfalse

Specifies whether a trigger is allowed to start a new execution even if a previous run is still in progress.

interval string

DefaultPT1M

Formatduration

Poll interval

How often to poll the WAPI. Defaults to PT1M.

options

HTTP client configuration

Optional HTTP overrides (TLS, timeouts).

Definitions

io.kestra.core.http.client.configurations.HttpConfiguration

allowFailedbooleanstring

Defaultfalse

If true, allow a failed response code (response code >= 400)

allowedResponseCodesarray

SubTypeinteger

List of response code allowed for this request

auth

The authentication to use.

io.kestra.core.http.client.configurations.BasicAuthConfiguration

type*object

passwordstring

The password for HTTP basic authentication.

usernamestring

The username for HTTP basic authentication.

io.kestra.core.http.client.configurations.BearerAuthConfiguration

type*object

tokenstring

The token for bearer token authentication.

io.kestra.core.http.client.configurations.DigestAuthConfiguration

type*object

passwordstring

The password for HTTP Digest authentication.

usernamestring

The username for HTTP Digest authentication.

defaultCharsetstring

DefaultUTF-8

The default charset for the request.

java.nio.charset.Charset

enabledTcpExtendedKeepAlivebooleanstring

Defaulttrue

Whether 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.

followRedirectsbooleanstring

Defaulttrue

Whether redirects should be followed automatically.

logsarray

SubTypestring

Possible Values

REQUEST_HEADERSREQUEST_BODYRESPONSE_HEADERSRESPONSE_BODY

The enabled log.

proxy

The proxy configuration.

io.kestra.core.http.client.configurations.ProxyConfiguration

addressstring

The address of the proxy server.

passwordstring

The password for proxy authentication.

portintegerstring

The port of the proxy server.

typestring

DefaultDIRECT

Possible Values

DIRECTHTTPSOCKS

The type of proxy to use.

usernamestring

The username for proxy authentication.

retry

Retry strategy for HTTP requests.

retry is disabled by default.

Constant retry

Retry with a fixed delay between attempts.

interval*string

Formatduration

type*object

behaviorstring

DefaultRETRY_FAILED_TASK

Possible Values

RETRY_FAILED_TASKCREATE_NEW_EXECUTION

maxAttemptsinteger

Minimum>= 1

maxDurationstring

Formatduration

warningOnRetryboolean

Defaultfalse

Exponential retry

Retry with exponentially increasing delays between attempts.

interval*string

Formatduration

maxInterval*string

Formatduration

type*object

behaviorstring

DefaultRETRY_FAILED_TASK

Possible Values

RETRY_FAILED_TASKCREATE_NEW_EXECUTION

delayFactornumber

maxAttemptsinteger

Minimum>= 1

maxDurationstring

Formatduration

warningOnRetryboolean

Defaultfalse

Random retry

Retry with a random delay within a configurable range between attempts.

maxInterval*string

Formatduration

minInterval*string

Formatduration

type*object

behaviorstring

DefaultRETRY_FAILED_TASK

Possible Values

RETRY_FAILED_TASKCREATE_NEW_EXECUTION

maxAttemptsinteger

Minimum>= 1

maxDurationstring

Formatduration

warningOnRetryboolean

Defaultfalse

retryOnStatusCodesarray

SubTypeinteger

Default[502,503,504]

HTTP status codes that should be retried.

Used for idempotent methods (GET, HEAD) without their own entry in retryOnStatusCodesByMethod. Non-idempotent methods are never retried on a status code unless listed in retryOnStatusCodesByMethod. Defaults to 502, 503 and 504 for idempotent methods (GET, HEAD) only.

retryOnStatusCodesByMethodobject

SubTypearray

Per-HTTP-method overrides for which status codes should be retried.

Keys are HTTP methods (e.g. GET, POST). A method with no entry here falls back to retryOnStatusCodes. This lets a caller retry more broadly for safe, read-only methods (for example, every 5xx and a 429 for GET/HEAD) while keeping a narrower list for methods that write, where retrying a request that may have already been processed by the origin risks duplicating the effect. Example: {GET: [429, 500, 502, 503, 504], HEAD: [429, 500, 502, 503, 504]}.

retryableTransportFailureMethodsarray

SubTypestring

Default["GET","HEAD"]

HTTP methods for which any transport-level failure may be retried.

A transport-level failure is a connection or timeout error rather than an HTTP response (e.g. a read timeout or a connection reset mid-request). For a method listed here, any such failure is retried. Defaults to GET and HEAD HTTP methods.

ssl

The SSL request options

io.kestra.core.http.client.configurations.SslOptions

insecureTrustAllCertificatesbooleanstring

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.

timeout

The timeout configuration.

io.kestra.core.http.client.configurations.TimeoutConfiguration

connectTimeoutstring

The time allowed to establish a connection to the server before failing.

readIdleTimeoutstring

DefaultPT5M

The time allowed for a read connection to remain idle before closing it.

stopAfter array

SubTypestring

Possible Values

CREATEDSUBMITTEDRUNNINGPAUSEDRESTARTEDKILLINGSUCCESSWARNINGFAILEDKILLEDCANCELLEDQUEUEDRETRYINGRETRIEDSKIPPEDBREAKPOINTRESUBMITTED

List of execution states after which a trigger should be stopped (a.k.a. disabled).

wapiVersion string

Defaultv2.12

WAPI version

WAPI version used in request paths. Defaults to v2.12.

watchStatus string

DefaultUSED

Address status to watch

IP address status to monitor. USED matches allocated addresses, UNUSED matches released addresses. Defaults to USED.

when string

Defaulttrue

A condition that determines whether the trigger should run.

A Pebble expression evaluated at trigger time. The trigger fires only when the expression evaluates to a truthy value (true, a non-empty string, a non-zero number). Use this to gate trigger execution on dynamic runtime values such as execution labels, flow variables, or environment conditions.

Outputs

addedCount integer

Number of added addresses

addedEvents array

SubTypeobject

Added IP events

Addresses newly matching the filter since the previous poll. Each entry contains _ref, ip_address, network, and status.