snow_record_find – Поиск нескольких записей из ServiceNow
Новое в версии 2.9.
Обзор
- Получение нескольких записей из указанной таблицы из ServiceNow на основе словаря запроса.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python pysnow (pysnow)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| client_id строка добавлено в 2.9 | Идентификатор клиента, сгенерированный ServiceNow. | |
| client_secret строка добавлено в 2.9 | Секретный ключ клиента, связанный с идентификатором клиента. | |
| instance строка | Имя экземпляра ServiceNow без домена, service-now.com. Если значение не указано в задаче, используется значение переменной окружения SN_INSTANCE. Поддержка переменных окружения добавлена в Ansible 2.9. | |
| max_records целое число | По умолчанию: 20 | Максимальное количество записей для возврата. |
| order_by строка | По умолчанию: "-created_on" | Поле для сортировки результатов. Можно добавлять "-" или "+" для изменения порядка сортировки (убывающий или возрастающий). |
| password строка | Пароль для имени пользователя. Требуется при использовании аутентификации Basic или OAuth. Если значение не указано в задаче, используется значение переменной окружения SN_PASSWORD.Поддержка переменных окружения добавлена в Ansible 2.9. | |
| query словарь / обязательно | Словарь для запроса записей. | |
| return_fields список | Поля записи для возврата в формате json. По умолчанию возвращаются все поля. | |
| table строка | По умолчанию: "incident" | Таблица для запроса записей. |
| username строка | Имя пользователя для подключения к ServiceNow. Требуется при использовании аутентификации Basic или OAuth. Если значение не указано в задаче, используется значение переменной окружения SN_USERNAME.Поддержка переменных окружения добавлена в Ansible 2.9. |
Примеры
- name: Search for incident assigned to group, return specific fields
snow_record_find:
username: ansible_test
password: my_password
instance: dev99999
table: incident
query:
assignment_group: d625dccec0a8016700a222a0f7900d06
return_fields:
- number
- opened_at
- name: Using OAuth, search for incident assigned to group, return specific fields
snow_record_find:
username: ansible_test
password: my_password
client_id: "1234567890abcdef1234567890abcdef"
client_secret: "Password1!"
instance: dev99999
table: incident
query:
assignment_group: d625dccec0a8016700a222a0f7900d06
return_fields:
- number
- opened_at
- name: Find open standard changes with my template
snow_record_find:
username: ansible_test
password: my_password
instance: dev99999
table: change_request
query:
AND:
equals:
active: "True"
type: "standard"
u_change_stage: "80"
contains:
u_template: "MY-Template"
return_fields:
- sys_id
- number
- sys_created_on
- sys_updated_on
- u_template
- active
- type
- u_change_stage
- sys_created_by
- description
- short_description
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| 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.9/modules/snow_record_find_module.html
