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. [сообщество]

Авторы

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