# salt.states.grafana4_user

Manage Grafana v4.0 users

Added in version 2017.7.0.

configuration:

  This state requires a configuration profile to be configured in the minion config, minion pillar, or master config. The module will use the 'grafana' key by default, if defined.

  Example configuration using basic authentication:

      grafana:
        grafana_url: http://grafana.localhost
        grafana_user: admin
        grafana_password: admin
        grafana_timeout: 3

  Example configuration using token based authentication:

      grafana:
        grafana_url: http://grafana.localhost
        grafana_token: token
        grafana_timeout: 3

    Ensure foobar user is present:
      grafana4_user.present:
        - name: foobar
        - password: mypass
        - email: "foobar@localhost"
        - fullname: Foo Bar
        - is_admin: true

salt.states.grafana4_user.absent(name, profile='grafana')

  Ensure that a user is present.

  name

    Name of the user to remove.

  profile

    Configuration profile used to connect to the Grafana instance. Default is 'grafana'.

salt.states.grafana4_user.present(name, password, email, is_admin=False, fullname=None, theme=None, profile='grafana')

  Ensure that a user is present.

  name

    Name of the user.

  password

    Password of the user.

  email

    Email of the user.

  is_admin

    Optional - Set user as admin user. Default: False

  fullname

    Optional - Full name of the user.

  theme

    Optional - Selected theme of the user.

  profile

    Configuration profile used to connect to the Grafana instance. Default is 'grafana'.