PhpIPAM List

PhpIPAM List

Certified

List addresses in a phpIPAM subnet

Returns IP addresses belonging to the specified subnet.

yaml
type: io.kestra.plugin.phpipam.ipam.address.List

List addresses in a subnet

yaml
id: phpipam_address_list
namespace: company.team
tasks:
  - id: list_addresses
    type: io.kestra.plugin.phpipam.ipam.address.List
    baseUrl: "https://ipam.example.com"
    appId: myapp
    auth:
      appToken: "{{ secret('PHPIPAM_APP_TOKEN') }}"
    subnetId: "10"
Properties

Application ID

The API application identifier configured in phpIPAM under Administration → API. It appears in the path segment /api/{appId}/.

Authentication

Provide either appToken for static App-token authentication, or username + password to obtain a per-run session token. Supplying both, or neither, raises a validation error.

Definitions
appTokenstring

Static App token

A token generated in the phpIPAM administration panel under Administration → API. Sent to phpIPAM via the token request header. Mutually exclusive with username / password.

passwordstring

Password

Password for the phpIPAM user. Must be provided together with username.

usernamestring

Username

phpIPAM username used to obtain a per-session token via POST /api/{appId}/user/. Must be provided together with password. Mutually exclusive with appToken.

Base URL of the phpIPAM instance

Root URL of the phpIPAM instance, e.g. https://ipam.example.com. No trailing slash needed.

Subnet ID

Numeric ID of the subnet whose addresses to list.

DefaultFETCH
Possible Values
STOREFETCHFETCH_ONENONE

Fetch type

Controls how results are returned:

  • FETCH (default): return the full list in addresses + total count.
  • FETCH_ONE: return only the first address in address + total count.
  • STORE: write all addresses as newline-delimited JSON to Kestra internal storage, return uri + total count.
  • NONE: return only the total count, no rows.
Defaultfalse

Disable TLS certificate validation

Set to true to trust all TLS certificates, including self-signed ones. Intended for development or internal deployments only.

Reference (ref) of the pluginDefaults to apply to this task.

Address

First address in the subnet. Populated for FETCH_ONE fetch type.

Definitions
PTRstring
PTRignorestring
descriptionstring
deviceIdstring
editDatestring
excludePingstring
hostnamestring
idstring
ipstring
is_gatewaystring
lastSeenstring
macstring
notestring
ownerstring
subnetIdstring
tagstring

Addresses

IP addresses belonging to the subnet. Populated for FETCH fetch type.

Definitions
PTRstring
PTRignorestring
descriptionstring
deviceIdstring
editDatestring
excludePingstring
hostnamestring
idstring
ipstring
is_gatewaystring
lastSeenstring
macstring
notestring
ownerstring
subnetIdstring
tagstring
Default0

Total

Total number of addresses returned by the API.

Formaturi

URI

Internal storage URI of the newline-delimited JSON file. Populated for STORE fetch type.

More Plugins in this Category

VMware (EE)
VMware
Enterprise

Tasks that automate VMware vSphere operations within Kestra workflows.

Infrastructure

33 tasks

3 blueprints

Canonical (EE)
Canonical
Enterprise

Tasks to interact with Canonical services, enabling automation and infrastructure management through API-driven workflows.

CloudInfrastructure

5 tasks