Ansible Collection for ServiceNow ITSM

The Ansible Collection for ServiceNow IT Service Management (ITSM) includes a variety of Ansible content to help automate the management of ServiceNow IT Service Management.

Ansible version compatibility

This collection has been tested against following Ansible versions: >=2.9.10.

Plugins and modules within a collection may be tested with only specific Ansible versions. A collection may contain metadata that identifies these versions. PEP440 is the schema used to describe the versions of Ansible.

Python version compatibility

This collection requires Python 2.7 or greater.

Included content

Inventory plugins

Name	Description
servicenow.itsm.servicenow.itsm.now	Inventory source for ServiceNow table records.

Modules

Name	Description
servicenow.itsm.change_request	Manage ServiceNow change requests
servicenow.itsm.change_request_info	List ServiceNow change requests
servicenow.itsm.configuration_item	Manage ServiceNow configuration items
servicenow.itsm.configuration_item_batch	Manage ServiceNow configuration items
servicenow.itsm.configuration_item_info	List ServiceNow configuration item
servicenow.itsm.incident	Manage ServiceNow incidents
servicenow.itsm.incident_info	List ServiceNow incidents
servicenow.itsm.problem	Manage ServiceNow problems
servicenow.itsm.problem_info	List ServiceNow problems

Installing this collection

You can install the ServiceNow ITSM collection with the Ansible Galaxy CLI:

ansible-galaxy collection install servicenow.itsm

You can also include it in a requirements.yml file and install it with ansible-galaxy collection install -r requirements.yml, using the format:

---
collections:
  - name: servicenow.itsm

Using this collection

You can either call modules by their Fully Qualified Collection Namespace (FQCN), such as servicenow.itsm.incident_info, or you can call modules by their short name if you list the servicenow.itsm collection in the playbook's collections keyword:

TODO: INCIDENT_INFO module example.

See Also:

• ServiceNow IT Service Management
• Ansible Using collections for more details.

Contributing to this collection

We welcome community contributions to this collection. If you find problems, please open an issue or create a PR against the ServiceNow ITSM collection repository. See Contributing to Ansible-maintained collections for more details.

You can also join us on:

• IRC - the #ansible-community irc.libera.chat channel

See the Ansible Community Guide for details on contributing to Ansible.

Release notes

Roadmap

More information

• Ansible Collection overview
• Ansible User guide
• Ansible Developer guide
• Ansible Community code of conduct

Licensing

GNU General Public License v3.0 or later.

See COPYING to see the full text.