community.general.online_user_info 模块 – 收集在线用户信息
注意
此模块是 community.general 集合 (版本 10.1.0) 的一部分。
如果您使用的是 ansible
软件包,则可能已安装此集合。它不包含在 ansible-core
中。要检查它是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用:ansible-galaxy collection install community.general
。
要在剧本中使用它,请指定:community.general.online_user_info
。
概要
收集有关用户的信息。
参数
参数 |
注释 |
---|---|
在线 API 的 HTTP 超时时间(秒)。 默认值: |
|
在线 OAuth 令牌。 |
|
在线 API URL。 默认值: |
|
验证在线 API 的 SSL 证书。 选项
|
属性
属性 |
支持 |
描述 |
---|---|---|
支持:完全支持 此操作不会修改状态。 |
可以在 |
|
支持: N/A 此操作不会修改状态。 |
在差异模式下,将返回有关已更改内容(或可能需要在 |
备注
注意
另请参阅 https://console.online.net/en/api/ 上的 API 文档。
如果模块中未设置
api_token
,则可以按优先级递减的顺序使用以下环境变量ONLINE_TOKEN
,ONLINE_API_KEY
,ONLINE_OAUTH_TOKEN
,ONLINE_API_TOKEN
。如果要使用不同的
api_url
,还可以设置ONLINE_API_URL
环境变量。
示例
- name: Gather Online user info
community.general.online_user_info:
register: result
- ansible.builtin.debug:
msg: "{{ result.online_user_info }}"
返回值
常见的返回值已在 此处 记录,以下是此模块独有的字段
键 |
描述 |
---|---|
来自在线 API 的响应。 更多详情请参考:https://console.online.net/en/api/。 返回:成功 示例: |