On this page
manageiq_alert_profiles - Configuration of alert profiles for ManageIQ
New in version 2.5.
Synopsis
- The manageiq_alert_profiles module supports adding, updating and deleting alert profiles in ManageIQ.
Requirements
The below requirements are needed on the host that executes this module.
- manageiq-client https://github.com/ManageIQ/manageiq-api-client-python/
Parameters
| Parameter | Choices/Defaults | Comments | |
|---|---|---|---|
| alerts | 
        List of alert descriptions to assign to this profile.
        
        Required if state is "present"
        | ||
| manageiq_connection 
        required
        | 
        ManageIQ connection configuration information.
        | ||
| url 
        required
        | 
        ManageIQ environment url.  MIQ_URLenv var if set. otherwise, it is required to pass it. | ||
| username | 
        ManageIQ username.  MIQ_USERNAMEenv var if set. otherwise, required if no token is passed in. | ||
| password | 
        ManageIQ password.  MIQ_PASSWORDenv var if set. otherwise, required if no token is passed in. | ||
| token | 
        ManageIQ token.  MIQ_TOKENenv var if set. otherwise, required if no username or password is passed in. | ||
| verify_ssl | Default: 
        "yes"
        | 
        Whether SSL certificates should be verified for HTTPS requests. defaults to True.
        | |
| ca_bundle_path | 
        The path to a CA bundle file or directory with certificates. defaults to None.
        | ||
| name | 
        The unique alert profile name in ManageIQ.
        
        Required when state is "absent" or "present".
        | ||
| notes | 
        Optional notes for this profile
        | ||
| resource_type | 
 | 
        The resource type for the alert profile in ManageIQ. Required when state is "present".
        | |
| state | 
 | 
        absent - alert profile should not exist,
        
        present - alert profile should exist,
        | |
Examples
- name: Add an alert profile to ManageIQ
  manageiq_alert_profiles:
    state: present
    name: Test profile
    resource_type: ContainerNode
    alerts:
      - Test Alert 01
      - Test Alert 02
    manageiq_connection:
      url: 'http://127.0.0.1:3000'
      username: 'admin'
      password: 'smartvm'
      verify_ssl: False
- name: Delete an alert profile from ManageIQ
  manageiq_alert_profiles:
    state: absent
    name: Test profile
    manageiq_connection:
      url: 'http://127.0.0.1:3000'
      username: 'admin'
      password: 'smartvm'
      verify_ssl: False
Status
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Maintenance
This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.
For a list of other modules that are also maintained by the Ansible Community, see here.
Author
- Elad Alfassa (ealfassa@redhat.com)
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
 https://docs.ansible.com/ansible/2.6/modules/manageiq_alert_profiles_module.html