PlanetLab Central API Documentation
PlanetLab Central API DocumentationPlanetLab Central API Documentation
The PlanetLab Central API (PLCAPI) is the interface through
which the PlanetLab Central database should be accessed and
maintained. The API is used by the website, by nodes, by automated
scripts, and by users to access and update information about
users, nodes, sites, slices, and other entities maintained by the
database. The API should be accessed via XML-RPC over HTTPS. The API
supports the standard introspection calls system.listMethods, system.methodSignature,
and system.methodHelp,
and the standard batching call system.multicall. With the
exception of these calls, all PLCAPI calls take an
authentication structure as their first argument. All
authentication structures require the specification of
AuthMethod. If the documentation for a
call does not further specify the authentication structure, then
any of (but only) the following authentication structures may be
used: Session authentication. User sessions are typically
valid for 24 hours. Node sessions are valid until the next
reboot. Obtain a session key with GetSession using another form of
authentication, such as password or GnuPG
authentication. Password authentication. GnuPG authentication. Users may upload a GPG public key
using AddPersonKey. Peer
GPG keys should be added with AddPeer or UpdatePeer.
Anonymous authentication.
Some functions may only be called by users with certain
roles (see GetRoles), and others
may return different information to different callers depending
on the role(s) of the caller. The node and
anonymous roles are pseudo-roles. A function
that allows the node role may be called by
automated scripts running on a node, such as the Boot and Node
Managers. A function that allows the
anonymous role may be called by anyone; an
API authentication structure must still be specified (see Section 1.1, “Authentication”). Most of the Get functions take a
filter argument. Filters may be arrays of integer (and sometimes
string) identifiers, or a struct representing a filter on the
attributes of the entities being queried. For example,
# plcsh code fragment (see below)
GetNodes([1,2,3])
GetNodes({'node_id': [1,2,3]})
GetNodes({'node_id': 1}) + GetNodes({'node_id': 2}) + GetNodes({'node_id': 3})
Would all be equivalent queries. Attributes that are
themselves arrays (such as nodenetwork_ids
and slice_ids for nodes) cannot be used in
filters. Filters support a number of special features: Filters support negation. A field starting with the ~
character means negation. Example
filter = { '~peer_id' : None }
Filters support greater than or less than operators. A field
starting with < [ ] or > means lower than or greater than.
< > uses strict comparison while [ ] is for using <= or >=
instead. Example
filter = { ']node_id' : 2305 } # node_id >= 2305
filter = { '>node_id' : 2305 } # node_id > 2305
Filters support wildcard searches. A (string) value
containing either a * or a % character is treated as a (sql)
pattern; * are replaced with % that is the SQL wildcard
character. Example:
filter = { 'hostname' : '*.jp' }
A command-line program called plcsh
simplifies authentication structure handling, and is useful for
scripting. This program is distributed as a Linux RPM called
PLCAPI and requires Python >=2.4.
usage: plcsh [options]
options:
-f CONFIG, --config=CONFIG
PLC configuration file
-h URL, --url=URL API URL
-c CACERT, --cacert=CACERT
API SSL certificate
-k INSECURE, --insecure=INSECURE
Do not check SSL certificate
-m METHOD, --method=METHOD
API authentication method
-s SESSION, --session=SESSION
API session key
-u USER, --user=USER API user name
-p PASSWORD, --password=PASSWORD
API password
-r ROLE, --role=ROLE API role
-x, --xmlrpc Use XML-RPC interface
--help show this help message and exit
Specify at least the API URL and your user name:
plcsh --url https://www.planet-lab.org/PLCAPI/ -u user@site.edu
You will be presented with a prompt. From here, you can
invoke API calls and omit the authentication structure, as it will
be filled in automatically.
user@site.edu connected using password authentication
Type "system.listMethods()" or "help(method)" for more information.
[user@site.edu]>>> AuthCheck()
1
[user@site.edu]>>> GetNodes([121], ['node_id', 'hostname'])
[{'node_id': 121, 'hostname': 'planetlab-1.cs.princeton.edu'}]
As this program is actually a Python interpreter, you may
create variables, execute for loops, import other packages, etc.,
directly on the command line as you would using the regular Python
shell. To use plcsh programmatically, import
the PLC.Shell module:
#!/usr/bin/python
import sys
# Default location that the PLCAPI RPM installs the PLC class
sys.path.append('/usr/share/plc_api')
# Initialize shell environment. Shell() will define all PLCAPI methods
# in the specified namespace (specifying globals() will define them
# globally).
from PLC.Shell import Shell
plc = Shell(globals(),
url = "https://www.planet-lab.org/PLCAPI/",
user = "user@site.edu",
password = "password")
# Both are equivalent
nodes = GetNodes([121], ['node_id', 'hostname'])
nodes = plc.GetNodes([121], ['node_id', 'hostname'])
PlanetLab's PLC API is actually the composition of three distinct interfaces: Registry Interface: Record and retrive info about objects. Management Interface: Configure/reboot components and learn
their status. Slice Interface: Provision and control slices/slivers.
This document is organized around these three interfaces. In principle, each individual PlanetLab node, through its Node
Manager (NM), exports the slice and management interfaces. Currently,
the NM exports only the sliver-related calls defined by the slice
interface. Eventually, the sliver-related calls and the slice-wide
calls exported by the slice interface will be unified, such that PLC
and each NM will support the same set of slice-related calls. Each of these three interfaces is divided into a Public subset
(calls exported to a wide-range of principals) and an Admin subset
(calls available only to the PlanetLab support team). In principle,
alternative implementations of PLC would need only support the Public
calls to be to interoperate (federate) with PlanetLab; the Admin
calls could change to meet the operational needs of any given
PlanetLab deployment. Chapter 2. Registry InterfacePrototype: AddSiteAddress (auth, site_id_or_login_base, address_fields)
Description: Adds a new address to a site. Fields specified in
address_fields are used; some are not optional. PIs may only add addresses to their own sites. Returns the new address_id (> 0) if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: DeleteAddress (auth, address_id)
Description: Deletes an address. PIs may only delete addresses from their own sites. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
address_id
: int, Address identifier
Returns: Prototype: GetAddresses (auth, address_filter, return_fields)
Description: Returns an array of structs containing details about addresses. If
address_filter is specified and is an array of address
identifiers, or a struct of address attributes, only addresses
matching the filter will be returned. If return_fields is
specified, only the specified details will be returned.
Allowed Roles: admin, pi, user, tech, node
Parameters:
auth
: struct, API authentication structure
address_filter
: array of int or struct
return_fields
: array, List of fields to return
Returns:
array of struct
city
: string, City
address_id
: int, Address identifier
country
: string, Country
line3
: string, Address line 3
line2
: string, Address line 2
line1
: string, Address line 1
address_type_ids
: array, Address type identifiers
state
: string, State or province
postalcode
: string, Postal code
address_types
: array, Address types
Prototype: UpdateAddress (auth, address_id, address_fields)
Description: Updates the parameters of an existing address with the values in
address_fields. PIs may only update addresses of their own sites. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
address_id
: int, Address identifier
address_fields
: struct
city
: string, City
country
: string, Country
line3
: string, Address line 3
line2
: string, Address line 2
line1
: string, Address line 1
state
: string, State or province
postalcode
: string, Postal code
Returns: Prototype: AddSlice (auth, slice_fields)
Description: Adds a new slice. Any fields specified in slice_fields are used,
otherwise defaults are used. Valid slice names are lowercase and begin with the login_base
(slice prefix) of a valid site, followed by a single
underscore. Thereafter, only letters, numbers, or additional
underscores may be used. PIs may only add slices associated with their own sites (i.e.,
slice prefixes must always be the login_base of one of their
sites). Returns the new slice_id (> 0) if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: DeleteSlice (auth, slice_id_or_name)
Description: Deletes the specified slice. Users may only delete slices of which they are members. PIs may
delete any of the slices at their sites, or any slices of which
they are members. Admins may delete any slice. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: GetSlices (auth, slice_filter, return_fields)
Description: Returns an array of structs containing details about slices. If
slice_filter is specified and is an array of slice identifiers or
slice names, or a struct of slice attributes, only slices matching
the filter will be returned. If return_fields is specified, only the
specified details will be returned. Users may only query slices of which they are members. PIs may
query any of the slices at their sites. Admins and nodes may query
any slice. If a slice that cannot be queried is specified in
slice_filter, details about that slice will not be returned.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
slice_filter
: array of int or string or string or int or struct
array of int or string
int, Slice identifier
string, Slice name
string, name
int, slice_id
struct, Attribute filter
creator_person_id
: int or array of int
int, Identifier of the account that created this slice
array of int, Identifier of the account that created this slice
instantiation
: string or array of string
string, Slice instantiation state
array of string, Slice instantiation state
name
: string or array of string
slice_id
: int or array of int
created
: int or array of int
int, Date and time when slice was created, in seconds since UNIX epoch
array of int, Date and time when slice was created, in seconds since UNIX epoch
url
: string or array of string
string, URL further describing this slice
array of string, URL further describing this slice
max_nodes
: int or array of int
int, Maximum number of nodes that can be assigned to this slice
array of int, Maximum number of nodes that can be assigned to this slice
expires
: int or array of int
int, Date and time when slice expires, in seconds since UNIX epoch
array of int, Date and time when slice expires, in seconds since UNIX epoch
site_id
: int or array of int
int, Identifier of the site to which this slice belongs
array of int, Identifier of the site to which this slice belongs
peer_slice_id
: int or array of int
int, Foreign slice identifier at peer
array of int, Foreign slice identifier at peer
peer_id
: int or array of int
int, Peer to which this slice belongs
array of int, Peer to which this slice belongs
description
: string or array of string
string, Slice description
array of string, Slice description
return_fields
: array, List of fields to return
Returns:
array of struct
creator_person_id
: int, Identifier of the account that created this slice
instantiation
: string, Slice instantiation state
slice_attribute_ids
: array, List of slice attributes
name
: string, Slice name
slice_id
: int, Slice identifier
created
: int, Date and time when slice was created, in seconds since UNIX epoch
url
: string, URL further describing this slice
max_nodes
: int, Maximum number of nodes that can be assigned to this slice
person_ids
: array, List of accounts that can use this slice
expires
: int, Date and time when slice expires, in seconds since UNIX epoch
site_id
: int, Identifier of the site to which this slice belongs
peer_slice_id
: int, Foreign slice identifier at peer
node_ids
: array, List of nodes in this slice
peer_id
: int, Peer to which this slice belongs
description
: string, Slice description
Prototype: UpdateSlice (auth, slice_id_or_name, slice_fields)
Description: Updates the parameters of an existing slice with the values in
slice_fields. Users may only update slices of which they are members. PIs may
update any of the slices at their sites, or any slices of which
they are members. Admins may update any slice. Only PIs and admins may update max_nodes. Slices cannot be renewed
(by updating the expires parameter) more than 8 weeks into the
future. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: AddPersonKey (auth, person_id_or_email, key_fields)
Description: Adds a new key to the specified account. Non-admins can only modify their own keys. Returns the new key_id (> 0) if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: Description: Deletes a key. Non-admins may only delete their own keys. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
key_id
: int, Key identifier
Returns: Prototype: GetKeys (auth, key_filter, return_fields)
Description: Returns an array of structs containing details about keys. If
key_filter is specified and is an array of key identifiers, or a
struct of key attributes, only keys matching the filter will be
returned. If return_fields is specified, only the specified
details will be returned. Admin may query all keys. Non-admins may only query their own
keys.
Allowed Roles: admin, pi, user, tech, node
Parameters:
auth
: struct, API authentication structure
key_filter
: array of int or struct
array of int
struct, Attribute filter
peer_key_id
: int or array of int
int, Foreign key identifier at peer
array of int, Foreign key identifier at peer
key_type
: string or array of string
key
: string or array of string
person_id
: int or array of int
int, User to which this key belongs
array of int, User to which this key belongs
key_id
: int or array of int
peer_id
: int or array of int
int, Peer to which this key belongs
array of int, Peer to which this key belongs
return_fields
: array, List of fields to return
Returns:
array of struct
peer_id
: int, Peer to which this key belongs
key_type
: string, Key type
key
: string, Key value
person_id
: int, User to which this key belongs
key_id
: int, Key identifier
peer_key_id
: int, Foreign key identifier at peer
Prototype: UpdateKey (auth, key_id, key_fields)
Description: Updates the parameters of an existing key with the values in
key_fields. Non-admins may only update their own keys. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
key_id
: int, Key identifier
key_fields
: struct
Returns: Prototype: AddPerson (auth, person_fields)
Description: Adds a new account. Any fields specified in person_fields are
used, otherwise defaults are used. Accounts are disabled by default. To enable an account, use
UpdatePerson(). Returns the new person_id (> 0) if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: DeletePerson (auth, person_id_or_email)
Description: Mark an existing account as deleted. Users and techs can only delete themselves. PIs can only delete
themselves and other non-PIs at their sites. ins can delete
anyone. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: GetPersons (auth, person_filter, return_fields)
Description: Returns an array of structs containing details about users. If
person_filter is specified and is an array of user identifiers or
usernames, or a struct of user attributes, only users matching the
filter will be returned. If return_fields is specified, only the
specified details will be returned. Users and techs may only retrieve details about themselves. PIs
may retrieve details about themselves and others at their
sites. Admins and nodes may retrieve details about all accounts.
Allowed Roles: admin, pi, user, tech, node
Parameters:
auth
: struct, API authentication structure
person_filter
: array of int or string or string or int or struct
array of int or string
string, email
int, person_id
struct, Attribute filter
bio
: string or array of string
first_name
: string or array of string
last_name
: string or array of string
string, Surname
array of string, Surname
last_updated
: int or array of int
int, Date and time of last update
array of int, Date and time of last update
title
: string or array of string
string, Title
array of string, Title
url
: string or array of string
verification_key
: string or array of string
string, Reset password key
array of string, Reset password key
enabled
: boolean or array of boolean
boolean, Has been enabled
array of boolean, Has been enabled
phone
: string or array of string
peer_person_id
: int or array of int
int, Foreign user identifier at peer
array of int, Foreign user identifier at peer
password
: string or array of string
string, Account password in crypt() form
array of string, Account password in crypt() form
person_id
: int or array of int
date_created
: int or array of int
int, Date and time when account was created
array of int, Date and time when account was created
peer_id
: int or array of int
int, Peer to which this user belongs
array of int, Peer to which this user belongs
verification_expires
: int or array of int
int, Date and time when verification_key expires
array of int, Date and time when verification_key expires
email
: string or array of string
string, Primary e-mail address
array of string, Primary e-mail address
return_fields
: array, List of fields to return
Returns:
array of struct
bio
: string, Biography
first_name
: string, Given name
last_name
: string, Surname
last_updated
: int, Date and time of last update
roles
: array, List of roles
title
: string, Title
url
: string, Home page
key_ids
: array, List of key identifiers
enabled
: boolean, Has been enabled
slice_ids
: array, List of slice identifiers
phone
: string, Telephone number
peer_person_id
: int, Foreign user identifier at peer
role_ids
: array, List of role identifiers
person_id
: int, User identifier
date_created
: int, Date and time when account was created
site_ids
: array, List of site identifiers
peer_id
: int, Peer to which this user belongs
email
: string, Primary e-mail address
Prototype: UpdatePerson (auth, person_id_or_email, person_fields)
Description: Updates a person. Only the fields specified in person_fields are
updated, all other fields are left untouched. Users and techs can only update themselves. PIs can only update
themselves and other non-PIs at their sites. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: AddSite (auth, site_fields)
Description: Adds a new site, and creates a node group for that site. Any
fields specified in site_fields are used, otherwise defaults are
used. Returns the new site_id (> 0) if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: DeleteSite (auth, site_id_or_login_base)
Description: Mark an existing site as deleted. The accounts of people who are
not members of at least one other non-deleted site will also be
marked as deleted. Nodes, PCUs, and slices associated with the
site will be deleted. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: GetSites (auth, site_filter, return_fields)
Description: Returns an array of structs containing details about sites. If
site_filter is specified and is an array of site identifiers or
hostnames, or a struct of site attributes, only sites matching the
filter will be returned. If return_fields is specified, only the
specified details will be returned.
Allowed Roles: admin, pi, user, tech, node, anonymous
Parameters:
auth
: struct, API authentication structure
site_filter
: array of int or string or string or int or struct
array of int or string
string, login_base
int, site_id
struct, Attribute filter
last_updated
: int or array of int
int, Date and time when site entry was last updated, in seconds since UNIX epoch
array of int, Date and time when site entry was last updated, in seconds since UNIX epoch
name
: string or array of string
url
: string or array of string
string, URL of a page that describes the site
array of string, URL of a page that describes the site
site_id
: int or array of int
enabled
: boolean or array of boolean
boolean, Has been enabled
array of boolean, Has been enabled
longitude
: double or array of double
double, Decimal longitude of the site
array of double, Decimal longitude of the site
latitude
: double or array of double
double, Decimal latitude of the site
array of double, Decimal latitude of the site
max_slices
: int or array of int
int, Maximum number of slices that the site is able to create
array of int, Maximum number of slices that the site is able to create
login_base
: string or array of string
string, Site slice prefix
array of string, Site slice prefix
ext_consortium_id
: int or array of int
int, external consortium id
array of int, external consortium id
is_public
: boolean or array of boolean
boolean, Publicly viewable site
array of boolean, Publicly viewable site
max_slivers
: int or array of int
int, Maximum number of slivers that the site is able to create
array of int, Maximum number of slivers that the site is able to create
date_created
: int or array of int
int, Date and time when site entry was created, in seconds since UNIX epoch
array of int, Date and time when site entry was created, in seconds since UNIX epoch
peer_site_id
: int or array of int
int, Foreign site identifier at peer
array of int, Foreign site identifier at peer
peer_id
: int or array of int
int, Peer to which this site belongs
array of int, Peer to which this site belongs
abbreviated_name
: string or array of string
string, Abbreviated site name
array of string, Abbreviated site name
return_fields
: array, List of fields to return
Returns:
array of struct
address_ids
: array, List of address identifiers
pcu_ids
: array, List of PCU identifiers
last_updated
: int, Date and time when site entry was last updated, in seconds since UNIX epoch
name
: string, Full site name
node_ids
: array, List of site node identifiers
url
: string, URL of a page that describes the site
enabled
: boolean, Has been enabled
person_ids
: array, List of account identifiers
site_id
: int, Site identifier
longitude
: double, Decimal longitude of the site
slice_ids
: array, List of slice identifiers
max_slivers
: int, Maximum number of slivers that the site is able to create
max_slices
: int, Maximum number of slices that the site is able to create
login_base
: string, Site slice prefix
ext_consortium_id
: int, external consortium id
date_created
: int, Date and time when site entry was created, in seconds since UNIX epoch
latitude
: double, Decimal latitude of the site
is_public
: boolean, Publicly viewable site
peer_site_id
: int, Foreign site identifier at peer
peer_id
: int, Peer to which this site belongs
abbreviated_name
: string, Abbreviated site name
Prototype: UpdateSite (auth, site_id_or_login_base, site_fields)
Description: Updates a site. Only the fields specified in update_fields are
updated, all other fields are left untouched. PIs can only update sites they are a member of. Only admins can
update max_slices, max_slivers, and login_base. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: AddNode (auth, site_id_or_login_base, node_fields)
Description: Adds a new node. Any values specified in node_fields are used,
otherwise defaults are used. PIs and techs may only add nodes to their own sites. Admins may
add nodes to any site. Returns the new node_id (> 0) if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: DeleteNode (auth, node_id_or_hostname)
Description: Mark an existing node as deleted. PIs and techs may only delete nodes at their own sites. ins may
delete nodes at any site. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: GetNodes (auth, node_filter, return_fields)
Description: Returns an array of structs containing details about nodes. If
node_filter is specified and is an array of node identifiers or
hostnames, or a struct of node attributes, only nodes matching the
filter will be returned. If return_fields is specified, only the
specified details will be returned. Some fields may only be viewed by admins.
Allowed Roles: admin, pi, user, tech, node, anonymous
Parameters:
auth
: struct, API authentication structure
node_filter
: array of int or string or string or int or struct
array of int or string
string, hostname
int, node_id
struct, Attribute filter
key
: string or array of string
string, (Admin only) Node key
array of string, (Admin only) Node key
node_id
: int or array of int
last_updated
: int or array of int
int, Date and time when node entry was created
array of int, Date and time when node entry was created
last_contact
: int or array of int
int, Date and time when node last contacted plc
array of int, Date and time when node last contacted plc
boot_state
: string or array of string
peer_node_id
: int or array of int
int, Foreign node identifier at peer
array of int, Foreign node identifier at peer
hostname
: string or array of string
string, Fully qualified hostname
array of string, Fully qualified hostname
site_id
: int or array of int
int, Site at which this node is located
array of int, Site at which this node is located
boot_nonce
: string or array of string
string, (Admin only) Random value generated by the node at last boot
array of string, (Admin only) Random value generated by the node at last boot
session
: string or array of string
string, (Admin only) Node session value
array of string, (Admin only) Node session value
version
: string or array of string
string, Apparent Boot CD version
array of string, Apparent Boot CD version
date_created
: int or array of int
int, Date and time when node entry was created
array of int, Date and time when node entry was created
model
: string or array of string
string, Make and model of the actual machine
array of string, Make and model of the actual machine
peer_id
: int or array of int
int, Peer to which this node belongs
array of int, Peer to which this node belongs
ssh_rsa_key
: string or array of string
string, Last known SSH host key
array of string, Last known SSH host key
return_fields
: array, List of fields to return
Returns:
array of struct
last_updated
: int, Date and time when node entry was created
boot_state
: string, Boot state
site_id
: int, Site at which this node is located
pcu_ids
: array, List of PCUs that control this node
session
: string, (Admin only) Node session value
ssh_rsa_key
: string, Last known SSH host key
last_contact
: int, Date and time when node last contacted plc
peer_node_id
: int, Foreign node identifier at peer
hostname
: string, Fully qualified hostname
slice_ids
: array, List of slices on this node
version
: string, Apparent Boot CD version
peer_id
: int, Peer to which this node belongs
node_id
: int, Node identifier
key
: string, (Admin only) Node key
conf_file_ids
: array, List of configuration files specific to this node
nodegroup_ids
: array, List of node groups that this node is in
slice_ids_whitelist
: array, List of slices allowed on this node
nodenetwork_ids
: array, List of network interfaces that this node has
boot_nonce
: string, (Admin only) Random value generated by the node at last boot
date_created
: int, Date and time when node entry was created
model
: string, Make and model of the actual machine
ports
: array, List of PCU ports that this node is connected to
Prototype: UpdateNode (auth, node_id_or_hostname, node_fields)
Description: Updates a node. Only the fields specified in node_fields are
updated, all other fields are left untouched. PIs and techs can update only the nodes at their sites. Only
admins can update the key, session, and boot_nonce fields. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: Description: Adds a new key type. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: DeleteKeyType (auth, name)
Description: Deletes a key type. WARNING: This will cause the deletion of all keys of this type. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: Description: Returns an array of all valid key types.
Allowed Roles: admin, pi, user, tech, node
Parameters: Returns: Prototype: BlacklistKey (auth, key_id)
Description: Blacklists a key, disassociating it and all others identical to it
from all accounts and preventing it from ever being added again. WARNING: Identical keys associated with other accounts with also
be blacklisted. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
key_id
: int, Key identifier
Returns: Prototype: AddAddressType (auth, address_type_fields)
Description: Adds a new address type. Fields specified in address_type_fields
are used. Returns the new address_type_id (> 0) if successful, faults otherwise.
Allowed Roles: Parameters: Returns: 2.2.2.2. DeleteAddressTypePrototype: DeleteAddressType (auth, address_type_id_or_name)
Description: Deletes an address type. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: GetAddressTypes (auth, address_type_filter, return_fields)
Description: Returns an array of structs containing details about address
types. If address_type_filter is specified and is an array of
address type identifiers, or a struct of address type attributes,
only address types matching the filter will be returned. If
return_fields is specified, only the specified details will be
returned.
Allowed Roles: admin, pi, user, tech, node
Parameters:
auth
: struct, API authentication structure
address_type_filter
: array of int or string or struct
array of int or string
struct, Attribute filter
name
: string or array of string
address_type_id
: int or array of int
int, Address type identifier
array of int, Address type identifier
description
: string or array of string
string, Address type description
array of string, Address type description
return_fields
: array, List of fields to return
Returns:
array of struct
name
: string, Address type
address_type_id
: int, Address type identifier
description
: string, Address type description
2.2.2.4. UpdateAddressTypePrototype: UpdateAddressType (auth, address_type_id_or_name, address_type_fields)
Description: Updates the parameters of an existing address type with the values
in address_type_fields. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
address_type_id_or_name
: int or string
address_type_fields
: struct
name
: string, Address type
description
: string, Address type description
Returns: 2.2.2.5. AddAddressTypeToAddressPrototype: AddAddressTypeToAddress (auth, address_type_id_or_name, address_id)
Description: Adds an address type to the specified address. PIs may only update addresses of their own sites. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
address_type_id_or_name
: int or string
address_id
: int, Address identifier
Returns: 2.2.2.6. DeleteAddressTypeFromAddressPrototype: DeleteAddressTypeFromAddress (auth, address_type_id_or_name, address_id)
Description: Deletes an address type from the specified address. PIs may only update addresses of their own sites. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
address_type_id_or_name
: int or string
address_id
: int, Address identifier
Returns: Prototype: AddRole (auth, role_id, name)
Description: Adds a new role. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
role_id
: int, Role identifier
name
: string, Role
Returns: Prototype: DeleteRole (auth, role_id_or_name)
Description: Deletes a role. WARNING: This will remove the specified role from all accounts
that possess it, and from all node and slice attributes that refer
to it. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: Description: Get an array of structs containing details about all roles.
Allowed Roles: admin, pi, user, tech, node
Parameters: Returns: Prototype: VerifyPerson (auth, person_id_or_email, verification_key, verification_expires)
Description: Verify a new (must be disabled) user's e-mail address and registration. If verification_key is not specified, then a new verification_key
will be generated and stored with the user's account. The key will
be e-mailed to the user in the form of a link to a web page. The web page should verify the key by calling this function again
and specifying verification_key. If the key matches what has been
stored in the user's account, then an e-mail will be sent to the
user's PI (and support if the user is requesting a PI role),
asking the PI (or support) to enable the account. Returns 1 if the verification key if valid.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
person_id_or_email
: int or string
verification_key
: string, Reset password key
verification_expires
: int, Date and time when verification_key expires
Returns: Prototype: NotifyPersons (auth, person_filter, subject, body)
Description: Sends an e-mail message to the specified users. If person_filter
is specified and is an array of user identifiers or usernames, or
a struct of user attributes, only users matching the filter will
receive the message. Returns 1 if successful.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
person_filter
: array of int or string or struct
array of int or string
struct, Attribute filter
bio
: string or array of string
first_name
: string or array of string
last_name
: string or array of string
string, Surname
array of string, Surname
last_updated
: int or array of int
int, Date and time of last update
array of int, Date and time of last update
title
: string or array of string
string, Title
array of string, Title
url
: string or array of string
verification_key
: string or array of string
string, Reset password key
array of string, Reset password key
enabled
: boolean or array of boolean
boolean, Has been enabled
array of boolean, Has been enabled
phone
: string or array of string
peer_person_id
: int or array of int
int, Foreign user identifier at peer
array of int, Foreign user identifier at peer
password
: string or array of string
string, Account password in crypt() form
array of string, Account password in crypt() form
person_id
: int or array of int
date_created
: int or array of int
int, Date and time when account was created
array of int, Date and time when account was created
peer_id
: int or array of int
int, Peer to which this user belongs
array of int, Peer to which this user belongs
verification_expires
: int or array of int
int, Date and time when verification_key expires
array of int, Date and time when verification_key expires
email
: string or array of string
string, Primary e-mail address
array of string, Primary e-mail address
subject
: string, E-mail subject
body
: string, E-mail body
Returns: Prototype: ResetPassword (auth, person_id_or_email, verification_key, verification_expires)
Description: If verification_key is not specified, then a new verification_key
will be generated and stored with the user's account. The key will
be e-mailed to the user in the form of a link to a web page. The web page should verify the key by calling this function again
and specifying verification_key. If the key matches what has been
stored in the user's account, a new random password will be
e-mailed to the user. Returns 1 if verification_key was not specified, or was specified
and is valid, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
person_id_or_email
: int or string
verification_key
: string, Reset password key
verification_expires
: int, Date and time when verification_key expires
Returns: Chapter 3. Management Interface3.1.1.1. BootGetNodeDetailsPrototype: BootGetNodeDetails (auth)
Description: Returns a set of details about the calling node, including a new
node session value.
Allowed Roles: Parameters: Returns:
struct
boot_state
: string, Boot state
model
: string, Make and model of the actual machine
hostname
: string, Fully qualified hostname
networks
: array of struct
broadcast
: string, Network broadcast address
is_primary
: boolean, Is the primary interface for this node
network
: string, Subnet address
ip
: string, IP address
dns1
: string, IP address of primary DNS server
hostname
: string, (Optional) Hostname
netmask
: string, Subnet mask
gateway
: string, IP address of primary gateway
nodenetwork_id
: int, Node interface identifier
mac
: string, MAC address
node_id
: int, Node associated with this interface
dns2
: string, IP address of secondary DNS server
bwlimit
: int, Bandwidth limit
type
: string, Address type (e.g., 'ipv4')
method
: string, Addressing method (e.g., 'static' or 'dhcp')
nodenetwork_setting_ids
: array, List of nodenetwork settings
session
: string, Session key
Prototype: BootUpdateNode (auth, node_fields)
Description: Allows the calling node to update its own record. Only the primary
network can be updated, and the node IP cannot be changed. Returns 1 if updated successfully.
Allowed Roles: Parameters:
auth
: struct or struct
struct, API authentication structure
AuthMethod
: string, Authentication method to use, always 'hmac'
value
: string, HMAC of node key and method call
node_id
: int, Node identifier
struct, API authentication structure
session
: string, Session key
AuthMethod
: string, Authentication method to use, always 'session'
node_fields
: struct
boot_state
: string, Boot state
primary_network
: struct
network
: string, Subnet address
dns2
: string, IP address of secondary DNS server
dns1
: string, IP address of primary DNS server
netmask
: string, Subnet mask
method
: string, Addressing method (e.g., 'static' or 'dhcp')
broadcast
: string, Network broadcast address
mac
: string, MAC address
gateway
: string, IP address of primary gateway
ssh_host_key
: string, Last known SSH host key
Returns: Prototype: RebootNode (auth, node_id_or_hostname)
Description: Sends the specified node a specially formatted UDP packet which
should cause it to reboot immediately. Admins can reboot any node. Techs and PIs can only reboot nodes at
their site. Returns 1 if the packet was successfully sent (which only whether
the packet was sent, not whether the reboot was successful).
Allowed Roles: Parameters: Returns: 3.2.1.1. AddNodeNetworkSettingPrototype: AddNodeNetworkSetting (auth, nodenetwork_id, nodenetwork_setting_type_id_or_name, value)
Description: Sets the specified setting for the specified nodenetwork
to the specified value. In general only tech(s), PI(s) and of course admin(s) are allowed to
do the change, but this is defined in the nodenetwork setting type object. Returns the new nodenetwork_setting_id (> 0) if successful, faults
otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
nodenetwork_id
: int, NodeNetwork identifier
nodenetwork_setting_type_id_or_name
: int or string
int, Nodenetwork setting type identifier
string, Nodenetwork setting type name
value
: string, Nodenetwork setting value
Returns: 3.2.1.2. AddNodeNetworkSettingTypePrototype: AddNodeNetworkSettingType (auth, nodenetwork_setting_type_fields)
Description: Adds a new type of nodenetwork setting.
Any fields specified are used, otherwise defaults are used. Returns the new nodenetwork_setting_id (> 0) if successful,
faults otherwise.
Allowed Roles: Parameters: Returns: 3.2.1.3. DeleteNodeNetworkSettingPrototype: DeleteNodeNetworkSetting (auth, nodenetwork_setting_id)
Description: Deletes the specified nodenetwork setting Attributes may require the caller to have a particular role in order
to be deleted, depending on the related nodenetwork setting type.
Admins may delete attributes of any slice or sliver. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
nodenetwork_setting_id
: int, Nodenetwork setting identifier
Returns: 3.2.1.4. DeleteNodeNetworkSettingTypePrototype: DeleteNodeNetworkSettingType (auth, nodenetwork_setting_type_id_or_name)
Description: Deletes the specified nodenetwork setting type. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters: Returns: 3.2.1.5. GetNodeNetworkSettingsPrototype: GetNodeNetworkSettings (auth, nodenetwork_setting_filter, return_fields)
Description: Returns an array of structs containing details about
nodenetworks and related settings. If nodenetwork_setting_filter is specified and is an array of
nodenetwork setting identifiers, only nodenetwork settings matching
the filter will be returned. If return_fields is specified, only
the specified details will be returned.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
nodenetwork_setting_filter
: array of int or int or struct
array of int, Nodenetwork setting identifier
int, Nodenetwork setting id
struct, Attribute filter
category
: string or array of string
string, Nodenetwork setting category
array of string, Nodenetwork setting category
description
: string or array of string
string, Nodenetwork setting type description
array of string, Nodenetwork setting type description
nodenetwork_setting_type_id
: int or array of int
int, Nodenetwork setting type identifier
array of int, Nodenetwork setting type identifier
value
: string or array of string
string, Nodenetwork setting value
array of string, Nodenetwork setting value
name
: string or array of string
string, Nodenetwork setting type name
array of string, Nodenetwork setting type name
nodenetwork_id
: int or array of int
int, NodeNetwork identifier
array of int, NodeNetwork identifier
min_role_id
: int or array of int
int, Minimum (least powerful) role that can set or change this attribute
array of int, Minimum (least powerful) role that can set or change this attribute
nodenetwork_setting_id
: int or array of int
int, Nodenetwork setting identifier
array of int, Nodenetwork setting identifier
return_fields
: array, List of fields to return
Returns:
array of struct
category
: string, Nodenetwork setting category
description
: string, Nodenetwork setting type description
nodenetwork_setting_type_id
: int, Nodenetwork setting type identifier
value
: string, Nodenetwork setting value
nodenetwork_id
: int, NodeNetwork identifier
min_role_id
: int, Minimum (least powerful) role that can set or change this attribute
nodenetwork_setting_id
: int, Nodenetwork setting identifier
name
: string, Nodenetwork setting type name
3.2.1.6. GetNodeNetworkSettingTypesPrototype: GetNodeNetworkSettingTypes (auth, nodenetwork_setting_type_filter, return_fields)
Description: Returns an array of structs containing details about
nodenetwork setting types. The usual filtering scheme applies on this method.
Allowed Roles: admin, pi, user, tech, node
Parameters:
auth
: struct, API authentication structure
nodenetwork_setting_type_filter
: array of int or string or struct
array of int or string
int, Nodenetwork setting type identifier
string, Nodenetwork setting type name
struct, Attribute filter
category
: string or array of string
string, Nodenetwork setting category
array of string, Nodenetwork setting category
nodenetwork_setting_type_id
: int or array of int
int, Nodenetwork setting type identifier
array of int, Nodenetwork setting type identifier
min_role_id
: int or array of int
int, Minimum (least powerful) role that can set or change this attribute
array of int, Minimum (least powerful) role that can set or change this attribute
name
: string or array of string
string, Nodenetwork setting type name
array of string, Nodenetwork setting type name
description
: string or array of string
string, Nodenetwork setting type description
array of string, Nodenetwork setting type description
return_fields
: array, List of fields to return
Returns:
array of struct
category
: string, Nodenetwork setting category
nodenetwork_setting_type_id
: int, Nodenetwork setting type identifier
min_role_id
: int, Minimum (least powerful) role that can set or change this attribute
name
: string, Nodenetwork setting type name
description
: string, Nodenetwork setting type description
3.2.1.7. UpdateNodeNetworkSettingPrototype: UpdateNodeNetworkSetting (auth, nodenetwork_setting_id, value)
Description: Updates the value of an existing nodenetwork setting Access rights depend on the nodenetwork setting type. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
nodenetwork_setting_id
: int, Nodenetwork setting identifier
value
: string, Nodenetwork setting value
Returns: 3.2.1.8. UpdateNodeNetworkSettingTypePrototype: UpdateNodeNetworkSettingType (auth, nodenetwork_setting_type_id_or_name, nodenetwork_setting_type_fields)
Description: Updates the parameters of an existing setting type
with the values in nodenetwork_setting_type_fields. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
nodenetwork_setting_type_id_or_name
: int or string
int, Nodenetwork setting type identifier
string, Nodenetwork setting type name
nodenetwork_setting_type_fields
: struct
category
: string, Nodenetwork setting category
min_role_id
: int, Minimum (least powerful) role that can set or change this attribute
name
: string, Nodenetwork setting type name
description
: string, Nodenetwork setting type description
Returns: Prototype: AddNodeGroup (auth, nodegroup_fields)
Description: Adds a new node group. Any values specified in nodegroup_fields
are used, otherwise defaults are used. Returns the new nodegroup_id (> 0) if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: DeleteNodeGroup (auth, node_group_id_or_name)
Description: Delete an existing Node Group. ins may delete any node group Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: GetNodeGroups (auth, nodegroup_filter, return_fields)
Description: Returns an array of structs containing details about node groups.
If nodegroup_filter is specified and is an array of node group
identifiers or names, or a struct of node group attributes, only
node groups matching the filter will be returned. If return_fields
is specified, only the specified details will be returned.
Allowed Roles: admin, pi, user, tech, node, anonymous
Parameters:
auth
: struct, API authentication structure
nodegroup_filter
: array of int or string or struct
array of int or string
struct, Attribute filter
nodegroup_id
: int or array of int
int, Node group identifier
array of int, Node group identifier
name
: string or array of string
description
: string or array of string
string, Node group description
array of string, Node group description
return_fields
: array, List of fields to return
Returns:
array of struct
node_ids
: array, List of nodes in this node group
nodegroup_id
: int, Node group identifier
name
: string, Node group name
conf_file_ids
: array, List of configuration files specific to this node group
description
: string, Node group description
Prototype: UpdateNodeGroup (auth, nodegroup_id_or_name, nodegroup_fields)
Description: Updates a custom node group. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
nodegroup_id_or_name
: int or string
nodegroup_fields
: struct
nodes
: array of int or string
conf_files
: array of int, ConfFile identifier
name
: string, Node group name
description
: string, Node group description
Returns: Prototype: AddBootState (auth, name)
Description: Adds a new node boot state. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
name
: string, Boot state
Returns: Prototype: DeleteBootState (auth, name)
Description: Deletes a node boot state. WARNING: This will cause the deletion of all nodes in this boot
state. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
name
: string, Boot state
Returns: Prototype: Description: Returns an array of all valid node boot states.
Allowed Roles: admin, pi, user, tech, node
Parameters: Returns: 3.2.3.4. BootNotifyOwnersPrototype: BootNotifyOwners (auth, message_id, include_pis, include_techs, include_support)
Description: Notify the owners of the node, and/or support about an event that
happened on the machine. Returns 1 if successful.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
AuthMethod
: string, Authentication method to use, always 'hmac'
value
: string, HMAC of node key and method call
node_id
: int, Node identifier
message_id
: string, Message identifier
include_pis
: int, Notify PIs
include_techs
: int, Notify technical contacts
include_support
: int, Notify support
Returns: Prototype: AddMessage (auth, message_fields)
Description: Adds a new message template. Any values specified in
message_fields are used, otherwise defaults are used. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: DeleteMessage (auth, message_id)
Description: Deletes a message template. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
message_id
: string, Message identifier
Returns: Prototype: GetMessages (auth, message_filter, return_fields)
Description: Returns an array of structs containing details about message
templates. If message template_filter is specified and is an array
of message template identifiers, or a struct of message template
attributes, only message templates matching the filter will be
returned. If return_fields is specified, only the specified
details will be returned.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
message_filter
: array of string or struct
return_fields
: array, List of fields to return
Returns:
array of struct
enabled
: boolean, Message is enabled
message_id
: string, Message identifier
template
: string, Message template
subject
: string, Message summary
Prototype: UpdateMessage (auth, message_id, message_fields)
Description: Updates the parameters of an existing message template with the
values in message_fields. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
message_id
: string, Message identifier
message_fields
: struct
enabled
: boolean, Message is enabled
template
: string, Message template
Returns: Prototype: AddConfFile (auth, conf_file_fields)
Description: Adds a new node configuration file. Any fields specified in
conf_file_fields are used, otherwise defaults are used. Returns the new conf_file_id (> 0) if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: DeleteConfFile (auth, conf_file_id)
Description: Returns an array of structs containing details about node
configuration files. If conf_file_ids is specified, only the
specified configuration files will be queried.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
conf_file_id
: int, Configuration file identifier
Returns: Prototype: GetConfFiles (auth, conf_file_filter, return_fields)
Description: Returns an array of structs containing details about configuration
files. If conf_file_filter is specified and is an array of
configuration file identifiers, or a struct of configuration file
attributes, only configuration files matching the filter will be
returned. If return_fields is specified, only the specified
details will be returned.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
conf_file_filter
: array of int or struct
return_fields
: array, List of fields to return
Returns:
array of struct
file_owner
: string, chown(1) owner
postinstall_cmd
: string, Shell command to execute after installing
error_cmd
: string, Shell command to execute if any error occurs
preinstall_cmd
: string, Shell command to execute prior to installing
node_ids
: int, List of nodes linked to this file
dest
: string, Absolute path where file should be installed
ignore_cmd_errors
: boolean, Install file anyway even if an error occurs
enabled
: boolean, Configuration file is active
conf_file_id
: int, Configuration file identifier
file_permissions
: string, chmod(1) permissions
source
: string, Relative path on the boot server where file can be downloaded
nodegroup_ids
: int, List of node groups linked to this file
always_update
: boolean, Always attempt to install file even if unchanged
file_group
: string, chgrp(1) owner
Prototype: UpdateConfFile (auth, conf_file_id, conf_file_fields)
Description: Updates a node configuration file. Only the fields specified in
conf_file_fields are updated, all other fields are left untouched. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
conf_file_id
: int, Configuration file identifier
conf_file_fields
: struct
file_owner
: string, chown(1) owner
postinstall_cmd
: string, Shell command to execute after installing
error_cmd
: string, Shell command to execute if any error occurs
preinstall_cmd
: string, Shell command to execute prior to installing
dest
: string, Absolute path where file should be installed
ignore_cmd_errors
: boolean, Install file anyway even if an error occurs
enabled
: boolean, Configuration file is active
file_permissions
: string, chmod(1) permissions
source
: string, Relative path on the boot server where file can be downloaded
always_update
: boolean, Always attempt to install file even if unchanged
file_group
: string, chgrp(1) owner
Returns: Prototype: AddNetworkType (auth, name)
Description: Adds a new network type. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
name
: string, Network type
Returns: 3.2.6.2. DeleteNetworkTypePrototype: DeleteNetworkType (auth, name)
Description: Deletes a network type. WARNING: This will cause the deletion of all network interfaces
that use this type. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
name
: string, Network type
Returns: Prototype: Description: Returns a list of all valid network types.
Allowed Roles: admin, pi, user, tech, node
Parameters: Returns: 3.2.6.4. AddNetworkMethodPrototype: AddNetworkMethod (auth, name)
Description: Adds a new network method. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
name
: string, Network method
Returns: 3.2.6.5. DeleteNetworkMethodPrototype: DeleteNetworkMethod (auth, name)
Description: Deletes a network method. WARNING: This will cause the deletion of all network interfaces
that use this method. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
name
: string, Network method
Returns: 3.2.6.6. GetNetworkMethodsPrototype: Description: Returns a list of all valid network methods.
Allowed Roles: admin, pi, user, tech, node
Parameters: Returns: Prototype: AddPCU (auth, site_id_or_login_base, pcu_fields)
Description: Adds a new power control unit (PCU) to the specified site. Any
fields specified in pcu_fields are used, otherwise defaults are
used. PIs and technical contacts may only add PCUs to their own sites. Returns the new pcu_id (> 0) if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: Description: Deletes a PCU. Non-admins may only delete PCUs at their sites. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
pcu_id
: int, PCU identifier
Returns: Prototype: GetPCUs (auth, pcu_filter, return_fields)
Description: Returns an array of structs containing details about power control
units (PCUs). If pcu_filter is specified and is an array of PCU
identifiers, or a struct of PCU attributes, only PCUs matching the
filter will be returned. If return_fields is specified, only the
specified details will be returned. Admin may query all PCUs. Non-admins may only query the PCUs at
their sites.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
pcu_filter
: array of int or struct
return_fields
: array, List of fields to return
Returns:
array of struct
username
: string, PCU username
protocol
: string, PCU protocol, e.g. ssh, https, telnet
node_ids
: array, List of nodes that this PCU controls
ip
: string, PCU IP address
pcu_id
: int, PCU identifier
hostname
: string, PCU hostname
site_id
: int, Identifier of site where PCU is located
ports
: array, List of the port numbers that each node is connected to
model
: string, PCU model string
password
: string, PCU username
notes
: string, Miscellaneous notes
Prototype: UpdatePCU (auth, pcu_id, pcu_fields)
Description: Updates the parameters of an existing PCU with the values in
pcu_fields. Non-admins may only update PCUs at their sites. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
pcu_id
: int, PCU identifier
pcu_fields
: struct
username
: string, PCU username
protocol
: string, PCU protocol, e.g. ssh, https, telnet
node_ids
: array, List of nodes that this PCU controls
ip
: string, PCU IP address
notes
: string, Miscellaneous notes
hostname
: string, PCU hostname
model
: string, PCU model string
password
: string, PCU username
ports
: array, List of the port numbers that each node is connected to
Returns: Prototype: AddNodeNetwork (auth, node_id_or_hostname, nodenetwork_fields)
Description: Adds a new network for a node. Any values specified in
nodenetwork_fields are used, otherwise defaults are
used. Acceptable values for method may be retrieved via
GetNetworkMethods. Acceptable values for type may be retrieved via
GetNetworkTypes. If type is static, ip, gateway, network, broadcast, netmask, and
dns1 must all be specified in nodenetwork_fields. If type is dhcp,
these parameters, even if specified, are ignored. PIs and techs may only add networks to their own nodes. Admins may
add networks to any node. Returns the new nodenetwork_id (> 0) if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
node_id_or_hostname
: int or string
nodenetwork_fields
: struct
network
: string, Subnet address
is_primary
: boolean, Is the primary interface for this node
dns1
: string, IP address of primary DNS server
hostname
: string, (Optional) Hostname
mac
: string, MAC address
bwlimit
: int, Bandwidth limit
broadcast
: string, Network broadcast address
method
: string, Addressing method (e.g., 'static' or 'dhcp')
netmask
: string, Subnet mask
dns2
: string, IP address of secondary DNS server
ip
: string, IP address
type
: string, Address type (e.g., 'ipv4')
gateway
: string, IP address of primary gateway
nodenetwork_setting_ids
: array, List of nodenetwork settings
Returns: 3.2.8.2. DeleteNodeNetworkPrototype: DeleteNodeNetwork (auth, nodenetwork_id)
Description: Deletes an existing node network interface. Admins may delete any node network. PIs and techs may only delete
node network interfaces associated with nodes at their sites. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
nodenetwork_id
: int, Node interface identifier
Returns: Prototype: GetNodeNetworks (auth, nodenetwork_filter, return_fields)
Description: Returns an array of structs containing details about node network
interfacess. If nodenetworks_filter is specified and is an array
of node network identifiers, or a struct of node network
fields and values, only node network interfaces matching the filter
will be returned. If return_fields is given, only the specified details will be returned.
Allowed Roles: admin, pi, user, tech, node, anonymous
Parameters:
auth
: struct, API authentication structure
nodenetwork_filter
: array of int or int or struct
return_fields
: array, List of fields to return
Returns:
array of struct
broadcast
: string, Network broadcast address
is_primary
: boolean, Is the primary interface for this node
network
: string, Subnet address
ip
: string, IP address
dns1
: string, IP address of primary DNS server
hostname
: string, (Optional) Hostname
netmask
: string, Subnet mask
gateway
: string, IP address of primary gateway
nodenetwork_id
: int, Node interface identifier
mac
: string, MAC address
node_id
: int, Node associated with this interface
dns2
: string, IP address of secondary DNS server
bwlimit
: int, Bandwidth limit
type
: string, Address type (e.g., 'ipv4')
method
: string, Addressing method (e.g., 'static' or 'dhcp')
nodenetwork_setting_ids
: array, List of nodenetwork settings
3.2.8.4. UpdateNodeNetworkPrototype: UpdateNodeNetwork (auth, nodenetwork_id, nodenetwork_fields)
Description: Updates an existing node network. Any values specified in
nodenetwork_fields are used, otherwise defaults are
used. Acceptable values for method are dhcp and static. If type is
static, then ip, gateway, network, broadcast, netmask, and dns1
must all be specified in nodenetwork_fields. If type is dhcp,
these parameters, even if specified, are ignored. PIs and techs may only update networks associated with their own
nodes. Admins may update any node network. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
nodenetwork_id
: int, Node interface identifier
nodenetwork_fields
: struct
network
: string, Subnet address
is_primary
: boolean, Is the primary interface for this node
dns1
: string, IP address of primary DNS server
hostname
: string, (Optional) Hostname
mac
: string, MAC address
bwlimit
: int, Bandwidth limit
broadcast
: string, Network broadcast address
method
: string, Addressing method (e.g., 'static' or 'dhcp')
netmask
: string, Subnet mask
dns2
: string, IP address of secondary DNS server
ip
: string, IP address
type
: string, Address type (e.g., 'ipv4')
gateway
: string, IP address of primary gateway
nodenetwork_setting_ids
: array, List of nodenetwork settings
Returns: Prototype: AddNodeToPCU (auth, node_id_or_hostname, pcu_id, port)
Description: Adds a node to a port on a PCU. Faults if the node has already
been added to the PCU or if the port is already in use. Non-admins may only update PCUs at their sites. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
node_id_or_hostname
: int or string
pcu_id
: int, PCU identifier
port
: int, PCU port number
Returns: 3.2.9.2. DeleteNodeFromPCUPrototype: DeleteNodeFromPCU (auth, node_id_or_hostname, pcu_id)
Description: Deletes a node from a PCU. Non-admins may only update PCUs at their sites. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
node_id_or_hostname
: int or string
pcu_id
: int, PCU identifier
Returns: Prototype: GetEvents (auth, event_filter, return_fields)
Description: Returns an array of structs containing details about events and
faults. If event_filter is specified and is an array of event
identifiers, or a struct of event attributes, only events matching
the filter will be returned. If return_fields is specified, only the
specified details will be returned.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
event_filter
: array of int or struct
return_fields
: array, List of fields to return
Returns:
array of struct
auth_type
: int, Type of auth used. i.e. AuthMethod
fault_code
: int, Event fault code
event_id
: int, Event identifier
object_ids
: array, IDs of objects affected by this event
node_id
: int, Identifier of node responsible for event, if any
call
: string, Call responsible for this event, including paramters
time
: int, Date and time that the event took place, in seconds since UNIX epoch
person_id
: int, Identifier of person responsible for event, if any
message
: string, High level description of this event
runtime
: double, Runtime of event
call_name
: string, Call responsible for this event
object_types
: array, What type of object were affected by this event
3.2.10.2. GetEventObjectsPrototype: GetEventObjects (auth, event_filter, return_fields)
Description: Returns an array of structs containing details about events and
faults. If event_filter is specified and is an array of event
identifiers, or a struct of event attributes, only events matching
the filter will be returned. If return_fields is specified, only the
specified details will be returned.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
event_filter
: struct, Attribute filter
fault_code
: int or array of int
event_id
: int or array of int
object_type
: string or array of string
string, What type of object is this event affecting
array of string, What type of object is this event affecting
object_id
: int or array of int
int, ID of objects affected by this event
array of int, ID of objects affected by this event
node_id
: int or array of int
int, Identifier of node responsible for event, if any
array of int, Identifier of node responsible for event, if any
call
: string or array of string
string, Call responsible for this event, including paramters
array of string, Call responsible for this event, including paramters
time
: int or array of int
int, Date and time that the event took place, in seconds since UNIX epoch
array of int, Date and time that the event took place, in seconds since UNIX epoch
person_id
: int or array of int
int, Identifier of person responsible for event, if any
array of int, Identifier of person responsible for event, if any
message
: string or array of string
string, High level description of this event
array of string, High level description of this event
runtime
: double or array of double
call_name
: string or array of string
string, Call responsible for this event
array of string, Call responsible for this event
return_fields
: array, List of fields to return
Returns:
array of struct
fault_code
: int, Event fault code
event_id
: int, Event identifier
object_type
: string, What type of object is this event affecting
object_id
: int, ID of objects affected by this event
node_id
: int, Identifier of node responsible for event, if any
call
: string, Call responsible for this event, including paramters
time
: int, Date and time that the event took place, in seconds since UNIX epoch
person_id
: int, Identifier of person responsible for event, if any
message
: string, High level description of this event
runtime
: double, Runtime of event
call_name
: string, Call responsible for this event
Prototype: GetBootMedium (auth, node_id_or_hostname, action, filename)
Description: This method is a redesign based on former, supposedly dedicated,
AdmGenerateNodeConfFile As compared with its ancestor, this method provides a much more detailed
detailed interface, that allows to
(*) either just preview the node config file (in which case
the node key is NOT recomputed, and NOT provided in the output
(*) or regenerate the node config file for storage on a floppy
that is, exactly what the ancestor method used todo,
including renewing the node's key
(*) or regenerate the config file and bundle it inside an ISO or USB image
(*) or just provide the generic ISO or USB boot images
in which case of course the node_id_or_hostname parameter is not used action is expected among the following string constants
(*) node-preview
(*) node-floppy
(*) node-iso
(*) node-usb
(*) generic-iso
(*) generic-usb Apart for the preview mode, this method generates a new node key for the
specified node, effectively invalidating any old boot medium. Non-admins can only generate files for nodes at their sites. In addition, two return mechanisms are supported.
(*) The default behaviour is that the file's content is returned as a
base64-encoded string. This is how the ancestor method used to work.
To use this method, pass an empty string as the file parameter. (*) Or, for efficiency -- this makes sense only when the API is used
by the web pages that run on the same host -- the caller may provide
a filename, in which case the resulting file is stored in that location instead.
The filename argument can use the following markers, that are expanded
within the method
- %d : default root dir (some builtin dedicated area under /var/tmp/)
Using this is recommended, and enforced for non-admin users
- %n : the node's name when this makes sense, or a mktemp-like name when
generic media is requested
- %s : a file suffix appropriate in the context (.txt, .iso or the like)
- %v : the bootcd version string (e.g. 4.0)
- %p : the PLC name
With the file-based return mechanism, the method returns the full pathname
of the result file; it is the caller's responsability to remove
this file after use. Security:
When the user's role is not admin, the provided directory *must* be under
the %d area Housekeeping:
Whenever needed, the method stores intermediate files in a
private area, typically not located under the web server's
accessible area, and are cleaned up by the method.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
node_id_or_hostname
: int or string
action
: string, Action mode, expected in node-preview|node-floppy|node-iso|node-usb|generic-iso|generic-usb
filename
: string, Empty string for verbatim result, resulting file full path otherwise
Returns:
string, Node boot medium, either inlined, or filename, depending to the filename parameter
Prototype: Description: Returns various information about the current myplc installation.
Allowed Roles: admin, pi, user, tech, node, anonymous
Parameters: Returns:
struct
rpms
: string
build
: string
tags
: string
Prototype: NotifySupport (auth, subject, body)
Description: Sends an e-mail message to the configured support address. Returns 1 if successful.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
subject
: string, E-mail subject
body
: string, E-mail body
Returns: Chapter 4. Slice Interface4.1.1.1. AddSliceAttributePrototype: AddSliceAttribute (auth, slice_id_or_name, attribute_type_id_or_name, value, node_id_or_hostname, nodegroup_id_or_name)
Description: Sets the specified attribute of the slice (or sliver, if
node_id_or_hostname is specified) to the specified value. Attributes may require the caller to have a particular role in
order to be set or changed. Users may only set attributes of
slices or slivers of which they are members. PIs may only set
attributes of slices or slivers at their sites, or of which they
are members. Admins may set attributes of any slice or sliver. Returns the new slice_attribute_id (> 0) if successful, faults
otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
slice_id_or_name
: int or string
attribute_type_id_or_name
: int or string
int, Slice attribute type identifier
string, Slice attribute type name
value
: string or int
string, Slice attribute value
int, Initscript identifier
node_id_or_hostname
: int or string or nil
nodegroup_id_or_name
: int or string
Returns: 4.1.1.2. DeleteSliceAttributePrototype: DeleteSliceAttribute (auth, slice_attribute_id)
Description: Deletes the specified slice or sliver attribute. Attributes may require the caller to have a particular role in
order to be deleted. Users may only delete attributes of
slices or slivers of which they are members. PIs may only delete
attributes of slices or slivers at their sites, or of which they
are members. Admins may delete attributes of any slice or sliver. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
slice_attribute_id
: int, Slice attribute identifier
Returns: 4.1.1.3. GetSliceAttributesPrototype: GetSliceAttributes (auth, slice_attribute_filter, return_fields)
Description: Returns an array of structs containing details about slice and
sliver attributes. An attribute is a sliver attribute if the
node_id field is set. If slice_attribute_filter is specified and
is an array of slice attribute identifiers, or a struct of slice
attribute attributes, only slice attributes matching the filter
will be returned. If return_fields is specified, only the
specified details will be returned. Users may only query attributes of slices or slivers of which they
are members. PIs may only query attributes of slices or slivers at
their sites, or of which they are members. Admins may query
attributes of any slice or sliver.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
slice_attribute_filter
: array of int or struct
return_fields
: array, List of fields to return
Returns:
array of struct
name
: string, Slice attribute type name
slice_id
: int, Slice identifier
slice_attribute_id
: int, Slice attribute identifier
value
: string, Slice attribute value
attribute_type_id
: int, Slice attribute type identifier
nodegroup_id
: int, Nodegroup identifier, if a sliver attribute
node_id
: int, Node identifier, if a sliver attribute
min_role_id
: int, Minimum (least powerful) role that can set or change this attribute
description
: string, Slice attribute type description
4.1.1.4. UpdateSliceAttributePrototype: UpdateSliceAttribute (auth, slice_attribute_id, value)
Description: Updates the value of an existing slice or sliver attribute. Users may only update attributes of slices or slivers of which
they are members. PIs may only update attributes of slices or
slivers at their sites, or of which they are members. Admins may
update attributes of any slice or sliver. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
slice_attribute_id
: int, Slice attribute identifier
value
: string or int
string, Slice attribute value
int, Initscript identifier
Returns: Prototype: RefreshPeer (auth, peer_id_or_peername)
Description: Fetches site, node, slice, person and key data from the specified peer
and caches it locally; also deletes stale entries.
Upon successful completion, returns a dict reporting various timers.
Faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: Description: Returns lists of local objects that a peer should cache in its
database as foreign objects. Also returns the list of foreign
nodes in this database, for which the calling peer is
authoritative, to assist in synchronization of slivers. See the implementation of RefreshPeer for how this data is used.
Allowed Roles: Parameters: Returns:
struct
Slices
: array, List of local slices
Keys
: array, List of local keys
Sites
: array, List of local sites
Persons
: array, List of local users
Nodes
: array, List of local nodes
db_time
: double, (Debug) Database fetch time
Prototype: Description: Create a non-PLC-instantiated sliver
Allowed Roles: Parameters: Returns: Prototype: Description: The Node Manager periodically polls the PLC API for a list
of all slices that are allowed to exist on the given node.
Before actions are performed on a delegated slice
(such as creation), a controller slice must deliver a valid
slice ticket to NM. This ticket is the value retured by PLC's GetSliceTicket()
API call.
Allowed Roles: Parameters: Returns: Prototype: Description: Destroy a non-PLC-instantiated sliver
Allowed Roles: Parameters: Returns: Prototype: Description: Run start scripts belonging to the specified sliver.
Allowed Roles: Parameters: Returns: Prototype: Description: Kill all processes belonging to the specified sliver.
Allowed Roles: Parameters: Returns: 4.1.3.6. GetEffectiveRSpecPrototype: GetEffectiveRSpec (sliver_name)
Description: Return the RSpec allocated to the specified sliver, including loans
Allowed Roles: Parameters: Returns: Prototype: Description: Return the RSpec allocated to the specified sliver, excluding loans
Allowed Roles: Parameters: Returns: Prototype: Description: Return the list of loans made by the specified sliver
Allowed Roles: Parameters: Returns: Prototype: SetLoans (sliver_name, loans)
Description: Overwrite the list of loans made by the specified sliver. Also, note that SetLoans will not throw an error if more
capacity than the RSpec is handed out, but it will silently
discard those loans that would put it over capacity. This
behavior may be replaced with error semantics in the future.
As well, there is currently no asynchronous notification of
loss of resources.
Allowed Roles: Parameters: Returns: Prototype: Description: Return an dictionary mapping slice names to SSH keys
Allowed Roles: Parameters: Returns: Prototype: Description: Return an dictionary mapping Slice names to XIDs
Allowed Roles: Parameters: Returns: Prototype: GetSliceTicket (auth, slice_id_or_name)
Description: Returns a ticket for, or signed representation of, the specified
slice. Slice tickets may be used to manually instantiate or update
a slice on a node. Present this ticket to the local Node Manager
interface to redeem it. If the slice has not been added to a node with AddSliceToNodes,
and the ticket is redeemed on that node, it will be deleted the
next time the Node Manager contacts the API. Users may only obtain tickets for slices of which they are
members. PIs may obtain tickets for any of the slices at their
sites, or any slices of which they are members. Admins may obtain
tickets for any slice. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters: Returns: Prototype: AddSliceToNodes (auth, slice_id_or_name, node_id_or_hostname_list)
Description: Adds the specified slice to the specified nodes. Nodes may be
either local or foreign nodes. If the slice is already associated with a node, no errors are
returned. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
slice_id_or_name
: int or string
int, Slice identifier
string, Slice name
node_id_or_hostname_list
: array of int or string
Returns: 4.1.5.3. DeleteSliceFromNodesPrototype: DeleteSliceFromNodes (auth, slice_id_or_name, node_id_or_hostname_list)
Description: Deletes the specified slice from the specified nodes. If the slice is
not associated with a node, no errors are returned. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
slice_id_or_name
: int or string
int, Slice identifier
string, Slice name
node_id_or_hostname_list
: array of int or string
Returns: Prototype: GetSlivers (auth, node_id_or_hostname)
Description: Returns a struct containing information about the specified node
(or calling node, if called by a node and node_id_or_hostname is
not specified), including the current set of slivers bound to the
node. All of the information returned by this call can be gathered from
other calls, e.g. GetNodes, GetNodeNetworks, GetSlices, etc. This
function exists almost solely for the benefit of Node Manager.
Allowed Roles: Parameters: Returns:
struct
timestamp
: int, Timestamp of this call, in seconds since UNIX epoch
hostname
: string, Fully qualified hostname
conf_files
: array of struct
file_owner
: string, chown(1) owner
postinstall_cmd
: string, Shell command to execute after installing
error_cmd
: string, Shell command to execute if any error occurs
preinstall_cmd
: string, Shell command to execute prior to installing
node_ids
: int, List of nodes linked to this file
dest
: string, Absolute path where file should be installed
ignore_cmd_errors
: boolean, Install file anyway even if an error occurs
enabled
: boolean, Configuration file is active
conf_file_id
: int, Configuration file identifier
file_permissions
: string, chmod(1) permissions
source
: string, Relative path on the boot server where file can be downloaded
nodegroup_ids
: int, List of node groups linked to this file
always_update
: boolean, Always attempt to install file even if unchanged
file_group
: string, chgrp(1) owner
initscripts
: array of struct
initscript_id
: int, Initscript identifier
enabled
: boolean, Initscript is active
name
: string, Initscript name
script
: string, Initscript
node_id
: int, Node identifier
groups
: array of string, Node group name
networks
: array of struct
broadcast
: string, Network broadcast address
is_primary
: boolean, Is the primary interface for this node
network
: string, Subnet address
ip
: string, IP address
dns1
: string, IP address of primary DNS server
hostname
: string, (Optional) Hostname
netmask
: string, Subnet mask
gateway
: string, IP address of primary gateway
nodenetwork_id
: int, Node interface identifier
mac
: string, MAC address
node_id
: int, Node associated with this interface
dns2
: string, IP address of secondary DNS server
bwlimit
: int, Bandwidth limit
type
: string, Address type (e.g., 'ipv4')
method
: string, Addressing method (e.g., 'static' or 'dhcp')
nodenetwork_setting_ids
: array, List of nodenetwork settings
slivers
: array of struct
instantiation
: string, Slice instantiation state
name
: string, Slice name
slice_id
: int, Slice identifier
keys
: array of struct
expires
: int, Date and time when slice expires, in seconds since UNIX epoch
attributes
: array of struct
name
: string, Slice attribute type name
value
: string, Slice attribute value
Prototype: Description: Returns the current md5 hash of slices.xml file
(slices-0.5.xml.md5)
Allowed Roles: admin, pi, user, tech, node
Parameters: Returns: Prototype: UpdateSlice (auth, slice_id_or_name, slice_fields)
Description: Updates the parameters of an existing slice with the values in
slice_fields. Users may only update slices of which they are members. PIs may
update any of the slices at their sites, or any slices of which
they are members. Admins may update any slice. Only PIs and admins may update max_nodes. Slices cannot be renewed
(by updating the expires parameter) more than 8 weeks into the
future. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters: Returns: 4.2.1.1. AddSliceToNodesWhitelistPrototype: AddSliceToNodesWhitelist (auth, slice_id_or_name, node_id_or_hostname_list)
Description: Adds the specified slice to the whitelist on the specified nodes. Nodes may be
either local or foreign nodes. If the slice is already associated with a node, no errors are
returned. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
slice_id_or_name
: int or string
int, Slice identifier
string, Slice name
node_id_or_hostname_list
: array of int or string
Returns: 4.2.1.2. DeleteSliceFromNodesWhitelistPrototype: DeleteSliceFromNodesWhitelist (auth, slice_id_or_name, node_id_or_hostname_list)
Description: Deletes the specified slice from the whitelist on the specified nodes. Nodes may be
either local or foreign nodes. If the slice is already associated with a node, no errors are
returned. Returns 1 if successful, faults otherwise.
Allowed Roles: Parameters:
auth
: struct, API authentication structure
slice_id_or_name
: int or string
int, Slice identifier
string, Slice name
node_id_or_hostname_list
: array of int or string
Returns: Prototype: GetWhitelist (auth, node_filter, return_fields)
Description: Returns an array of structs containing details about the specified nodes
whitelists. If node_filter is specified and is an array of node identifiers or
hostnames, or a struct of node attributes, only nodes matching the
filter will be returned. If return_fields is specified, only the
specified details will be returned. Some fields may only be viewed by admins.
Allowed Roles: admin, pi, user, tech, node, anonymous
Parameters:
auth
: struct, API authentication structure
node_filter
: array of int or string or struct
array of int or string
struct, Attribute filter
key
: string or array of string
string, (Admin only) Node key
array of string, (Admin only) Node key
node_id
: int or array of int
last_updated
: int or array of int
int, Date and time when node entry was created
array of int, Date and time when node entry was created
last_contact
: int or array of int
int, Date and time when node last contacted plc
array of int, Date and time when node last contacted plc
boot_state
: string or array of string
peer_node_id
: int or array of int
int, Foreign node identifier at peer
array of int, Foreign node identifier at peer
hostname
: string or array of string
string, Fully qualified hostname
array of string, Fully qualified hostname
site_id
: int or array of int
int, Site at which this node is located
array of int, Site at which this node is located
boot_nonce
: string or array of string
string, (Admin only) Random value generated by the node at last boot
array of string, (Admin only) Random value generated by the node at last boot
session
: string or array of string
string, (Admin only) Node session value
array of string, (Admin only) Node session value
version
: string or array of string
string, Apparent Boot CD version
array of string, Apparent Boot CD version
date_created
: int or array of int
int, Date and time when node entry was created
array of int, Date and time when node entry was created
model
: string or array of string
string, Make and model of the actual machine
array of string, Make and model of the actual machine
peer_id
: int or array of int
int, Peer to which this node belongs
array of int, Peer to which this node belongs
ssh_rsa_key
: string or array of string
string, Last known SSH host key
array of string, Last known SSH host key
return_fields
: array, List of fields to return
Returns:
array of struct
last_updated
: int, Date and time when node entry was created
boot_state
: string, Boot state
site_id
: int, Site at which this node is located
pcu_ids
: array, List of PCUs that control this node
session
: string, (Admin only) Node session value
|
