rax_mon_notification – Создание или удаление уведомления Rackspace Cloud Monitoring

Описание
Требования
Параметры
Примечания
Примеры
Статус

Описание

Создание или удаление уведомления Rackspace Cloud Monitoring, которое определяет канал для связи об оповещениях, таких как электронная почта, веб-хуки или PagerDuty. Поток модуля мониторинга Rackspace | rax_mon_entity -> rax_mon_check -> rax_mon_notification -> rax_mon_notification_plan -> rax_mon_alarm

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

python >= 2.6
pyrax

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_key -		Ключ API Rackspace, переопределяет credentials. псевдонимы: пароль
auth_endpoint -	По умолчанию: "https://identity.api.rackspacecloud.com/v2.0/"	URI службы аутентификации.
credentials -		Файл для поиска учетных данных Rackspace. Игнорируется, если предоставлены api_key и username. псевдонимы: creds_file
details - / обязательно		Словарь пар ключ-значение, используемых для инициализации уведомления. Требуемые ключи и их значения зависят от типа уведомления. Подробнее см. http://docs.rackspace.com/cm/api/v1.0/cm-devguide/content/ service-notification-types-crud.html
env -		Окружение, как настроено в ~/.pyrax.cfg, см. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration.
identity_type -	По умолчанию: "rackspace"	Механизм аутентификации, такой как rackspace или keystone.
label - / обязательно		Определяет понятное имя для этого уведомления. Строка длиной от 1 до 255 символов.
notification_type - / обязательно	Варианты: webhook электронная почта pagerduty	Поддерживаемый тип уведомления.
region -	По умолчанию: "DFW"	Регион для создания экземпляра.
state -	Варианты: present absent	Обеспечить, чтобы уведомление с этим `label` существовало или не существовало.
tenant_id -		Идентификатор клиента, используемый для аутентификации.
tenant_name -		Имя клиента, используемое для аутентификации.
username -		Имя пользователя Rackspace, переопределяет credentials.
validate_certs boolean	Варианты: no yes	Требовать или нет проверку SSL API-точек входа. псевдонимы: verify_ssl

Примечания

Примечание

Можно использовать следующие переменные окружения: RAX_USERNAME, RAX_API_KEY, RAX_CREDS_FILE, RAX_CREDENTIALS, RAX_REGION.
RAX_CREDENTIALS и RAX_CREDS_FILE указывают на файл учетных данных, соответствующий pyrax. См. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#authenticating
RAX_USERNAME и RAX_API_KEY исключают использование файла учетных данных
RAX_REGION определяет регион Rackspace Public Cloud (DFW, ORD, LON, …)

Примеры

- name: Monitoring notification example
  gather_facts: False
  hosts: local
  connection: local
  tasks:
  - name: Email me when something goes wrong.
    rax_mon_entity:
      credentials: ~/.rax_pub
      label: omg
      type: email
      details:
        address: me@mailhost.com
    register: the_notification

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Ash Wilson (@smashwilson)

Подсказка

Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/rax_mon_notification_module.html