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 словарь	при поддержке	Подробности файла, который был прикреплён через `attachment`
record словарь	при поддержке	Данные записи из ServiceNow

Статус

Этот модуль не гарантирует обратной совместимости. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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