Модуль community.proxmox.proxmox_node_network_info — получение сведений о сетевых интерфейсах узлов Proxmox VE
Примечание
Этот модуль входит в коллекцию community.proxmox (версия 1.6.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install community.proxmox. Для использования этого модуля могут потребоваться дополнительные компоненты. Подробнее см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: community.proxmox.proxmox_node_network_info.
Добавлено в community.proxmox 1.4.0
Краткое описание
- Получение сведений о сетевых интерфейсах узлов Proxmox VE.
- Этот модуль не вносит изменений в систему.
Требования
Следующие компоненты необходимы на узле, где выполняется этот модуль.
- proxmoxer >= 2.0
- requests
Параметры
Параметр | Комментарии |
|---|---|
api_host string / обязательный | Укажите целевой узел кластера Proxmox VE. Если параметр не указан, используется переменная окружения |
api_password string | Укажите пароль для аутентификации. Если параметр не указан, используется переменная окружения |
api_port integer | Укажите целевой порт кластера Proxmox VE. Если параметр не указан, используется переменная окружения |
api_timeout integer | Ограничение по времени для запросов к API Proxmox VE. По умолчанию: |
api_token_id string | Укажите идентификатор токена. Если параметр не указан, используется переменная окружения |
api_token_secret string | Укажите секретный ключ токена. Если параметр не указан, используется переменная окружения |
api_user string / обязательный | Укажите пользователя для аутентификации. Если параметр не указан, используется переменная окружения |
ca_path path | Путь к локальному сертификату, который будет использоваться для проверки TLS-соединений. Игнорируется, если |
check_changes boolean | Проверять ли наличие ожидающих применения изменений конфигурации сети. Если параметр включён, модуль возвращает только сведения о подготовленных изменениях, ожидающих применения. Если параметр отключён (по умолчанию), модуль возвращает сведения о сетевых интерфейсах. Этот параметр нельзя использовать одновременно с параметрами Варианты:
|
iface string | Имя сетевого интерфейса, сведения о котором нужно получить. Если параметр не указан, возвращаются сведения обо всех интерфейсах. |
iface_type string | Фильтровать результаты по типу интерфейса. Варианты:
|
node string / обязательный | Узел Proxmox, сведения о сетевых интерфейсах которого нужно получить. |
validate_certs boolean | Проверять TLS-сертификаты, используемые для подключения к API Proxmox VE. В настоящее время значение по умолчанию — Если параметр не указан, используется переменная окружения Варианты:
|
Атрибуты
Атрибут | Поддержка | Описание |
|---|---|---|
action_group | Группа действий: community.proxmox.proxmox | Используйте |
check_mode | Поддержка: полная Режим проверки поддерживается полностью. | Модуль может выполняться в режиме |
diff_mode | Поддержка: нет Это информационный модуль, который не вносит изменений. | В режиме diff будут возвращены сведения об изменениях (или о возможных изменениях в |
См. также
См. также
- community.proxmox.proxmox_node_network
-
Управление сетевыми интерфейсами узлов Proxmox.
- Настройка сети Proxmox
-
Документация по настройке сети Proxmox VE.
- Документация API Proxmox
-
Документация API Proxmox VE.
Примеры
- name: Get all network interfaces on a node
community.proxmox.proxmox_node_network_info:
api_host: proxmox.example.com
api_user: root@pam
api_password: secret
node: pve01
- name: Get information about a specific network interface
community.proxmox.proxmox_node_network_info:
api_host: proxmox.example.com
api_user: root@pam
api_password: secret
node: pve01
iface: vmbr0
- name: Get all bridge interfaces on a node
community.proxmox.proxmox_node_network_info:
api_host: proxmox.example.com
api_user: root@pam
api_password: secret
node: pve01
iface_type: bridge
- name: Check only for pending changes
community.proxmox.proxmox_node_network_info:
api_host: proxmox.example.com
api_user: root@pam
api_password: secret
node: pve01
check_changes: true
Возвращаемые значения
Общие возвращаемые значения описаны здесь. Ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
has_pending_changes boolean | Наличие ожидающих применения изменений конфигурации сети Возвращается: при успешном выполнении, если check_changes имеет значение true Пример: |
pending_changes string | Ожидающие применения изменения конфигурации сети Возвращается: при успешном выполнении, если check_changes имеет значение true Пример: |
proxmox_node_networks list / элементы=dictionary | Список сетевых интерфейсов узла Возвращается: при успешном выполнении, если check_changes имеет значение false или не указан Пример: |
Ссылки на коллекцию
© 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/community/proxmox/proxmox_node_network_info_module.html