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_URL env var if set. otherwise, it is required to pass it.
        | 
     ||
| username | 
        
        ManageIQ username.  MIQ_USERNAME env var if set. otherwise, required if no token is passed in.
        | 
     ||
| password | 
        
        ManageIQ password.  MIQ_PASSWORD env var if set. otherwise, required if no token is passed in.
        | 
     ||
| token | 
        
        ManageIQ token.  MIQ_TOKEN env 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