networktocode / networktocode.nautobot / 4.5.0 / module / inventory_item Creates or removes inventory items from Nautobot | "added in version" 1.0.0 of networktocode.nautobot" Authors: Mikhail Yohman (@FragmentedPacket)networktocode.nautobot.inventory_item (4.5.0) — module
Install with ansible-galaxy collection install networktocode.nautobot:==4.5.0
collections: - name: networktocode.nautobot version: 4.5.0
Creates or removes inventory items from Nautobot
- name: "Test Nautobot inventory_item module" connection: local hosts: localhost gather_facts: False tasks: - name: Create inventory item within Nautobot with only required information networktocode.nautobot.inventory_item: url: http://nautobot.local token: thisIsMyToken device: test100 name: "10G-SFP+" state: present - name: Update inventory item networktocode.nautobot.inventory_item: url: http://nautobot.local token: thisIsMyToken device: test100 name: "10G-SFP+" manufacturer: "Cisco" part_id: "10G-SFP+" serial: "1234" asset_tag: "1234" description: "New SFP" state: present - name: Delete inventory item within nautobot networktocode.nautobot.inventory_item: url: http://nautobot.local token: thisIsMyToken device: test100 name: "10G-SFP+" state: absent
url: description: - 'The URL of the Nautobot instance resolvable by the Ansible host (for example: http://nautobot.example.com:8000)' required: true type: str name: description: - Name of the inventory item to be created required: true type: str version_added: 3.0.0 version_added_collection: networktocode.nautobot tags: description: - Any tags that this item may need to be associated with elements: raw required: false type: list version_added: 3.0.0 version_added_collection: networktocode.nautobot state: choices: - absent - present default: present description: - Use C(present) or C(absent) for adding or removing. type: str token: description: - The token created within Nautobot to authorize API access required: true type: str device: description: - Name of the device the inventory item belongs to required: true type: raw version_added: 3.0.0 version_added_collection: networktocode.nautobot serial: description: - The serial number of the inventory item required: false type: str version_added: 3.0.0 version_added_collection: networktocode.nautobot part_id: description: - The part ID of the inventory item required: false type: str version_added: 3.0.0 version_added_collection: networktocode.nautobot asset_tag: description: - The asset tag of the inventory item required: false type: str version_added: 3.0.0 version_added_collection: networktocode.nautobot discovered: default: false description: - Set the discovery flag for the inventory item required: false type: bool version_added: 3.0.0 version_added_collection: networktocode.nautobot api_version: description: - API Version Nautobot REST API required: false type: str version_added: 4.1.0 version_added_collection: networktocode.nautobot description: description: - The description of the inventory item required: false type: str version_added: 3.0.0 version_added_collection: networktocode.nautobot manufacturer: description: - The manufacturer of the inventory item required: false type: raw version_added: 3.0.0 version_added_collection: networktocode.nautobot query_params: description: - This can be used to override the specified values in ALLOWED_QUERY_PARAMS that is defined - in plugins/module_utils/utils.py and provides control to users on what may make - an object unique in their environment. elements: str required: false type: list version_added: 3.0.0 version_added_collection: networktocode.nautobot validate_certs: default: true description: - If C(no), SSL certificates will not be validated. This should only be used on personally controlled sites using self-signed certificates. required: false type: raw
inventory_item: description: Serialized object as created or already existent within Nautobot returned: on creation type: dict msg: description: Message indicating failure or info about what has been achieved returned: always type: str