Модуль community.proxmox.proxmox_firewall_info — управление правилами брандмауэра в Proxmox

api_host

string / обязательный

Укажите целевой хост кластера Proxmox VE.

Если параметр не указан, используется переменная среды PROXMOX_HOST.

api_password

string

Укажите пароль для аутентификации.

Если параметр не указан, используется переменная среды PROXMOX_PASSWORD.

api_port

integer

Укажите целевой порт кластера Proxmox VE.

Если параметр не указан, используется переменная среды PROXMOX_PORT.

api_timeout

integer

Ограничение времени для запросов к API Proxmox VE.

По умолчанию: 5

api_token_id

string

Укажите идентификатор токена.

Если параметр не указан, используется переменная среды PROXMOX_TOKEN_ID.

api_token_secret

string

Укажите секрет токена.

Если параметр не указан, используется переменная среды PROXMOX_TOKEN_SECRET.

api_user

string / обязательный

Укажите пользователя для аутентификации.

Если параметр не указан, используется переменная среды PROXMOX_USER.

ca_path

path

Путь к локальному сертификату, который будет использоваться для проверки TLS-соединений.

Игнорируется, если validate_certs=false.

group

string

Имя группы, которой принадлежит правило.

Требуется только, если level=group.

level

string

Уровень, на котором применяется правило брандмауэра.

Варианты:

• "cluster" ← (по умолчанию)
• "group"
• "vnet"
• "node"
• "vm"

node

string

Имя узла.

Требуется только, если level=node.

pos

integer

Позиция правила в списке.

validate_certs

boolean

Проверять TLS-сертификаты, используемые для подключения к API Proxmox VE.

В настоящее время значение по умолчанию — false; в community.proxmox 2.0.0 значение по умолчанию изменится на true.

Если параметр не указан, используется переменная среды PROXMOX_VALIDATE_CERTS.

Варианты:

• false
• true

vmid

integer

Идентификатор ВМ, к которой применяется правило.

Требуется только, если level=vm.

vnet

string

Имя виртуальной сети для правила.

Требуется только, если level=vnet.

action_group

Группа действий: community.proxmox.proxmox

Используйте group/community.proxmox.proxmox в module_defaults, чтобы задать значения по умолчанию для этого модуля.

check_mode

Поддержка: полная

Это действие не изменяет состояние.

Может выполняться в режиме check_mode и возвращать прогноз статуса изменений, не изменяя целевой объект.

diff_mode

Поддержка: Н/Д

Это действие не изменяет состояние.

В режиме diff будут возвращены сведения об изменениях (или о том, что, возможно, требуется изменить в check_mode).

aliases

list / elements=dictionary

Список псевдонимов на заданном уровне.

Псевдонимы доступны только на уровне кластера и ВМ, поэтому для любого другого уровня возвращается пустой список.

Возвращается: при успехе

Пример: [{"cidr": "10.10.1.0/24", "digest": "978391f460484e8d4fb3ca785cfe5a9d16fe8b1f", "ipversion": 4, "name": "test1"}, {"cidr": "10.10.2.0/24", "digest": "978391f460484e8d4fb3ca785cfe5a9d16fe8b1f", "ipversion": 4, "name": "test2"}, {"cidr": "10.10.3.0/24", "digest": "978391f460484e8d4fb3ca785cfe5a9d16fe8b1f", "ipversion": 4, "name": "test3"}]

firewall_rules

list / elements=dictionary

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

Возвращается: при успехе

Пример: [{"action": "ACCEPT", "digest": "b5ddaed23b415b9368706fc9edc83d037526aae9", "dport": "53", "enable": 1, "ipversion": 4, "log": "nolog", "pos": 0, "proto": "udp", "source": "192.168.1.0/24", "type": "in"}, {"action": "ACCEPT", "digest": "b5ddaed23b415b9368706fc9edc83d037526aae9", "dport": "53", "enable": 1, "ipversion": 4, "log": "nolog", "pos": 1, "proto": "tcp", "source": "192.168.1.0/24", "type": "in"}, {"action": "ACCEPT", "dest": "192.168.1.0/24", "digest": "b5ddaed23b415b9368706fc9edc83d037526aae9", "enable": 1, "ipversion": 4, "log": "nolog", "pos": 2, "type": "out"}, {"action": "ACCEPT", "digest": "b5ddaed23b415b9368706fc9edc83d037526aae9", "enable": 1, "ipversion": 4, "log": "nolog", "pos": 3, "source": "192.168.1.0/24", "type": "in"}, {"action": "ACCEPT", "dest": "+sdn/test2-gateway", "digest": "b5ddaed23b415b9368706fc9edc83d037526aae9", "enable": 1, "iface": "test2", "log": "nolog", "macro": "DNS", "pos": 4, "type": "in"}, {"action": "ACCEPT", "digest": "b5ddaed23b415b9368706fc9edc83d037526aae9", "enable": 1, "iface": "test2", "log": "nolog", "macro": "DHCPfwd", "pos": 5, "type": "in"}, {"action": "ACCEPT", "dest": "+sdn/test2-all", "digest": "b5ddaed23b415b9368706fc9edc83d037526aae9", "dport": "68", "enable": 1, "log": "nolog", "pos": 6, "proto": "udp", "source": "+sdn/test2-gateway", "sport": "67", "type": "out"}, {"action": "DROP", "digest": "b5ddaed23b415b9368706fc9edc83d037526aae9", "enable": 1, "log": "nolog", "pos": 7, "type": "in"}, {"action": "DROP", "digest": "b5ddaed23b415b9368706fc9edc83d037526aae9", "enable": 1, "log": "nolog", "pos": 8, "type": "out"}]

groups

list / elements=string

Список групп безопасности брандмауэра.

Этот список всегда возвращается для уровня кластера независимо от переданного уровня.

Группы безопасности брандмауэра доступны только на уровне кластера.

Возвращается: при успехе

Пример: ["test"]

ip_sets

list / elements=dictionary

Список наборов IP-адресов.

Поддерживаются только для level = cluster; другие входные данные игнорируются.

Возвращается: при успехе

Пример: [{"cidrs": [], "digest": "8c4a5e793355b2a877659315faaa78cbd0bc9f6c", "name": "emptytest"}, {"cidrs": [{"cidr": "192.168.1.10", "comment": "Proxmox pve-01", "digest": "ed830373d096f6b9f868e59c6182e0b2042e6bad", "nomatch": false}, {"cidr": "192.168.1.11", "comment": "Proxmox pve-02", "digest": "ed830373d096f6b9f868e59c6182e0b2042e6bad", "nomatch": true}], "comment": "PVE hosts", "digest": "8c4a5e793355b2a877659315faaa78cbd0bc9f6c", "name": "hypervisors"}, {"cidrs": [{"cidr": "10.10.1.0", "comment": "Proxmox pve-01", "digest": "f15cef67632375227d849ee0a449d845ab136677", "nomatch": false}], "comment": "PVE hosts", "digest": "8c4a5e793355b2a877659315faaa78cbd0bc9f6c", "name": "test"}]