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. псевдонимы: пароль | ||
| 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 символов, и значениями, являющимися допустимыми IP-адресами IPv4 или IPv6. | ||
| region | нет | DFW | Регион для создания экземпляра. | |
| state | нет |
| Обеспечить, чтобы сущность с этим name существовала или не существовала. | |
| tenant_id (добавлено в 1.5)
| нет | Идентификатор клиента, используемый для аутентификации. | ||
| tenant_name (добавлено в 1.5)
| нет | Имя клиента, используемое для аутентификации. | ||
| username | нет | Имя пользователя Rackspace, переопределяет credentials. | ||
| verify_ssl (добавлено в 1.5)
| нет | Требовать или нет валидацию SSL API-точек доступа. |
Примеры
- 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
Примечания
Примечание
- Следующие переменные среды могут быть использованы,
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, ...)
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Для получения помощи в разработке модулей, если вы этого пожелаете, пожалуйста, ознакомьтесь с Информация о сообществе и вклад, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/rax_mon_entity_module.html