/ home / tribe29 / tribe29.checkmk / 0.23.0 / module / service_group

tribe29.checkmk.service_group (0.23.0) — module

Manage service groups in Checkmk (bulk version).

| "added in version" 0.12.0 of tribe29.checkmk"

Authors: Michael Sekania (@msekania)

Install collection

Install with ansible-galaxy collection install tribe29.checkmk:==0.23.0

Add to requirements.yml

  collections:
    - name: tribe29.checkmk
      version: 0.23.0

Description

Manage service groups in Checkmk.

Usage examples

Scanned by Steampunk Spotter

# Create a single service group.
- name: "Create a single service group."
  tribe29.checkmk.service_group:
    server_url: "http://localhost/"
    site: "my_site"
    automation_user: "automation"
    automation_secret: "$SECRET"
    name: "my_service_group"
    title: "My Service Group"
    state: "present"

Scanned by Steampunk Spotter

# Create several service groups.
- name: "Create several service groups."
  tribe29.checkmk.service_group:
    server_url: "http://localhost/"
    site: "my_site"
    automation_user: "automation"
    automation_secret: "$SECRET"
    groups:
      - name: "my_service_group_one"
        title: "My Service Group One"
      - name: "my_service_group_two"
        title: "My Service Group Two"
      - name: "my_service_group_test"
        title: "My Test"
    state: "present"

Scanned by Steampunk Spotter

# Create several service groups.
- name: "Create several service groups."
  tribe29.checkmk.service_group:
    server_url: "http://localhost/"
    site: "my_site"
    automation_user: "automation"
    automation_secret: "$SECRET"
    groups:
      - name: "my_service_group_one"
        title: "My Service Group One"
      - name: "my_service_group_two"
      - name: "my_service_group_test"
    state: "present"

Scanned by Steampunk Spotter

# Delete a single service group.
- name: "Create a single service group."
  tribe29.checkmk.service_group:
    server_url: "http://localhost/"
    site: "my_site"
    automation_user: "automation"
    automation_secret: "$SECRET"
    name: "my_service_group"
    state: "absent"

Scanned by Steampunk Spotter

# Delete several service groups.
- name: "Delete several service groups."
  tribe29.checkmk.service_group:
    server_url: "http://localhost/"
    site: "my_site"
    automation_user: "automation"
    automation_secret: "$SECRET"
    groups:
      - name: "my_service_group_one"
      - name: "my_service_group_two"
    state: "absent"

Inputs

    
name:
    description: The name of the service group to be created/modified/deleted.
    type: str

site:
    description: The site you want to connect to.
    required: true
    type: str

state:
    choices:
    - present
    - absent
    default: present
    description: The state of your service group.
    type: str

title:
    description: The title (alias) of your service group. If omitted defaults to the name.
    type: str

groups:
    default: []
    description:
    - instead of 'name', 'title' a list of dicts with elements of service group name and
      title (alias) to be created/modified/deleted. If title is omitted in entry, it defaults
      to the service group name.
    type: raw

server_url:
    description: The base url of your Checkmk server.
    required: true
    type: str

validate_certs:
    default: true
    description: Whether to validate the SSL certificate of the Checkmk server.
    type: bool

automation_user:
    description: The automation user you want to use. It has to be an 'Automation' user,
      not a normal one.
    required: true
    type: str

automation_secret:
    description: The secret to authenticate your automation user.
    required: true
    type: str

Outputs

message:
  description: The output message that the module generates.
  returned: always
  sample: Service group created.
  type: str