add

URL

/api/v1/api.php?target=DHCPServer&action=add

Description

Adds a new DHCP Server.

Returns

Examples:

SUCCESSFUL:	{"success":1,"message":"Add Successful.","data":123}
ERROR:	{"success":0, "message":"error message"}

Data Detail:

Name	Type	Description
data	INT	The ID of the new DHCP Server.

Required Parameters

Name	Type	Example	Description
DHCPServer	STRING	IP/domain	The new server address.
DHCPPort	STRING	43	The new port.
DHCPUsername	STRING	kjennings	The new username.
DHCPPassword	STRING	********	The new password.
DHCPType	STRING	ISC	The new server type.

Optional Parameters

Name	Type	Example	Description
DHCPConfigPath	STRING	/where/is/it/	The new config path.
DHCPServerStop	STRING	/path/to/server/stop	The new server stop command.
DHCPServerStart	STRING	/path/to/server/start	The new server start command.
DHCPDefaultLease	INT	64000	The new default lease.
DHCPMaxLease	INT	128000	The new max lease.
DHCPAuthoritative	BOOL	1	The new Authoritative status.
DHCPLogFacility	STRING	local7	The new logging facility.
DHCPDomainName	STRING	domain.name.server	The new domain name servers.
DHCPNameServers	STRING	ns.domain.com	The new name servers.
DHCPUseText	BOOL	1	The new use text file setting.
DHCPConfigText	STRING	Text File	The new use text file content.

Example URL

/api/v1/api.php?target=DHCPServer&action=addDHCPServer=IP/domain&DHCPPort=43&DHCPUsername=kjennings&DHCPPassword=********&DHCPType=ISC&DHCPConfigText=configtexthere

delete

URL

/api/v1/api.php?target=DHCPServer&action=delete

Description

Performs a search over the DHCP Servers dataset and deletes all found matches.

Returns

Examples:

SUCCESSFUL:	{"success":1,"message":"DHCPServer(s) Deleted."}
ERROR:	{"success":0, "message":"error message"}

Optional Parameters

Name	Type	Example	Description
likeFlag	BOOL	1	When 1, string searches are done via LIKE with wildcards at both ends. When 0, strict comparison is used.
generalFlag	BOOL	1	When 1, searches over the provided paramenters using OR. If 0 or omitted, uses AND.

Name	Type	Example	Description
DHCPId	INT	123	The DHCP Server ID to search for.
DHCPServer	STRING	IP/domain	The Server Name to search for.
DHCPPort	STRING	43	The Port to search for.
DHCPUsername	STRING	kjennings	The Username to search for.
DHCPType	STRING	MSDHCP	The DHCP Server Type to search for.
DHCPConfigPath	STRING	/where/is/it/	The Config Path to search for.
DHCPServerStop	STRING	/path/to/server/stop	Search by server stop command.
DHCPServerStart	STRING	/path/to/server/start	Search by server start command.
DHCPDefaultLease	INT	64000	Search by default lease.
DHCPMaxLease	INT	128000	Search by max lease.
DHCPAuthoritative	BOOL	1	Search by whether the server is authoritative.
DHCPLogFacility	STRING	local7	Search by logging facility.
DHCPDomainName	STRING	domain.name.server	Search by domain name servers.
DHCPNameServers	STRING	ns.domain.com	Search by name servers.
DHCPUseText	BOOL	1	Search by using text configs or not.
DHCPConfigText	STRING	Text File	Search by text file contents.

Example URL

/api/v1/api.php?target=DHCPServer&action=delete&DHCPNameServers=ns.domain.com&DHCPType=MSDHCP

testConnection

URL

/api/v1/api.php?target=DHCPServer&action=testConnection

Description

Performs a search over the DHCP Servers dataset and tests the login/password combo for each one returned. Returns a status array with three elements: a 1 or 0 for success/failure, the server in question, and the failure/success message.

Returns

Examples:

SUCCESSFUL:	{"success":1,"message":"Pushes Attempted.","data":[[1,"foo.fun.com", "Successfully authenticated on DHCP Server 'foo.fun.com'."],[0,"foo.fun .com","Could not authenticate on server 'foo.fun.com'. Connection refused."] ,[0,"28.39.106.129","Could not connect to server '28.39.106.129'. Connection refused."]]}
ERROR:	{"success":0, "message":"error message"}

Optional Parameters

Name	Type	Example	Description
likeFlag	BOOL	1	When 1, string searches are done via LIKE with wildcards at both ends. When 0, strict comparison is used.
generalFlag	BOOL	1	When 1, searches over the provided paramenters using OR. If 0 or omitted, uses AND.

Name	Type	Example	Description
DHCPId	INT	123	The DHCP Server ID to search for.
DHCPServer	STRING	IP/domain	The Server Name to search for.
DHCPPort	STRING	43	The Port to search for.
DHCPUsername	STRING	kjennings	The Username to search for.
DHCPType	STRING	MSDHCP	The DHCP Server Type to search for.
DHCPConfigPath	STRING	/where/is/it/	The Config Path to search for.
DHCPServerStop	STRING	/path/to/server/stop	Search by server stop command.
DHCPServerStart	STRING	/path/to/server/start	Search by server start command.
DHCPDefaultLease	INT	64000	Search by default lease.
DHCPMaxLease	INT	128000	Search by max lease.
DHCPAuthoritative	BOOL	1	Search by whether the server is authoritative.
DHCPLogFacility	STRING	local7	Search by logging facility.
DHCPDomainName	STRING	domain.name.server	Search by domain name servers.
DHCPNameServers	STRING	ns.domain.com	Search by name servers.
DHCPUseText	BOOL	1	Search by using text configs or not.
DHCPConfigText	STRING	Text File	Search by text file contents.

Example URL

/api/v1/api.php?target=DHCPServer&action=testConnection&DHCPId=123

push

URL

/api/v1/api.php?target=DHCPServer&action=push

Description

Performs a search over the DHCP Servers dataset and pushes the current config file before restarting the servers. Returns a status array with three elements: a 1 or 0 for success/failure, the server in question, and the failure/success message. A response code of '2' indicates that the push went smoothly, but the configuration file itself contains errors. In this case the error return will be the actual error output from the DHCP server.

Returns

Examples:

SUCCESSFUL:	{"success":1,"message":"Pushes Attempted.","data":[[1,"trace.bind.com", "Successfully pushed DHCP Config to server 'trace.bind.com'. Server Restarted."] ,[0,"trace.bind.com","Could not authenticate on server 'trace.bind.com'. Connection refused. "],[0,"208.39.106.169","Could not connect to server '208.39.106.169'. Connection refused."]]}
ERROR:	{"success":0, "message":"error message"}

Optional Parameters

Name	Type	Example	Description
likeFlag	BOOL	1	When 1, string searches are done via LIKE with wildcards at both ends. When 0, strict comparison is used.
generalFlag	BOOL	1	When 1, searches over the provided paramenters using OR. If 0 or omitted, uses AND.

Name	Type	Example	Description
DHCPId	INT	123	The DHCP Server ID to search for.
DHCPServer	STRING	IP/domain	The Server Name to search for.
DHCPPort	STRING	43	The Port to search for.
DHCPUsername	STRING	kjennings	The Username to search for.
DHCPType	STRING	MSDHCP	The DHCP Server Type to search for.
DHCPConfigPath	STRING	/where/is/it/	The Config Path to search for.
DHCPServerStop	STRING	/path/to/server/stop	Search by server stop command.
DHCPServerStart	STRING	/path/to/server/start	Search by server start command.
DHCPDefaultLease	INT	64000	Search by default lease.
DHCPMaxLease	INT	128000	Search by max lease.
DHCPAuthoritative	BOOL	1	Search by whether the server is authoritative.
DHCPLogFacility	STRING	local7	Search by logging facility.
DHCPDomainName	STRING	domain.name.server	Search by domain name servers.
DHCPNameServers	STRING	ns.domain.com	Search by name servers.
DHCPUseText	BOOL	1	Search by using text configs or not.
DHCPConfigText	STRING	Text File	Search by text file contents.

Example URL

/api/v1/api.php?target=DHCPServer&action=push&DHCPServer=IP/domain

DHCP Entry Control

get

URL

/api/v1/api.php?target=DHCPEntry&action=get

Description

Accepts search criteria to retrieve a list of all matching DHCP Entries along with their associated Options.

Returns

Examples:

SUCCESSFUL:	{"EntryId":"27","EntryParent":null,"EntryServerId":"1","EntryName":"mike","EntryType": "host","EntryNetmask":"255.255.255.0","EntryIPCount":"1","EntryPercent":"1","Options": [{"OptionId":"46","OptionSubnetId":"27","OptionKey":"hardware ethernet","OptionValue": "11:23:45:67:89:ab"},{"OptionId":"47","OptionSubnetId":"27","OptionKey":"fixed-address", "OptionValue":"10.20.30.158"}]}]}
ERROR:	{"success":0, "message":"error message"}

Data Detail:

Name	Type	Description
EntryId	INT	The ID of the DHCP Entry.
EntryParent	INT	The parent Entry of this one
EntryServerId	INT	The DHCP Server to which this entry belongs.
EntryType	STRING	The Entry type. Either 'host' or 'subnet'.
EntryName	STRING	The name of this entry. In the case of a Host, it is the hostname. In the case of a subnet, it is the subnet address.
EntryNetmask	STRING	The subnet mask. Empty on type 'host'
EntryIPCount	INT	The number of IPs in this Entry.
EntryPercent	INT	Percentage of this Entry currently assigned.
Options	STRING	If present, this array contains objects enumerating each option and its type.
OptionId	STRING	The ID of this Option
OptionSubnetId	INT	The ID of the parent. Identical to EntryId.
OptionKey	STRING	The key portion of the option key-value pairing.
OptionValue	STRING	The value portion of the option key-value pairing.

Optional Parameters

Name	Type	Example	Description
likeFlag	BOOL	1	When 1, string searches are done via LIKE with wildcards at both ends. When 0, strict comparison is used.
generalFlag	BOOL	1	When 1, searches over the provided parameters using OR. If 0 or omitted, uses AND.

Name	Type	Example	Description
EntryId	INT	123	The ID of the DHCP Entry to search for.
EntryParent	INT	123	The parent Entry to search for.
EntryServerId	INT	123	The DHCP Server to search for.
EntryType	STRING	subnet	The Entry type to search for.
EntryName	STRING	30.20.10.1	The name to search for.
EntryNetmask	STRING	255.255.255.0	The subnet mask to search for.
OptionId	STRING	123	The Option ID to search for.
OptionKey	STRING	range	The key portion of the option key-value pairing to search for.
OptionValue	STRING	30.20.10.10 30.20.10.40	The value portion of the option key-value pairing to search for.

...

Page tree

Versions Compared

Old Version 4

New Version 5

Key

add

delete

testConnection

push

DHCP Entry Control

get

Page tree

Page History

Versions Compared

Old Version 4

New Version 5

Key

add

delete

testConnection

push

DHCP Entry Control

get