cisco_spark – Отправка сообщения в комнату или к пользователю Cisco Spark

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

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

Описание

Отправить сообщение в комнату или к пользователю Cisco Spark с возможностью управления форматированием.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
message - / обязательно		Сообщение, которое вы хотите отправить.
message_type -	Варианты: text ← markdown	Указывает, как вы хотите отформатировать сообщение.
personal_token - / обязательно		Ваш личный токен доступа, необходимый для проверки Spark API. алиасы: token
recipient_id - / обязательно		Уникальный идентификатор, связанный с предоставленным `recipient_type`.
recipient_type - / обязательно	Варианты: roomId toPersonEmail toPersonId	Параметр запроса, которому вы хотите отправить сообщение. Сообщения могут быть отправлены либо в комнату, либо к пользователю (по ID или электронной почте).

Примечания

Примечание

Тип recipient_id должен быть допустимым для предоставленного recipient_id.
Полную документацию API можно найти по адресу https://developer.ciscospark.com/endpoint-messages-post.html.

Примеры

# Note: The following examples assume a variable file has been imported
# that contains the appropriate information.

- name: Cisco Spark - Markdown Message to a Room
  cisco_spark:
    recipient_type: roomId
    recipient_id: "{{ room_id }}"
    message_type: markdown
    personal_token: "{{ token }}"
    message: "**Cisco Spark Ansible Module - Room Message in Markdown**"

- name: Cisco Spark - Text Message to a Room
  cisco_spark:
    recipient_type: roomId
    recipient_id: "{{ room_id }}"
    message_type: text
    personal_token: "{{ token }}"
    message: "Cisco Spark Ansible Module - Room Message in Text"

- name: Cisco Spark - Text Message by an Individuals ID
  cisco_spark:
    recipient_type: toPersonId
    recipient_id: "{{ person_id}}"
    message_type: text
    personal_token: "{{ token }}"
    message: "Cisco Spark Ansible Module - Text Message to Individual by ID"

- name: Cisco Spark - Text Message by an Individuals E-Mail Address
  cisco_spark:
    recipient_type: toPersonEmail
    recipient_id: "{{ person_email }}"
    message_type: text
    personal_token: "{{ token }}"
    message: "Cisco Spark Ansible Module - Text Message to Individual by E-Mail"

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:

Ключ	Возвращаемое значение	Описание
message строка	всегда	Сообщение ответа, возвращаемое API Spark. Полные объяснения кода ответа доступны по адресу https://developer.ciscospark.com/endpoint-messages-post.html. Пример: OK (585 байт)
status_code целое число	всегда	Код ответа, возвращаемый API Spark. Полные объяснения кода ответа доступны по адресу https://developer.ciscospark.com/endpoint-messages-post.html. Пример: 200

Статус

Гарантируется, что изменения интерфейса этого модуля в обратном направлении не будут производиться. [stableinterface]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Drew Rusell (@drew-russell)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 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/cisco_spark_module.html