netbox.netbox.netbox_rear_port – Create, update or delete rear ports within Netbox¶
Note
This plugin is part of the netbox.netbox collection (version 3.1.0).
To install it use: ansible-galaxy collection install netbox.netbox
.
To use it in a playbook, specify: netbox.netbox.netbox_rear_port
.
New in version 0.2.3: of netbox.netbox
Synopsis¶
Creates, updates or removes rear ports from Netbox
Requirements¶
The below requirements are needed on the host that executes this module.
pynetbox
Parameters¶
Notes¶
Note
Tags should be defined as a YAML list
This should be ran with connection
local
and hostslocalhost
Examples¶
- name: "Test Netbox modules"
connection: local
hosts: localhost
gather_facts: False
tasks:
- name: Create rear port within Netbox with only required information
netbox_rear_port:
netbox_url: http://netbox.local
netbox_token: thisIsMyToken
data:
name: Test Rear Port
device: Test Device
type: bnc
state: present
- name: Update rear port with other fields
netbox_rear_port:
netbox_url: http://netbox.local
netbox_token: thisIsMyToken
data:
name: Test Rear Port
device: Test Device
type: bnc
positions: 5
description: rear port description
state: present
- name: Delete rear port within netbox
netbox_rear_port:
netbox_url: http://netbox.local
netbox_token: thisIsMyToken
data:
name: Test Rear Port
device: Test Device
type: bnc
state: absent
Return Values¶
Common return values are documented here, the following are the fields unique to this module: