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. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.

Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.

Автор

Ash Wilson

Подсказка

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

© 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/rax_mon_entity_module.html