netbox_device – Создание, обновление или удаление устройств в Netbox

Новая в версии 2.8.

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

Описание

Создает, обновляет или удаляет устройства из Netbox

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

pynetbox

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
data - / обязательно			Определяет конфигурацию устройства
	asset_tag -		Тег актива, связанный с устройством
	cluster -		Кластер, которому будет назначено устройство
	comments -		Комментарии, которые могут содержать дополнительную информацию об устройстве
	custom_fields -		должны существовать в Netbox
	device_role -		Требуется, если state=present и устройство еще не существует
	device_type -		Требуется, если state=present и устройство еще не существует
	face -		Требуется, если определен параметр rack
	name - / обязательно		Название устройства
	platform -		Платформа устройства
	position -		Положение устройства в стойке, определенной выше
	rack -		Имя стойки, в которую будет помещено устройство
	serial -		Серийный номер устройства
	site -		Требуется, если state=present и устройство еще не существует
	status -	Варианты: Активный Оффлайн Планируемый На этапе подготовки Неудачный Инвентаризация	Статус устройства
	tags -		Теги, которые необходимо связать с устройством
	tenant -		Клиент, которому будет назначено устройство
netbox_token - / обязательно			Токен, созданный в Netbox для авторизации доступа к API
netbox_url - / обязательно			URL-адрес экземпляра Netbox, разрешаемый управляющим хостом Ansible
state -		Варианты: absent present ←	Используйте `present` или `absent` для добавления или удаления.
validate_certs boolean		Варианты: no yes ←	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, с использованием самозаверяемых сертификатов.

Примечания

Примечание

Теги должны быть определены как список YAML
Это должно выполняться с подключением local и хостами localhost

Примеры

- name: "Test Netbox modules"
  connection: local
  hosts: localhost
  gather_facts: False

  tasks:
    - name: Create device within Netbox with only required information
      netbox_device:
        netbox_url: http://netbox.local
        netbox_token: thisIsMyToken
        data:
          name: Test Device
          device_type: C9410R
          device_role: Core Switch
          site: Main
        state: present

    - name: Delete device within netbox
      netbox_device:
        netbox_url: http://netbox.local
        netbox_token: thisIsMyToken
        data:
          name: Test Device
        state: absent

    - name: Create device with tags
      netbox_device:
        netbox_url: http://netbox.local
        netbox_token: thisIsMyToken
        data:
          name: Another Test Device
          device_type: C9410R
          device_role: Core Switch
          site: Main
          tags:
            - Schnozzberry
        state: present

    - name: Update the rack and position of an existing device
      netbox_device:
        netbox_url: http://netbox.local
        netbox_token: thisIsMyToken
        data:
          name: Test Device
          rack: Test Rack
          position: 10
          face: Front
        state: present

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

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

Ключ	Возвращаемое значение	Описание
device словарь	успех (при state=present)	Сериализованный объект, созданный или уже существующий в Netbox
msg строка	всегда	Сообщение, указывающее на ошибку или информацию о достигнутом результате

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Михаил Юхман (@FragmentedPacket)
Давид Гомес (@amb1s1)

Подсказка

Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/netbox_device_module.html