snow_record - Создание/удаление/обновление записей в ServiceNow

Новое в версии 2.5.

Обзор
- Требования
Параметры
Примеры
Возвращаемые значения
Статус
- Автор

Обзор

Создает/удаляет/обновляет одну запись в ServiceNow

Требования

Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.

python pysnow (pysnow)

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
attachment		Прикрепить файл к записи
data		Ключ-значение пары данных для загрузки в запись. См. Примеры. Требуется для `state:present`
instance обязательно		Имя экземпляра ServiceNow
lookup_field	По умолчанию: number	Изменяет поле, которое `number` использует для поиска записей
number		Номер записи для обновления. Требуется для `state:absent`
password обязательно		Пароль для имени пользователя
state обязательно	Варианты: present absent	Если `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

Статус

Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратная совместимость.

Автор

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.5/modules/snow_record_module.html