netbox_community / netbox_community.ansible_modules / 0.1.10 / module / netbox_device_role Create, update or delete devices roles within Netbox | "added in version" 0.1.0 of netbox_community.ansible_modules" Authors: Mikhail Yohman (@FragmentedPacket) preview | supported by communitynetbox_community.ansible_modules.netbox_device_role (0.1.10) — module
Install with ansible-galaxy collection install netbox_community.ansible_modules:==0.1.10
collections: - name: netbox_community.ansible_modules version: 0.1.10
Creates, updates or removes devices roles from Netbox
- name: "Test Netbox modules" connection: local hosts: localhost gather_facts: False tasks: - name: Create device role within Netbox with only required information netbox_device_role: netbox_url: http://netbox.local netbox_token: thisIsMyToken data: name: Test device role color: FFFFFF state: present - name: Delete device role within netbox netbox_device_role: netbox_url: http://netbox.local netbox_token: thisIsMyToken data: name: Test Rack role state: absent
data: description: - Defines the device role configuration required: true suboptions: color: description: - Hexidecimal code for a color, ex. FFFFFF required: true name: description: - The name of the device role required: true vm_role: default: true description: - Whether the role is a VM role type: bool state: choices: - absent - present default: present description: - Use C(present) or C(absent) for adding or removing. netbox_url: description: - URL of the Netbox instance resolvable by Ansible control host required: true netbox_token: description: - The token created within Netbox to authorize API access required: true validate_certs: default: 'yes' description: - If C(no), SSL certificates will not be validated. This should only be used on personally controlled sites using self-signed certificates. type: bool
device_role: description: Serialized object as created or already existent within Netbox returned: success (when I(state=present)) type: dict msg: description: Message indicating failure or info about what has been achieved returned: always type: str