ServicesDHCP ServiceDHCP API

Get Reservation

View as Markdown
Return one normalized reservation from the selected DHCP configuration.

Authentication

AuthorizationBearer

Bearer JWT used by CLI and machine clients on svc-* endpoints. Authentication is required by default, but deployments may disable it with [auth] required = false. Browser OIDC sessions, mTLS, SPIFFE identities, and trusted gateway identity headers may also satisfy authentication outside this generated client flow.

Path parameters

ip_addressstringRequiredformat: "ipvanyaddress"

Query parameters

ip_versionenum or nullOptional
Supported DHCP address families.
Allowed values:

Response

Successful Response
hostnamestringDefaults to
identifierstring or null
identifier_typestring or null
ip_addressstring or nullformat: "ipvanyaddress"
subnetstring or null

Errors

404
Not Found Error
422
Unprocessable Entity Error