обновить-точку-определения
Описание
Развёртывает указанную в запросе EndpointConfig в новый флот экземпляров. SageMaker переключает трафик точки определения на новые экземпляры с обновлённой конфигурацией точки определения, а затем удаляет старые экземпляры, используя предыдущую EndpointConfig (потеря доступности отсутствует). Более подробную информацию о том, как управлять процессом обновления и переключения трафика, см. в разделе Обновление моделей в рабочей среде.
При получении запроса SageMaker устанавливает статус точки определения в Updating. После обновления точки определения статус устанавливается в InService. Для проверки статуса точки определения используйте API DescribeEndpoint.
Примечание
Нельзя удалять EndpointConfig, используемые активной точкой определения или в процессе выполнения операций UpdateEndpoint или CreateEndpoint с точкой определения. Для обновления точки определения необходимо создать новую EndpointConfig.
Если вы удалите EndpointConfig активной или создаваемой/обновляемой точки определения, вы можете потерять видимость типа экземпляра, используемого точкой определения. Для прекращения начисления платы точка определения должна быть удалена.
См. также: Документация API AWS
Синтаксис
update-endpoint
--endpoint-name <value>
--endpoint-config-name <value>
[--retain-all-variant-properties | --no-retain-all-variant-properties]
[--exclude-retained-variant-properties <value>]
[--deployment-config <value>]
[--retain-deployment-config | --no-retain-deployment-config]
[--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 (строка)
--endpoint-config-name (строка)
--retain-all-variant-properties | --no-retain-all-variant-properties (логическое значение)
RetainAllVariantProperties в true. Для использования свойств варианта, указанных в новом вызове EndpointConfig при обновлении точки определения, установите RetainAllVariantProperties в false. По умолчанию установлено false.--exclude-retained-variant-properties (список)
При обновлении ресурсов точки определения с RetainAllVariantProperties, значение которого установлено в true, ExcludeRetainedVariantProperties указывает список типов VariantProperty, которые необходимо переопределить значениями, предоставленными EndpointConfig. Если вы не укажете значение для ExcludeRetainedVariantProperties, никакие свойства варианта не будут переопределены.
(структура)
Указывает тип свойства варианта для точки определения.
Если вы обновляете точку определения с параметром RetainAllVariantProperties команды UpdateEndpointInput, установленным в true, объекты VariantProperty, перечисленные в параметре ExcludeRetainedVariantProperties команды UpdateEndpointInput, переопределяют существующие свойства варианта точки определения.
VariantPropertyType -> (строка)
Тип свойства варианта. Поддерживаемые значения:
-
DesiredInstanceCount: Переопределяет существующие значения количества экземпляров варианта, используя значенияInitialInstanceCountвProductionVariantsкоманды CreateEndpointConfig. -
DesiredWeight: Переопределяет существующие веса вариантов, используя значенияInitialVariantWeightвProductionVariantsкоманды CreateEndpointConfig. -
DataCaptureConfig: (В настоящее время не поддерживается.)
Сокращённый синтаксис:
VariantPropertyType=string ...
Синтаксис JSON:
[
{
"VariantPropertyType": "DesiredInstanceCount"|"DesiredWeight"|"DataCaptureConfig"
}
...
]
--deployment-config (структура)
Конфигурация развертывания для точки определения, которая содержит желаемую стратегию развертывания и конфигурации отката.
BlueGreenUpdatePolicy -> (структура)
Политика обновления для развертывания "синий/зеленый". Если эта политика обновления указана, SageMaker создаёт новый флот во время развертывания, сохраняя старый флот. SageMaker переключает трафик на новый флот в соответствии с указанной конфигурацией маршрутизации трафика. Только одна политика обновления должна использоваться в конфигурации развертывания. Если политика обновления не указана, SageMaker использует стратегию развертывания "синий/зеленый" с переключением всего трафика сразу по умолчанию.
TrafficRoutingConfiguration -> (структура)
Определяет стратегию маршрутизации трафика для переключения трафика со старого флота на новый во время развертывания точки определения.
Type -> (строка)
Тип стратегии маршрутизации трафика.
-
ALL_AT_ONCE: Трафик точки определения переключается на новый флот в одном шаге. -
CANARY: Трафик точки определения переключается на новый флот в двух шагах. Первый шаг — это "кандидат", небольшая часть трафика. Второй шаг — оставшаяся часть трафика. -
LINEAR: Трафик точки определения переключается на новый флот в n шагах заданного размера.
WaitIntervalInSeconds -> (целое число)
CanarySize -> (структура)
Размер пакета для первого шага по включению трафика на новый флот точки определения. Value должен быть меньше или равен 50% от общего количества экземпляров варианта.
Type -> (строка)
Указывает тип ёмкости точки определения.
-
INSTANCE_COUNT: Точка определения активируется на основе количества экземпляров. -
CAPACITY_PERCENT: Точка определения активируется на основе указанного процента ёмкости.
Value -> (целое число)
LinearStepSize -> (структура)
Размер пакета для каждого шага включения трафика на новый флот точки определения. Value должен составлять 10-50% от общего количества экземпляров варианта.
Type -> (строка)
Указывает тип ёмкости точки определения.
-
INSTANCE_COUNT: Точка определения активируется на основе количества экземпляров. -
CAPACITY_PERCENT: Точка определения активируется на основе указанного процента ёмкости.
Value -> (целое число)
TerminationWaitInSeconds -> (целое число)
MaximumExecutionTimeoutInSeconds -> (целое число)
TerminationWaitInSeconds и WaitIntervalInSeconds.RollingUpdatePolicy -> (структура)
Указывает стратегию развертывания "поэтапное обновление" для обновления точки определения SageMaker.
MaximumBatchSize -> (структура)
Размер пакета для каждого поэтапного шага развертывания ёмкости, включения трафика на новый флот точки определения и завершения ёмкости старого флота точки определения. Значение должно составлять от 5% до 50% от общего количества экземпляров варианта.
Type -> (строка)
Указывает тип ёмкости точки определения.
-
INSTANCE_COUNT: Точка определения активируется на основе количества экземпляров. -
CAPACITY_PERCENT: Точка определения активируется на основе указанного процента ёмкости.
Value -> (целое число)
WaitIntervalInSeconds -> (целое число)
MaximumExecutionTimeoutInSeconds -> (целое число)
RollbackMaximumBatchSize -> (структура)
Размер пакета для отката на старый флот точки определения. Каждый поэтапный шаг развертывания ёмкости, включения трафика на старый флот точки определения и завершения ёмкости нового флота точки определения. Если этот параметр отсутствует, значение по умолчанию будет установлено в 100% от общей ёмкости, что означает включение всей ёмкости старого флота сразу при откате.
Type -> (строка)
Указывает тип ёмкости точки определения.
-
INSTANCE_COUNT: Точка определения активируется на основе количества экземпляров. -
CAPACITY_PERCENT: Точка определения активируется на основе указанного процента ёмкости.
Value -> (целое число)
AutoRollbackConfiguration -> (структура)
Конфигурация автоматического отката для обработки сбоев развертывания точки определения и восстановления.
Alarms -> (список)
Список сигнализаций CloudWatch в вашей учётной записи, настроенных для мониторинга метрик точки определения. Если во время развертывания какие-либо сигнализации сработают, SageMaker откатит развертывание.
(структура)
Сигнализация Amazon CloudWatch, настроенная для мониторинга метрик точки определения.
AlarmName -> (строка)
Синтаксис JSON:
{
"BlueGreenUpdatePolicy": {
"TrafficRoutingConfiguration": {
"Type": "ALL_AT_ONCE"|"CANARY"|"LINEAR",
"WaitIntervalInSeconds": integer,
"CanarySize": {
"Type": "INSTANCE_COUNT"|"CAPACITY_PERCENT",
"Value": integer
},
"LinearStepSize": {
"Type": "INSTANCE_COUNT"|"CAPACITY_PERCENT",
"Value": integer
}
},
"TerminationWaitInSeconds": integer,
"MaximumExecutionTimeoutInSeconds": integer
},
"RollingUpdatePolicy": {
"MaximumBatchSize": {
"Type": "INSTANCE_COUNT"|"CAPACITY_PERCENT",
"Value": integer
},
"WaitIntervalInSeconds": integer,
"MaximumExecutionTimeoutInSeconds": integer,
"RollbackMaximumBatchSize": {
"Type": "INSTANCE_COUNT"|"CAPACITY_PERCENT",
"Value": integer
}
},
"AutoRollbackConfiguration": {
"Alarms": [
{
"AlarmName": "string"
}
...
]
}
}
--retain-deployment-config | --no-retain-deployment-config (логическое значение)
--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 (boolean)
Включить отладочную регистрацию.
--endpoint-url (string)
Переопределить URL по умолчанию команды заданным URL.
--no-verify-ssl (boolean)
По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.
--no-paginate (boolean)
Отключить автоматическую постраничность. Если автоматическая постраничность отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (string)
Стиль форматирования вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (string)
Запрос JMESPath для фильтрации данных ответа.
--profile (string)
Использовать определенный профиль из файла учетных данных.
--region (string)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (string)
Отобразить версию этого инструмента.
--color (string)
Включить/отключить цветной вывод.
- on
- off
- auto
--no-sign-request (boolean)
Не подписывать запросы. Учетные данные не будут загружены, если этот параметр указан.
--ca-bundle (string)
Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (int)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться без блокировки и без таймаута. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (int)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться без блокировки и без таймаута. Значение по умолчанию — 60 секунд.
--cli-binary-format (string)
Стиль форматирования, используемый для двоичных блоков. По умолчанию используется формат 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 (boolean)
Отключить вывод страницы CLI.
--cli-auto-prompt (boolean)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматическую запрос параметров ввода CLI.
Вывод
EndpointArn -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.