snow_record - Создание/удаление/обновление записей в ServiceNow
Новая версия 2.5.
Обзор
- Создаёт/удаляет/обновляет одну запись в ServiceNow
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python pysnow (pysnow)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| attachment | Прикрепление файла к записи | |
| data | Ключ-значение пары данных для загрузки в запись. См. примеры. Обязательно для state:present
| |
| instance обязательно | Имя экземпляра service now | |
| lookup_field | По умолчанию: "number" | Изменяет поле, которое number использует для поиска записей |
| number | Номер записи для обновления. Обязательно для state:absent
| |
| password обязательно | Пароль для имени пользователя | |
| state обязательно |
| Если present используется с аргументом number, модуль попытается обновить запись с предоставленными данными. Если такая запись не существует, будет создана новая. absent удалит запись. |
| table | По умолчанию: "incident" | Таблица для запроса записей |
| username обязательно | Пользователь для подключения к ServiceNow |
Примеры
- name: Grab a user record
snow_record:
username: ansible_test
password: my_password
instance: dev99999
state: present
number: 62826bf03710200044e0bfc8bcbe5df1
table: sys_user
lookup_field: sys_id
- name: Create an incident
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: Delete the record we just made
snow_record:
username: admin
password: xxxxxxx
instance: dev99999
state: absent
number: "{{new_incident['record']['number']}}"
- name: Delete a non-existant record
snow_record:
username: ansible_test
password: my_password
instance: dev99999
state: absent
number: 9872354
failed_when: false
- name: Update an incident
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
snow_record:
username: ansible_test
password: my_password
instance: dev99999
state: present
number: INC0000055
attachment: README.md
tags: attach
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| attached_file dict | при поддержке | Подробная информация о файле, который был прикреплён через attachment
|
| record dict | при поддержке | Данные записи из Service Now |
Статус
Этот модуль помечен как preview, что означает, что он не гарантирует обратную совместимость.
Техническое обслуживание
Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- Tim Rightnour (@garbled1)
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/snow_record_module.html
