Модуль hetzner.hcloud.firewall_resource — управление ресурсами, к которым применяется брандмауэр Hetzner Cloud.

Примечание

Этот модуль входит в коллекцию hetzner.hcloud (версия 6.9.0).

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

Чтобы установить коллекцию, используйте: ansible-galaxy collection install hetzner.hcloud. Для использования этого модуля могут потребоваться дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: hetzner.hcloud.firewall_resource.

Добавлено в hetzner.hcloud 2.5.0

Краткое описание
Требования
Параметры
См. также
Примеры
Возвращаемые значения

Краткое описание

Добавление и удаление ресурсов, к которым применяется брандмауэр Hetzner Cloud.

Псевдонимы: hcloud_firewall_resource

Требования

Следующие компоненты должны быть установлены на узле, на котором выполняется этот модуль.

python-dateutil >= 2.7.5
requests >=2.20

Параметры

Параметр	Комментарии
api_endpoint псевдонимы: endpoint string	Конечная точка API Hetzner Cloud. Этот параметр также можно задать с помощью переменной окружения `HCLOUD_ENDPOINT`. По умолчанию: `"https://api.hetzner.cloud/v1"`
api_endpoint_hetzner string	Конечная точка API Hetzner. Этот параметр также можно задать с помощью переменной окружения `HETZNER_ENDPOINT`. По умолчанию: `"https://api.hetzner.com/v1"`
api_token string / обязательный	Токен API Hetzner Cloud. Этот параметр также можно задать с помощью переменной окружения `HCLOUD_TOKEN`.
firewall string / обязательный	Имя или ID брандмауэра Hetzner Cloud.
label_selectors list / элементы=string	Список селекторов меток.
servers list / элементы=string	Список имён или ID серверов.
state string	Состояние ресурсов брандмауэра. Варианты: `"absent"` `"present"` ← (по умолчанию)

См. также

Документация по API Hetzner: Полный справочник по API Hetzner.

Примеры

- name: Apply a firewall to a list of servers
  hetzner.hcloud.firewall_resource:
    firewall: my-firewall
    servers:
      - my-server
      - 3456789
    state: present

- name: Remove a firewall from a list of servers
  hetzner.hcloud.firewall_resource:
    firewall: my-firewall
    servers:
      - my-server
      - 3456789
    state: absent

- name: Apply a firewall to resources using label selectors
  hetzner.hcloud.firewall_resource:
    firewall: my-firewall
    label_selectors:
      - env=prod
    state: present

- name: Remove a firewall from resources using label selectors
  hetzner.hcloud.firewall_resource:
    firewall: my-firewall
    label_selectors:
      - env=prod
    state: absent

Возвращаемые значения

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

Ключ	Описание
hcloud_firewall_resource dictionary	Ресурсы, к которым применяется брандмауэр Hetzner Cloud. Возвращается: всегда
firewall string	Имя брандмауэра Hetzner Cloud. Возвращается: при успехе Пример: `"my-firewall"`
label_selectors list / элементы=string	Список селекторов меток. Возвращается: при успехе Пример: `["env=prod"]`
servers list / элементы=string	Список имён серверов. Возвращается: при успехе Пример: `["my-server1", "my-server2"]`

Авторы

Jonas Lammler (@jooola)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/hetzner/hcloud/firewall_resource_module.html