Модуль vultr.cloud.firewall_group – Управление группами брандмауэров на Vultr

Примечание

Этот модуль является частью коллекции vultr.cloud (версия 1.13.0).

Эта коллекция, возможно, уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install vultr.cloud.

Чтобы использовать её в плейбуке, укажите: vultr.cloud.firewall_group.

Новая в vultr.cloud 1.0.0

Описание
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

Создание и удаление групп брандмауэров.

Параметры

Параметр	Комментарии
api_endpoint строка	URL конечной точки API (без конечного слэша). Вспомогательная переменная окружения `VULTR_API_ENDPOINT`. По умолчанию: `"https://api.vultr.com/v2"`
api_key строка / обязательно	Ключ API Vultr API. Вспомогательная переменная окружения `VULTR_API_KEY`.
api_retries целое число	Количество попыток повторной отправки в случае, если Vultr API возвращает HTTP код ошибки, например - 429 Слишком много запросов - 500 Внутренняя ошибка сервера - 504 Чрезмерная задержка шлюза Вспомогательная переменная окружения `VULTR_API_RETRIES`. По умолчанию: `5`
api_retry_max_delay целое число	Задержка экспоненциального возврата при повторной отправке в секундах, до максимального значения. Вспомогательная переменная окружения `VULTR_API_RETRY_MAX_DELAY`. По умолчанию: `12`
api_timeout целое число	Таймаут HTTP-запроса к Vultr API. Вспомогательная переменная окружения `VULTR_API_TIMEOUT`. По умолчанию: `180`
description псевдонимы: name строка / обязательно	Описание группы брандмауэров.
state строка	Состояние группы брандмауэров. Варианты: `"present"` ← (по умолчанию) `"absent"`
validate_certs логическое значение	Проверять SSL-сертификаты Vultr API. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Также см. документацию API по https://www.vultr.com/api/.

Примеры

- name: ensure a firewall group is present
  vultr.cloud.firewall_group:
    description: my http firewall.

- name: ensure a firewall group is absent
  vultr.cloud.firewall_group:
    description: my http firewall.
    state: absent

Значения возврата

Общие значения возврата документированы здесь, следующие являются полями, уникальными для данного модуля:

Ключ	Описание
vultr_api словарь	Ответ от API Vultr с некоторыми дополнениями/изменениями. Возвращено: успех
api_endpoint строка	Точка входа, используемая для запросов API. Возвращено: успех Пример: `"https://api.vultr.com/v2"`
api_retries целое число	Количество максимальных попыток повторных запросов API. Возвращено: успех Пример: `5`
api_retry_max_delay целое число	Задержка экспоненциального возврата в секундах между повторными попытками до этой максимальной задержки. Возвращено: успех Пример: `12`
api_timeout целое число	Таймаут, используемый для запросов API. Возвращено: успех Пример: `60`
vultr_firewall_group словарь	Ответ от API Vultr. Возвращено: успех
date_created строка	Дата создания группы правил брандмауэра. Возвращено: успех Пример: `"2020-10-10T01:56:20+00:00"`
date_modified строка	Дата изменения группы правил брандмауэра. Возвращено: успех Пример: `"2020-10-10T01:56:20+00:00"`
description строка	Описание (имя) группы правил брандмауэра Возвращено: успех Пример: `"my firewall group"`
id строка	Идентификатор группы правил брандмауэра. Возвращено: успех Пример: `"cb676a46-66fd-4dfb-b839-443f2e6c0b60"`

Авторы

René Moser (@resmo)

Ссылки на сборку

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/vultr/cloud/firewall_group_module.html