Модуль community.general.spectrum_device — создание и удаление устройств в CA Spectrum

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

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

Для установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать коллекцию в плейбуке, укажите: community.general.spectrum_device.

Краткое описание
Параметры
Атрибуты
Примечания
Примеры
Возвращаемые значения

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

Этот модуль позволяет создавать и удалять устройства в CA Spectrum https://www.ca.com/us/products/ca-spectrum.html.
Проверено на CA Spectrum 9.4.2, 10.1.1 и 10.2.1.

Параметры

Параметр	Комментарии
agentport integer	UDP-порт, используемый для обнаружения SNMP. По умолчанию: `161`
community string / обязательный	SNMP community, используемая для обнаружения устройства. Обязательный параметр, если `state=present`.
device псевдонимы: host, name string / обязательный	IP-адрес устройства. Если указано имя хоста, оно преобразуется в IP-адрес.
landscape string / обязательный	Идентификатор landscape SpectroServer, в который нужно добавить устройство или из которого его нужно удалить.
state string	При значении `present` создает устройство, если оно не существует. При значении `absent` удаляет устройство, если оно существует. Варианты: `"present"` ← (по умолчанию) `"absent"`
url псевдонимы: oneclick_url string / обязательный	URL сервера Oneclick по HTTP или HTTPS в формате `(http\|https)://host.domain[:port]`.
url_password псевдонимы: oneclick_password string / обязательный	Пароль пользователя Oneclick.
url_username псевдонимы: oneclick_user string / обязательный	Имя пользователя Oneclick.
use_proxy boolean	Если `false`, прокси не используется, даже если он задан в переменной окружения на целевых узлах. Варианты: `false` `true` ← (по умолчанию)
validate_certs boolean	Если `false`, сертификаты SSL не проверяются. Этот параметр следует использовать только на подконтрольных вам сайтах с самоподписанными сертификатами. Варианты: `false` `true` ← (по умолчанию)

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может выполняться в режиме `check_mode` и возвращать прогноз изменения статуса, не изменяя целевой объект.
diff_mode	Поддержка: отсутствует	В режиме diff возвращает сведения об изменениях (или возможных изменениях в `check_mode`).

Примечания

Примечание

Устройства создаются в контейнере Universe указанного landscape.
Все операции выполняются только в указанном landscape.

Примеры

- name: Add device to CA Spectrum
  local_action:
    module: spectrum_device
    device: '{{ ansible_host }}'
    community: secret
    landscape: '0x100000'
    oneclick_url: http://oneclick.example.com:8080
    oneclick_user: username
    oneclick_password: password
    state: present


- name: Remove device from CA Spectrum
  local_action:
    module: spectrum_device
    device: '{{ ansible_host }}'
    landscape: '{{ landscape_handle }}'
    oneclick_url: http://oneclick.example.com:8080
    oneclick_user: username
    oneclick_password: password
    use_proxy: false
    state: absent

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

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

Ключ	Описание
device dictionary	Данные устройства, если `state=present`. Возвращается: при успешном выполнении Пример: `{"address": "10.10.5.1", "landscape": "0x100000", "model_handle": "0x1007ab"}`

Авторы

Renato Orgito (@orgito)

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

© 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/general/spectrum_device_module.html