# salt.states.grafana4_org

Manage Grafana v4.0 orgs

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 org is present:
      grafana4_org.present:
        - name: foobar
        - theme:  ""
        - home_dashboard_id: 0
        - timezone: "utc"
        - address1: ""
        - address2: ""
        - city: ""
        - zip_code: ""
        - state: ""
        - country: ""

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

  Ensure that a org is present.

  name

    Name of the org to remove.

  profile

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

salt.states.grafana4_org.present(name, users=None, theme=None, home_dashboard_id=None, timezone=None, address1=None, address2=None, city=None, zip_code=None, address_state=None, country=None, profile='grafana')

  Ensure that an organization is present.

  name

    Name of the org.

  users

    Optional - Dict of user/role associated with the org. Example:

        users:
          foo: Viewer
          bar: Editor

  theme

    Optional - Selected theme for the org.

  home_dashboard_id

    Optional - Home dashboard for the org.

  timezone

    Optional - Timezone for the org (one of: "browser", "utc", or "").

  address1

    Optional - address1 of the org.

  address2

    Optional - address2 of the org.

  city

    Optional - city of the org.

  zip_code

    Optional - zip_code of the org.

  address_state

    Optional - state of the org.

  country

    Optional - country of the org.

  profile

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