PhpIPAM Search

PhpIPAM Search

Certified

Search phpIPAM subnets by CIDR

Searches for subnets matching a given CIDR notation (e.g. 192.168.1.0/24). Returns all subnets that match, across all sections visible to the authenticated user.

yaml
type: io.kestra.plugin.phpipam.ipam.subnet.Search

Search subnets by CIDR

yaml
id: phpipam_subnet_search
namespace: company.team
tasks:
  - id: search_subnet
    type: io.kestra.plugin.phpipam.ipam.subnet.Search
    baseUrl: "https://ipam.example.com"
    appId: myapp
    auth:
      appToken: "{{ secret('PHPIPAM_APP_TOKEN') }}"
    cidr: "192.168.1.0/24"
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.

CIDR to search

Subnet in CIDR notation, e.g. 192.168.1.0/24. The API returns subnets whose address and mask match.

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.

Matching subnets

Subnets whose address and mask match the given CIDR.

Definitions
descriptionstring
editDatestring
idstring
maskstring
masterSubnetIdstring
nameserverIdstring
permissionsstring
sectionIdstring
showNamestring
subnetstring
usage
Offline_percentstring
freehostsstring
freehosts_percentstring
maxhostsstring
usedstring
vlanIdstring
vrfIdstring