PhpIPAM Create

PhpIPAM Create

Certified

Create a phpIPAM subnet

Creates a new subnet in the specified section.

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

Create a subnet

yaml
id: phpipam_subnet_create
namespace: company.team
tasks:
  - id: create_subnet
    type: io.kestra.plugin.phpipam.ipam.subnet.Create
    baseUrl: "https://ipam.example.com"
    appId: myapp
    auth:
      appToken: "{{ secret('PHPIPAM_APP_TOKEN') }}"
    subnet: "192.168.1.0"
    mask: "24"
    sectionId: "1"
    description: "Office LAN"
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.

Mask

CIDR prefix length, e.g. 24.

Section ID

Numeric ID of the section this subnet belongs to.

Subnet address

Network address of the subnet, e.g. 192.168.1.0.

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.

Description

Optional description of the subnet.

VLAN ID

Optional numeric VLAN ID to associate.

VRF ID

Optional numeric VRF ID to associate.

Created subnet ID

Numeric ID of the newly created subnet.