[ 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 (строка)
--content-type (строка)
--accept (строка)
--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 (строка)
--input-location (строка)
--request-ttl-seconds (целое число)
--invocation-timeout-seconds (целое число)
--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 -> (строка)
FailureLocation -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.