Spec-Zone.ru › AWS CLI v2

[ aws . sagemaker-runtime ]

invoke-endpoint-async

Описание

После развертывания модели в производство с помощью сервисов размещения Amazon SageMaker, ваши клиентские приложения используют этот API для получения выводов из модели, размещенной на указанном конечной точке, в асинхронном режиме.

Запросы вывода, отправленные в этот API, добавляются в очередь для асинхронной обработки. Обработка запроса вывода может завершиться или нет до получения ответа от этого API. Ответ от этого API не будет содержать результат запроса вывода, но будет содержать информацию о том, где его можно найти.

Amazon SageMaker удаляет все заголовки POST, кроме поддерживаемых API. Amazon SageMaker может добавить дополнительные заголовки. Не следует полагаться на поведение заголовков, не перечисленных в синтаксисе запроса.

Вызовы к InvokeEndpointAsync аутентифицируются с использованием Amazon Web Services Signature Version 4. Дополнительная информация содержится в разделе «Аутентификация запросов (Amazon Web Services Signature Version 4)» в справочнике Amazon S3 API.

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

Синтаксис

  invoke-endpoint-async
--endpoint-name <value>
[--content-type <value>]
[--accept <value>]
[--custom-attributes <value>]
[--inference-id <value>]
--input-location <value>
[--request-ttl-seconds <value>]
[--invocation-timeout-seconds <value>]
[--cli-input-json | --cli-input-yaml]
[--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]

Параметры

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

Имя конечной точки, указанное при создании конечной точки с помощью API CreateEndpoint.

--content-type (строка)

Тип MIME входных данных в теле запроса.

--accept (строка)

Желаемый тип MIME ответа вывода от контейнера модели.

--custom-attributes (строка)

Предоставляет дополнительную информацию о запросе вывода, отправленном модели, размещенной на конечной точке Amazon SageMaker. Информация представляет собой непрозрачное значение, которое передается без изменений. Например, это значение можно использовать для предоставления идентификатора, который можно использовать для отслеживания запроса, или для предоставления других метаданных, которые служба конечной точки запрограммирована обрабатывать. Значение должно состоять не более чем из 1024 видимых символов US-ASCII, как указано в разделе 3.3.6. Компоненты значения поля в протоколе передачи гипертекста (HTTP/1.1).

Код вашей модели отвечает за установку или обновление любых пользовательских атрибутов в ответе. Если ваш код не установит это значение в ответе, будет возвращено пустое значение. Например, если пользовательский атрибут представляет идентификатор трассировки, ваша модель может добавить префикс Trace ID: к пользовательскому атрибуту в вашей функции пост-обработки.

Эта функция в настоящее время поддерживается Amazon Web Services SDK, но не в Amazon SageMaker Python SDK.

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

Идентификатор запроса вывода. Amazon SageMaker сгенерирует идентификатор для вас, если он не указан.

--input-location (строка)

Amazon S3 URI, где хранится полезная нагрузка запроса вывода.

--request-ttl-seconds (целое число)

Максимальный срок хранения запроса в очереди в секундах, после которого запрос помечается как просроченный. По умолчанию — 6 часов, или 21 600 секунд.

--invocation-timeout-seconds (целое число)

Максимальное время обработки запроса в секундах, после которого запрос помечается как просроченный. По умолчанию — 15 минут, или 900 секунд.

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

--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 (целое число)

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

--cli-connect-timeout (целое число)

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

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

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

  • base64
  • raw-in-base64-out

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

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

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

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

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

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

Вывод

InferenceId -> (строка)

Идентификатор запроса вывода. Он будет совпадать с указанным в вводе InferenceId. Amazon SageMaker сгенерирует идентификатор для вас, если вы его не укажете.

OutputLocation -> (строка)

Amazon S3 URI, где хранится полезная нагрузка ответа вывода.

FailureLocation -> (строка)

Amazon S3 URI, где хранится полезная нагрузка ответа о сбое вывода.

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

Spec-Zone.ru

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