Dean Hamstead > Net-Proxmox-VE > Net::Proxmox::VE::Nodes

Download:
Net-Proxmox-VE-0.006.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 0.3   Source  

nodes

Returns the 'Cluster node index'

Note: Accessible by all authententicated users.

get_nodes

Gets a single nodes details

  $ok = $obj->get_nodes('node')

node is a string in pve-node format

Note: Accessible by all authententicated users.

get_nodes_aplinfo

Gets a single nodes list of appliances

  $ok = $obj->get_nodes_aplinfo('node')

node is a string in pve-node format

Note: Accessible by all authententicated users.

create_nodes_aplinfo

Create (upload) appliance templates.

  $ok = $obj->download_nodes_aplinfo('node',\%args)

node is a string in pve-node format

%args may items contain from the following list

storage

String. The storage to be used in pve-storage-id format. Required.

template

Data. The actual template. Required.

Note: required permissions are ["perm","/storage/{storage}",["Datastore.AllocateTemplate"]]

get_nodes_dns

Get DNS settings.

  $ok = $obj->get_nodes_dns('node')

node is a string in pve-node format

Note: required permissions are ["perm","/nodes/{node}",["Sys.Audit"]]

update_nodes_dns

Updates (writes) DNS settings.

  $ok = $obj->update_nodes_dns('node', \%args)

node is a string in pve-node format

%args may items contain from the following list

search

String. Search domain for host-name lookup. Required.

Note: required permissions are ["perm","/nodes/{node}",["Sys.Audit"]]

get_nodes_rrd

Get nodes RRD statistics (returns PNG).

  $ok = $obj->get_nodes_rrd('node', \%args)

node is a string in pve-node format

%args may items contain from the following list

ds

String. The list of datasources you wish to see, in pve-configid-list format. Required.

timeframe

Enum. Is either hour, day, week, month or year. Required.

cf

Enum. Is either AVERAGE or MAX. Controls the RRD consolidation function. Optional.

Note: required permissions are ["perm","/nodes/{node}",["Sys.Audit"]]

get_nodes_rrddata

Get nodes RRD statistics.

  $ok = $obj->get_nodes_rrddata('node', \%args)

node is a string in pve-node format

%args may items contain from the following list

timeframe

Enum. Is either hour, day, week, month or year. Required.

cf

Enum. Is either AVERAGE or MAX. Controls the RRD consolidation function. Optional.

Note: required permissions are ["perm","/nodes/{node}",["Sys.Audit"]]

get_nodes_status

Gets node status

  $ok = $obj->get_nodes_status('node')

node is a string in pve-node format

Note: required permissions are ["perm","/nodes/{node}",["Sys.Audit"]]

updates_nodes_status

Reboot or shutdown a node

  $ok = $obj->updates_nodes_status('node', \%args)

node is a string in pve-node format

%args may items contain from the following list

command

Enum. Either reboot or shutdown. Specifies the command. Required.

Note: required permissions are ["perm","/nodes/{node}",["Sys.PowerMgmt"]]

get_nodes_subscription

Read nodes subscription info

  $ok = $obj->get_nodes_subscription('node')

node is a string in pve-node format

Note: Root only.

create_nodes_subscription

Create/update nodes subscription info

  $ok = $obj->create_nodes_subscription('node', \%args)

node is a string in pve-node format

%args may items contain from the following list

force

Boolean. Always connect to the server, even if we have up to date info inside local cache. Optional.

Note: Root only.

update_nodes_subscription_key

Updates/sets subscription key

  $ok = $obj->update_nodes_subscription_key('node', \%args)

node is a string in pve-node format

%args may items contain from the following list

key

Boolean. Proxmox VE subscription key. Required.

Note: Root only.

get_nodes_syslog

Reads system log

  $ok = $obj->get_nodes_syslog('node', \%args)

node is a string in pve-node format

Note: required permissions are ["perm","/nodes/{node}",["Sys.Syslog"]]

get_nodes_time

Read server time and time zone settings

  $ok = $obj->get_nodes_time('node')

node is a string in pve-node format

Note: required permissions are ["perm","/nodes/{node}",["Sys.Audit"]]

update_nodes_time

Updates time zone

  $ok = $obj->update_nodes_time('node', \%args)

node is a string in pve-node format

%args may items contain from the following list

timezone

String. Time zone to be used, see '/usr/share/zoneinfo/zone.tab'. Required.

Note: required permissions are ["perm","/nodes/{node}",["Sys.Modify"]]

get_nodes_ubcfailcnt

Get user_beancounters failcnt for all active containers.

  $ok = $obj->get_nodes_ubcfailcnt('node')

node is a string in pve-node format

Note: required permissions are ["perm","/nodes/{node}",["Sys.Audit"]]

get_nodes_version

Get user_beancounters failcnt for all active containers.

  $ok = $obj->get_nodes_version('node')

node is a string in pve-node format

Note: Accessible by all authententicated users.

create_nodes_vncshell

Creates a VNC Shell proxy.

  $ok = $obj->create_nodes_vncshell('node')

node is a string in pve-node format

Note: Restricted to users on realm 'pam'. Required permissions are ["perm","/nodes/{node}",["Sys.Console"]]

create_nodes_vzdump

Create backup.

  $ok = $obj->create_nodes_vzdump('node', \%args)

node is a string in pve-node format

%args may items contain from the following list

all

Boolean. Backup all known VMs on this host. Optional.

bwlimit

Integer. Limit I/O bandwidth (KBytes per second). Optional.

compress

Enum. Either 0, 1, gzip or lzo. Comress dump file. Optional

dumpdir

String. Store resulting files to specified directory. Optional.

exclude

String. Exclude specified VMs (assumes --all) in pve-vmid-list. Optional.

exclude-path

String. Exclude certain files/directories (regex) in string-alist. Optional.

ionice

Integer. Set CFQ ionice priority. Optional.

lockwait

Integer. Maximal time to wait for the global lock (minutes). Optional.

mailto

String. List of email addresses in string-list format. Optional.

maxfiles

Integer. Maximal number of backup files per vm. Optional.

mode

Enum. A value from snapshot, suspend or stop. Backup mode. Optional.

quiet

Boolean. Be quiet. Optional.

remove

Boolean. Remove old backup files if there are more than 'maxfiles' backup files. Optional.

script

String. Use specified hook script. Optional.

size

Integer. LVM snapshot size in MB. Optional.

stdexcludes

Boolean. Exclude temporary files and logs. Optional.

stdout

Boolean. Write tar to stdout rather than to a file. Optional.

stopwait

Integer. Maximal time to wait until a VM is stopped (minutes). Optional.

storage

String. Store resulting file to this storage, in pve-storage-id format. Optional.

tmpdir

String. Store temporary files to specified directory. Optional.

vmid

String. The ID of the VM you want to backup in pve-vm-list format. Optional.

Note: The user needs 'VM.Backup' permissions on any VM, and 'Datastore.AllocateSpace' on the backup storage.

nodes_network

List available networks on the node

  $ok = $obj->nodes_network('node', \%args)

node is a string in pve-node format

%args may items contain from the following list

type

Enum. One of bond, bridge, alias or eth. Only list specific interface types. Optional.

Note: Accessible by all authententicated users.

create_nodes_network

Create network device configuration

  $ok = $obj->create_nodes_network('node', \%args)

node is a string in pve-node format

%args may items contain from the following list

iface

String. The network interface name in pve-iface format. Required.

address

String. The ipv4 network address. Optional.

autostart

Boolean. Automatically start interface on boot. Optional.

bond_mode

Enum. Either of balance-rr, active-backup, balance-xor, broadcast, 802.3ad, balance-tlb or balance-alb. Specifies the bonding mode. Optional.

bridge_ports

String. Specify the interfaces you want to add to your bridge in pve-iface-list format. Optional.

gateway

String. Default ipv4 gateway address. Optional.

netmask

String. Network mask for ipv4. Optional.

slaves

String. Specify the interfaces used by the bonding device in pve-iface-list format. Optional.

Note: required permissions are ["perm","/nodes/{node}",["Sys.Modify"]]

revert_nodes_network

Revert network configuration changes.

  $ok = $obj->revert_nodes_network('node')

node is a string in pve-node format

Note: required permissions are ["perm","/nodes/{node}",["Sys.Modify"]]

get_nodes_network_iface

Read network device configuration

  $ok = $obj->get_nodes_network_iface('node', 'iface')

node is a string in pve-node format, iface is a string in pve-iface format

Note: required permissions are ["perm","/nodes/{node}",["Sys.Audit"]]

update_nodes_network_iface

Create network device configuration

  $ok = $obj->update_nodes_network_iface('node', 'iface', \%args)

node is a string in pve-node format, iface is a string in pve-iface format

%args may items contain from the following list

address

String. The ipv4 network address. Optional.

autostart

Boolean. Automatically start interface on boot. Optional.

bond_mode

Enum. Either of balance-rr, active-backup, balance-xor, broadcast, 802.3ad, balance-tlb or balance-alb. Specifies the bonding mode. Optional.

delete

String. Settings you want to delete in pve-configid-list format. Optional.

bridge_ports

String. Specify the interfaces you want to add to your bridge in pve-iface-list format. Optional.

gateway

String. Default ipv4 gateway address. Optional.

netmask

String. Network mask for ipv4. Optional.

slaves

String. Specify the interfaces used by the bonding device in pve-iface-list format. Optional.

Note: required permissions are ["perm","/nodes/{node}",["Sys.Modify"]]

delete_nodes_network_iface

Delete network device configuration

  $ok = $obj->delete_nodes_network_iface('node', 'iface')

node is a string in pve-node format, iface is a string in pve-iface format

Note: required permissions are ["perm","/nodes/{node}",["Sys.Modify"]]

SEE ALSO ^

  L<Net::Proxmox::VE>

VERSION ^

  VERSION 0.3

AUTHORS ^

  Dean Hamstead L<<dean@fragfest.com.au>>
syntax highlighting: