online_user_facts – Gather facts about Online user
New in version 2.7.
Synopsis
- Gather facts about the user.
Parameters
| Parameter | Choices/Defaults | Comments |
|---|---|---|
| api_timeout
integer
|
Default:
30
|
HTTP timeout to Online API in seconds.
aliases: timeout |
| api_token
string
|
Online OAuth token.
aliases: oauth_token |
|
| api_url
string
|
Default:
"https://api.online.net"
|
Online API URL
aliases: base_url |
| validate_certs
boolean
|
|
Validate SSL certs of the Online API.
|
Notes
Note
- Also see the API documentation on https://console.online.net/en/api/
- If
api_tokenis not set within the module, the following environment variables can be used in decreasing order of precedenceONLINE_TOKEN,ONLINE_API_KEY,ONLINE_OAUTH_TOKEN,ONLINE_API_TOKEN - If one wants to use a different
api_urlone can also set theONLINE_API_URLenvironment variable.
Examples
- name: Gather Online user facts
online_user_facts:
Return Values
Common return values are documented here, the following are the fields unique to this module:
| Key | Returned | Description |
|---|---|---|
| online_user_facts
complex
|
success |
Response from Online API
Sample:
{'online_user_facts': {'company': 'foobar LLC', 'email': 'foobar@example.com', 'first_name': 'foo', 'id': 42, 'last_name': 'bar', 'login': 'foobar'}}
|
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Remy Leone (@sieben)
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/online_user_facts_module.html