You are reading an unmaintained version of the Ansible documentation. Unmaintained Ansible versions can contain unfixed security vulnerabilities (CVE). Please upgrade to a maintained version. See the latest Ansible documentation.

community.general.lxca_nodes – Custom module for lxca nodes inventory utility

Note

This plugin is part of the community.general collection (version 3.8.3).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.lxca_nodes.

Synopsis

• This module returns/displays a inventory details of nodes

Requirements

The below requirements are needed on the host that executes this module.

• pylxca

Parameters

Parameter	Comments
auth_url string / required	lxca https full web address
chassis string	uuid of chassis, this is string with length greater than 16.
command_options string	options to filter nodes information Choices: nodes ← (default) nodes_by_uuid nodes_by_chassis_uuid nodes_status_managed nodes_status_unmanaged
login_password string / required	The password for use in HTTP basic authentication.
login_user string / required	The username for use in HTTP basic authentication.
uuid string	uuid of device, this is string with length greater than 16.

Notes

Note

• Additional detail about pylxca can be found at https://github.com/lenovo/pylxca

• Playbooks using these modules can be found at https://github.com/lenovo/ansible.lenovo-lxca

• Check mode is not supported.

Examples

# get all nodes info
- name: Get nodes data from LXCA
  community.general.lxca_nodes:
    login_user: USERID
    login_password: Password
    auth_url: "https://10.243.15.168"
    command_options: nodes

# get specific nodes info by uuid
- name: Get nodes data from LXCA
  community.general.lxca_nodes:
    login_user: USERID
    login_password: Password
    auth_url: "https://10.243.15.168"
    uuid: "3C737AA5E31640CE949B10C129A8B01F"
    command_options: nodes_by_uuid

# get specific nodes info by chassis uuid
- name: Get nodes data from LXCA
  community.general.lxca_nodes:
    login_user: USERID
    login_password: Password
    auth_url: "https://10.243.15.168"
    chassis: "3C737AA5E31640CE949B10C129A8B01F"
    command_options: nodes_by_chassis_uuid

# get managed nodes
- name: Get nodes data from LXCA
  community.general.lxca_nodes:
    login_user: USERID
    login_password: Password
    auth_url: "https://10.243.15.168"
    command_options: nodes_status_managed

# get unmanaged nodes
- name: Get nodes data from LXCA
  community.general.lxca_nodes:
    login_user: USERID
    login_password: Password
    auth_url: "https://10.243.15.168"
    command_options: nodes_status_unmanaged

Return Values

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

Key	Description
result dictionary	nodes detail from lxca Returned: always Sample: {“nodeList”: [{“machineType”: “6241”, “model”: “AC1”, “type”: “Rack-TowerServer”, “uuid”: “118D2C88C8FD11E4947B6EAE8B4BDCDF”}, {“machineType”: “8871”, “model”: “AC1”, “type”: “Rack-TowerServer”, “uuid”: “223D2C88C8FD11E4947B6EAE8B4BDCDF”}]}

Authors

• Naval Patel (@navalkp)

• Prashant Bhosale (@prabhosa)