wti.remote.cpm_power_info – Get the Power Information of a WTI device

Note

This plugin is part of the wti.remote collection (version 1.0.1).

To install it use: ansible-galaxy collection install wti.remote.

To use it in a playbook, specify: wti.remote.cpm_power_info.

New in version 2.9: of wti.remote

Synopsis

• Get the Power Information of a WTI device

Parameters

Parameter	Choices/Defaults	Comments
cpm_enddate string		End date of the range to look for power data
cpm_password string / required		This is the Password of the WTI device to send the module.
cpm_startdate string		Start date of the range to look for power data
cpm_url string / required		This is the URL of the WTI device to send the module.
cpm_username string / required		This is the Username of the WTI device to send the module.
use_https boolean	Choices: no yes ←	Designates to use an https connection or http connection.
use_proxy boolean	Choices: no ← yes	Flag to control if the lookup will observe HTTP proxy environment variables when present.
validate_certs boolean	Choices: no yes ←	If false, SSL certificates will not be validated. This should only be used on personally controlled sites using self-signed certificates.

Notes

Note

• Use groups/cpm in module_defaults to set common options used between CPM modules.)

Examples

- name: Get the Power Information of a WTI device
  cpm_power_info:
    cpm_url: "nonexist.wti.com"
    cpm_username: "super"
    cpm_password: "super"
    use_https: true
    validate_certs: false

- name: Get the Power Information of a WTI device
  cpm_power_info:
    cpm_url: "nonexist.wti.com"
    cpm_username: "super"
    cpm_password: "super"
    use_https: false
    validate_certs: false
    startdate: 01-12-2020"
    enddate: 02-16-2020"

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key		Returned	Description
data complex		always	The output JSON returned from the commands sent
	ats string	success	Identifies if the WTI device is an ATS type of power device. Sample: 1
	outletmetering string	success	Identifies if the WTI device has Poiwer Outlet metering. Sample: 1
	plugcount string	success	Current outlet plug count of the WTI device after module execution. Sample: 8
	powerdata dictionary	success	Power data of the WTI device after module execution. Sample: [{'branch1': [{'current1': '0.00', 'current2': '0.00', 'current3': '0.00', 'current4': '0.00', 'current5': '0.00', 'current6': '0.00', 'current7': '0.00', 'current8': '0.00', 'voltage1': '118.00'}], 'timestamp': '2020-02-24T21:45:18+00:00'}]
	powerdatacount string	success	Total powerdata samples returned after module execution. Sample: 1
	powereff string	success	Power efficiency of the WTI device after module execution. Sample: 100
	powerfactor string	success	Power factor of the WTI device after module execution. Sample: 100
	powerunit string	success	Identifies if the WTI device is a power type device. Sample: 1
	status dictionary	always	Return status after module completion Sample: {'code': '0', 'text': 'OK'}
	timestamp string	success	Current timestamp of the WTI device after module execution. Sample: 2020-02-24T20:54:03+00:00

Authors

• Western Telematic Inc. (@wtinetworkgear)