servicenow.servicenow.snow_record – Manage records in ServiceNow¶
Note
This plugin is part of the servicenow.servicenow collection (version 1.0.4).
To install it use: ansible-galaxy collection install servicenow.servicenow
.
To use it in a playbook, specify: servicenow.servicenow.snow_record
.
Requirements¶
The below requirements are needed on the host that executes this module.
python pysnow (pysnow)
Parameters¶
Examples¶
- name: Grab a user record
servicenow.servicenow.snow_record:
username: ansible_test
password: my_password
instance: dev99999
state: present
number: 62826bf03710200044e0bfc8bcbe5df1
table: sys_user
lookup_field: sys_id
- name: Grab a user record using OAuth
servicenow.servicenow.snow_record:
username: ansible_test
password: my_password
client_id: "1234567890abcdef1234567890abcdef"
client_secret: "Password1!"
instance: dev99999
state: present
number: 62826bf03710200044e0bfc8bcbe5df1
table: sys_user
lookup_field: sys_id
- name: Create an incident
servicenow.servicenow.snow_record:
username: ansible_test
password: my_password
instance: dev99999
state: present
data:
short_description: "This is a test incident opened by Ansible"
severity: 3
priority: 2
register: new_incident
- name: Create an incident using host instead of instance
servicenow.servicenow.snow_record:
username: ansible_test
password: my_password
host: dev99999.mycustom.domain.com
state: present
data:
short_description: "This is a test incident opened by Ansible"
priority: 2
- name: Delete the record we just made
servicenow.servicenow.snow_record:
username: admin
password: xxxxxxx
instance: dev99999
state: absent
number: "{{new_incident['record']['number']}}"
- name: Delete a non-existant record
servicenow.servicenow.snow_record:
username: ansible_test
password: my_password
instance: dev99999
state: absent
number: 9872354
failed_when: false
- name: Update an incident
servicenow.servicenow.snow_record:
username: ansible_test
password: my_password
instance: dev99999
state: present
number: INC0000055
data:
work_notes : "Been working all day on this thing."
- name: Attach a file to an incident
servicenow.servicenow.snow_record:
username: ansible_test
password: my_password
instance: dev99999
state: present
number: INC0000055
attachment: README.md
tags: attach
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
attached_file
dictionary
|
when supported |
Details of the file that was attached via
attachment |
record
dictionary
|
when supported |
Record data from Service Now
|
Authors¶
Tim Rightnour (@garbled1)