Spec-Zone.ru › AWS CLI v2

[ aws . qbusiness ]

list-messages

Описание

Получает список сообщений, связанных с веб-опытом Amazon Q Business.

См. также: Документацию API AWS

list-messages использует значения типа документа. Типы документов следуют модели данных JSON, где допустимые значения: строки, числа, булевы значения, null, массивы и объекты. Для ввода команд, опций и вложенных параметров, помеченных типом document, необходимо предоставить JSON. Краткая синтаксическая запись не поддерживает типы документов.

list-messages — это постраничная операция. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничный вывод, предоставив аргумент --no-paginate. При использовании --output text и аргумента --query в ответном значении с постраничным выводом, аргумент --query должен извлекать данные из результатов следующих выражений запроса: messages

Синтаксис

  list-messages
--conversation-id <value>
--application-id <value>
[--user-id <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--conversation-id (строка)

Идентификатор диалога веб-опыта Amazon Q Business.

--application-id (строка)

Идентификатор приложения Amazon Q Business.

--user-id (строка)

Идентификатор пользователя, участвующего в диалоге веб-опыта Amazon Q Business.

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если на командной строке предоставлены другие аргументы, эти значения переопределят значения, предоставленные через JSON. Передача произвольных бинарных значений через значение JSON невозможна, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.

--starting-token (строка)

Токен для указания места начала постраничного вывода. Это NextToken из ранее усеченного ответа.

Примеры использования см. в разделе Постраничный вывод в Руководстве пользователя командной строки AWS.

--page-size (целое число)

Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.

Примеры использования см. в разделе Постраничный вывод в Руководстве пользователя командной строки AWS.

--max-items (целое число)

Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Чтобы продолжить постраничный вывод, предоставьте значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken непосредственно вне AWS CLI.

Примеры использования см. в разделе Постраничный вывод в Руководстве пользователя командной строки AWS.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если предоставлено значение без значения или значение input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено значение yaml-input, он выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, он проверит входные данные команды и вернёт пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (логическое значение)

Включить отладочную регистрацию.

--endpoint-url (строка)

Переопределить URL по умолчанию команды заданным URL.

--no-verify-ssl (логическое значение)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (логическое значение)

Отключить автоматический постраничный вывод. Если автоматический постраничный вывод отключен, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования для вывода команды.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определенный профиль из файла учетных данных.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/отключить вывод в цвете.

  • on
  • off
  • auto

--no-sign-request (логическое значение)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (строка)

Файл-сборник сертификатов CA для использования при проверке SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет ограничено по времени. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет ограничено по времени. Значение по умолчанию — 60 секунд.

--cli-binary-format (строка)

Стиль форматирования для использования с бинарными блоками. По умолчанию используется формат base64. Формат base64 ожидает, что бинарные блоки будут предоставлены в виде строки, закодированной в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и бинарные значения должны быть переданы буквально. При предоставлении содержимого из файла, соответствующего бинарному блоку, fileb:// всегда будет обрабатываться как бинарный и использовать содержимое файла непосредственно независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (логическое значение)

Отключить кли-паджер для вывода.

--cli-auto-prompt (логическое значение)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (логическое значение)

Отключить автоматическое запросы параметров ввода CLI.

Вывод

messages -> (список)

Массив информации об одном или нескольких сообщениях.

(структура)

Сообщение в веб-опыте Amazon Q Business.

messageId -> (строка)

Идентификатор сообщения веб-опыта Amazon Q Business.

body -> (строка)

Содержимое сообщения веб-опыта Amazon Q Business.

time -> (временная метка)

Временная метка первого сообщения веб-опыта Amazon Q Business.

type -> (строка)

Тип сообщения Amazon Q Business, генерируемого HUMAN или AI.

attachments -> (список)

Файл, загруженный непосредственно в чат веб-опыта Amazon Q Business.

(структура)

Подробности загруженного в ходе чата файла.

name -> (строка)

Имя загруженного файла.

status -> (строка)

Статус загруженного файла.

error -> (структура)

Ошибка, связанная с загруженным файлом.

errorMessage -> (строка)

Сообщение, объясняющее ошибку запроса Amazon Q Business.

errorCode -> (строка)

Код, связанный с ошибкой запроса Amazon Q Business.

attachmentId -> (строка)

Уникальный идентификатор вложения Amazon Q Business.

conversationId -> (строка)

Уникальный идентификатор беседы Amazon Q Business.

sourceAttribution -> (список)

Исходные документы, используемые для генерации сообщения веб-опыта Amazon Q Business.

(структура)

Документы, используемые для генерации ответа веб-опыта Amazon Q Business.

title -> (строка)

Заголовок документа, являющегося источником сгенерированного ответа Amazon Q Business.

snippet -> (строка)

Выдержки из документа, на основе которого был сгенерирован ответ.

url -> (строка)

URL документа, являющегося источником сгенерированного ответа Amazon Q Business.

citationNumber -> (целое число)

Номер, присвоенный цитате в сгенерированном ответе Amazon Q Business.

updatedAt -> (временная метка)

Временная метка последнего обновления приложения Amazon Q Business.

textMessageSegments -> (список)

Выдержки текста из исходного документа, используемые для указания источника.

(структура)

Предоставляет информацию о выдержке текста в ответе чата, которая может быть отнесена к исходному документу.

beginOffset -> (целое число)

Базисное положение в строке ответа, где начинается указание на источник.

endOffset -> (целое число)

Базисное положение в строке ответа, где заканчивается указание на источник.

snippetExcerpt -> (структура)

Соответствующий фрагмент текста из источника, который использовался для генерации фрагмента цитаты в ответе чата Amazon Q Business.

text -> (строка)

Соответствующий фрагмент текста из источника, который использовался для генерации фрагмента цитаты в ответе чата Amazon Q Business.

mediaId -> (строка)

Идентификатор медиаобъекта, связанного с фрагментом текста в указании источника.

mediaMimeType -> (строка)

MIME-тип (image/png) медиаобъекта, связанного с фрагментом текста в указании источника.

sourceDetails -> (структура помеченных объединений)

Информация об источнике для фрагмента извлеченного текста, включая его тип.

Примечание

Это структура помеченных объединений. Только один из следующих ключей верхнего уровня может быть установлен: imageSourceDetails, audioSourceDetails, videoSourceDetails.

imageSourceDetails -> (структура)

Подробности, специфичные для изображений в источнике.

mediaId -> (строка)

Уникальный идентификатор файла изображения.

mediaMimeType -> (строка)

MIME-тип файла изображения.

audioSourceDetails -> (структура)

Подробности, специфичные для аудиоконтента в источнике.

mediaId -> (строка)

Уникальный идентификатор файла аудиомедиа.

mediaMimeType -> (строка)

MIME-тип аудиофайла (например, audio/mp3, audio/wav).

startTimeMilliseconds -> (длинное целое число)

Начальная временная метка в миллисекундах для соответствующего отрывка аудио.

endTimeMilliseconds -> (длинное целое число)

Конечная временная метка в миллисекундах для соответствующего отрывка аудио.

audioExtractionType -> (строка)

Тип аудиоэкстракции, выполненной над контентом.

videoSourceDetails -> (структура)

Подробности, специфичные для видеоконтента в источнике.

mediaId -> (строка)

Уникальный идентификатор файла видеомедиа.

mediaMimeType -> (строка)

MIME-тип видеофайла (например, video/mp4, video/avi).

startTimeMilliseconds -> (длинное целое число)

Начальная временная метка в миллисекундах для соответствующего отрывка видео.

endTimeMilliseconds -> (длинное целое число)

Конечная временная метка в миллисекундах для соответствующего отрывка видео.

videoExtractionType -> (строка)

Тип видеоэкстракции, выполненной над контентом.

actionReview -> (структура)

Событие вывода, которое Amazon Q Business возвращает пользователю, который хочет выполнить действие плагина во время непрямого чата. Оно содержит информацию о выбранном действии со списком возможных полей ввода пользователя, некоторые из которых заполнены Amazon Q Business.

pluginId -> (строка)

Идентификатор плагина, связанный с обзором действия.

pluginType -> (строка)

Тип плагина.

payload -> (карта)

Значения полей, которые конечный пользователь должен предоставить Amazon Q Business для выполнения запрошенного действия плагина.

key -> (строка)

value -> (структура)

Поле ввода пользователя в оплате обзора действия плагина.

displayName -> (строка)

Имя поля.

displayOrder -> (целое число)

Порядок отображения полей в оплате.

displayDescription -> (строка)

Описание поля каждого поля ввода обзора действия. Это может быть объяснение поля. В веб-опыте Amazon Q Business эти описания могут использоваться для отображения всплывающих подсказок, помогающих пользователям понять поле.

type -> (строка)

Тип поля.

value -> (документ)

Значение поля.

allowedValues -> (список)

Информация о значениях поля, которые конечный пользователь может использовать для предоставления Amazon Q Business, чтобы выполнить запрашиваемое действие плагина.

(структура)

Информация о значениях поля, которые конечный пользователь может использовать для предоставления Amazon Q Business, чтобы выполнить запрашиваемое действие плагина.

value -> (документ)

Значение поля.

displayValue -> (документ)

Имя поля.

allowedFormat -> (строка)

Ожидаемый формат данных для значения поля ввода обзора действия. Например, в запросе PTO from и to будут иметь формат datetime.

arrayItemJsonSchema -> (документ)

Используется для создания пользовательской формы с полями массива (полями со вложенными объектами внутри массива).

required -> (булево)

Информация о том, обязательно ли поле.

payloadFieldNameSeparator -> (строка)

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

actionExecution -> (структура)

Выполнение действия плагина Amazon Q Business во время непрямого чата.

pluginId -> (строка)

Идентификатор плагина, к которому прикреплено действие.

payload -> (карта)

Сопоставление имен полей со значениями полей во входных данных, предоставляемых конечным пользователем Amazon Q Business для выполнения действия плагина.

key -> (строка)

value -> (структура)

Поле ввода пользователя в оплате выполнения действия плагина.

value -> (документ)

Содержимое поля ввода пользователя в оплате выполнения действия плагина.

payloadFieldNameSeparator -> (строка)

Строка, используемая для сохранения информации об иерархических контекстах в оплате события выполнения действия.

nextToken -> (строка)

Если ответ усечен, Amazon Q Business возвращает этот токен, который можно использовать в последующем запросе для отображения следующего набора сообщений.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API