rax_mon_entity – Создание или удаление сущности Rackspace Cloud Monitoring

Новая версия 2.0.

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

Обзор

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

Требования

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

python >= 2.6
pyrax

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
agent_id -		Агент мониторинга Rackspace на целевом устройстве, к которому привязана данная сущность. Необходим для сбора `agent.` rax_mon_checks по отношению к этой сущности.
api_key -		Ключ API Rackspace, переопределяет credentials. Псевдонимы: password
auth_endpoint - добавлено в 1.5	Значение по умолчанию: "https://identity.api.rackspacecloud.com/v2.0/"	URI службы аутентификации.
credentials -		Файл для поиска учетных данных Rackspace. Игнорируется, если указаны api_key и username. Псевдонимы: creds_file
env - добавлено в 1.5		Среда, как настроено в ~/.pyrax.cfg, см. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration.
identity_type - добавлено в 1.5	Значение по умолчанию: "rackspace"	Механизм аутентификации, например, rackspace или keystone.
label - / обязательно		Определяет имя для этой сущности. Должно быть непустой строкой длиной от 1 до 255 символов.
metadata -		Хэш произвольных `name`, `value` пар, которые передаются в связанные rax_mon_alarms. Имена и значения должны быть длиной от 1 до 255 символов.
named_ip_addresses -		Хэш IP-адресов, которые могут быть сосланы по имени rax_mon_checks, добавленными к этой сущности. Должен быть словарем с ключами, которые являются именами длиной от 1 до 64 символов, и значениями, которые являются допустимыми IPv4 или IPv6 адресами.
region -	Значение по умолчанию: "DFW"	Регион для создания экземпляра.
state -	Варианты: present absent	Обеспечить, чтобы сущность с данным `name` существовала или не существовала.
tenant_id - добавлено в 1.5		Идентификатор арендатора, используемый для аутентификации.
tenant_name - добавлено в 1.5		Имя арендатора, используемое для аутентификации.
username -		Имя пользователя Rackspace, переопределяет credentials.
verify_ssl - добавлено в 1.5		Требовать ли проверку SSL для API-точек входа.

Примечания

Примечание

Следующие переменные среды могут быть использованы: 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: Entity example
  gather_facts: False
  hosts: local
  connection: local
  tasks:
  - name: Ensure an entity exists
    rax_mon_entity:
      credentials: ~/.rax_pub
      state: present
      label: my_entity
      named_ip_addresses:
        web_box: 192.0.2.4
        db_box: 192.0.2.5
      meta:
        hurf: durf
    register: the_entity

Статус

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

Авторы

Эш Уилсон (@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.7/modules/rax_mon_entity_module.html