vr_firewall_group — Управление группами брандмауэров на Vultr.
Новая версия 2.5.
Описание
- Создание и удаление групп брандмауэров.
Требования
Ниже приведены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_account | По умолчанию: "default" | Имя раздела ini в файле vultr.ini.Переменная среды VULTR_API_ACCOUNT используется в качестве значения по умолчанию, если она определена. |
| api_endpoint | По умолчанию: "https://api.vultr.com" | URL конечной точки API (без конечной косой черты). Переменная среды VULTR_API_ENDPOINT используется в качестве значения по умолчанию, если она определена. |
| api_key | Ключ API для API Vultr. Переменная среды VULTR_API_KEY используется в качестве значения по умолчанию, если она определена. | |
| api_retries | По умолчанию: 5 | Количество попыток в случае, если API Vultr возвращает код HTTP 503. Переменная среды VULTR_API_RETRIES используется в качестве значения по умолчанию, если она определена. |
| api_timeout | По умолчанию: 60 | Таймаут HTTP-запросов к API Vultr. Переменная среды VULTR_API_TIMEOUT используется в качестве значения по умолчанию, если она определена. |
| name обязательно | Имя группы брандмауэра. псевдонимы: описание | |
| state |
| Состояние группы брандмауэра. |
| validate_certs bool |
| Проверка SSL-сертификатов API Vultr. |
Примечания
Примечание
- Также см. документацию API по адресу https://www.vultr.com/api/.
Примеры
- name: ensure a firewall group is present
local_action:
module: vr_firewall_group
name: my http firewall
- name: ensure a firewall group is absent
local_action:
module: vr_firewall_group
name: my http firewall
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| vultr_api сложное | success | Ответ от API Vultr с несколькими добавленными/изменёнными полями | |
| api_account строка | success | Аккаунт, используемый в файле ini для выбора ключа Пример: default | |
| api_timeout целое число | success | Таймаут, используемый для запросов к API Пример: 60 | |
| api_retries целое число | success | Максимальное количество попыток для запросов к API Пример: 5 | |
| api_endpoint строка | success | Конечная точка, используемая для запросов к API Пример: https://api.vultr.com | |
| vultr_firewall_group сложное | success | Ответ от API Vultr | |
| id строка | success | ID группы брандмауэра Пример: 1234abcd | |
| name строка | success | Имя группы брандмауэра Пример: моя группа брандмауэра | |
| date_created строка | success | Дата создания группы брандмауэра Пример: 2017-08-26 12:47:48 | |
| date_modified строка | success | Дата изменения группы брандмауэра Пример: 2017-08-26 12:47:48 | |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратной совместимый.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что его поддерживает сообщество Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, поддерживаемых сообществом Ansible, см. здесь.
Автор
- René Moser (@resmo)
Подсказка
Если вы заметили какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/vr_firewall_group_module.html
