community.general.pritunl_user_info – List Pritunl Users using the Pritunl API
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.pritunl_user_info
.
New in version 2.3.0: of community.general
Parameters
Parameter |
Comments |
---|---|
The name of the organization the user is part of. |
|
API Secret found in Administrators > USERNAME > API Secret. |
|
API Token of a Pritunl admin user. It needs to be enabled in Administrators > USERNAME > Enable Token Authentication. |
|
URL and port of the Pritunl server on which the API is enabled. |
|
Name of the user to filter on Pritunl. |
|
Type of the user user_name. Choices:
|
|
If certificates should be validated or not. This should never be set to Choices:
|
Examples
- name: List all existing users part of the organization MyOrg
community.general.pritunl_user_info:
state: list
organization: MyOrg
- name: Search for the user named Florian part of the organization MyOrg
community.general.pritunl_user_info:
state: list
organization: MyOrg
user_name: Florian
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
List of Pritunl users. Returned: success Sample: [{“audit”: false, “auth_type”: “google”, “bypass_secondary”: false, “client_to_client”: false, “disabled”: false, “dns_mapping”: null, “dns_servers”: null, “dns_suffix”: null, “email”: “foo@bar.com”, “gravatar”: true, “groups”: [“foo”, “bar”], “id”: “5d070dafe63q3b2e6s472c3b”, “name”: “foo@acme.com”, “network_links”: [], “organization”: “58070daee6sf342e6e4s2c36”, “organization_name”: “Acme”, “otp_auth”: true, “otp_secret”: “35H5EJA3XB2$4CWG”, “pin”: false, “port_forwarding”: [], “servers”: []}] |
Authors
Florian Dambrine (@Lowess)