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/。 返回:成功 示例: |