community.grafana.grafana_user 模块 – 管理 Grafana 用户

注意

此模块是 community.grafana 集合（版本 2.1.0）的一部分。

如果您使用的是 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.grafana。

要在 playbook 中使用它，请指定：community.grafana.grafana_user。

community.grafana 1.0.0 中的新增功能

概要 

通过用户和管理员 API 创建/更新/删除 Grafana 用户。
已使用 Grafana v6.4.3 测试
目前不支持密码更新

参数 

参数	注释
client_cert 路径	用于 SSL 客户端身份验证的 PEM 格式的证书链文件。此文件还可以包括密钥，如果包括密钥，则不需要 client_key
client_key 路径	包含用于 SSL 客户端身份验证的私钥的 PEM 格式的文件。如果 client_cert 同时包含证书和密钥，则不需要此选项。
email 字符串	Grafana 用户的电子邮件。
is_admin 布尔值	Grafana 用户是否为管理员。选择 `false` ← (默认) `true`
login 字符串 / 必需	Grafana 用户的登录名。
name 字符串	Grafana 用户的名称。
password 字符串	Grafana 用户的密码。目前，此字段尚未更新。
state 字符串	用户是否应存在于 Grafana 中的状态选择 `"present"` ← (默认) `"absent"`
url 别名: grafana_url 字符串 / 必需	Grafana URL。
url_password 别名: grafana_password 字符串	用于 API 身份验证的 Grafana 密码。默认: `"admin"`
url_username 别名: grafana_user 字符串	用于 API 身份验证的 Grafana 用户。默认: `"admin"`
use_proxy 布尔值	如果 `false`，则即使目标主机上的环境变量中定义了代理，也不会使用代理。选择 `false` `true` ← (默认)
validate_certs 布尔值	如果 `false`，则不会验证 SSL 证书。此值应仅在个人控制的使用自签名证书的站点上设置为 `false`。选择 `false` `true` ← (默认)

注释 

注意

与集合中的其他模块不同，此模块不支持 grafana_api_key 身份验证类型。用于用户管理的 Grafana API 端点需要基本身份验证和管理员权限。

示例 

---
- name: Create or update a Grafana user
  community.grafana.grafana_user:
    url: "https://grafana.example.com"
    url_username: admin
    url_password: changeme
    name: "Bruce Wayne"
    email: [email protected]
    login: batman
    password: robin
    is_admin: true
    state: present

- name: Delete a Grafana user
  community.grafana.grafana_user:
    url: "https://grafana.example.com"
    url_username: admin
    url_password: changeme
    login: batman
    state: absent

返回值 

常见返回值在此处记录此处，以下是此模块独有的字段

键	描述
user 复杂	有关用户的信息返回: 当 state 为 present 时
email 字符串	用户的电子邮件地址返回: 始终示例: `"['foo.bar@example.com']"`
id 整数	用户 ID 返回: 始终示例: `[42]`
isDisabled 布尔值	Grafana 帐户状态返回: 始终示例: `[false]`
isExternal 布尔值	有关外部用户提供程序的 Grafana 帐户信息返回: 始终示例: `[false]`
isGrafanaAdmin 布尔值	Grafana 用户管理员权限返回: 始终示例: `[false]`
login 字符串	用户登录名返回: 始终示例: `"['batman']"`
orgId 整数	团队所属的组织 ID。返回: 始终示例: `[1]`
theme 字符串	Grafana 主题返回: 始终示例: `"['light']"`

作者

Antoine Tanzilli (@Tailzip)
Hong Viet LE (@pomverte)
Julien Alexandre (@jual)
Marc Cyprien (@LeFameux)