Spec-Zone.ru › AWS CLI v2

[ aws . sagemaker ]

обновить-кластер

Описание

Обновляет кластер SageMaker HyperPod.

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

Синтаксис

  update-cluster
--cluster-name <value>
--instance-groups <value>
[--node-recovery <value>]
[--instance-groups-to-delete <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]

Параметры

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

Укажите имя обновляемого кластера SageMaker HyperPod.

--instance-groups (список)

Укажите группы экземпляров для обновления.

(структура)

Технические характеристики группы экземпляров, которые необходимо определить.

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

Указывает количество экземпляров для добавления в группу экземпляров кластера SageMaker HyperPod.

InstanceGroupName -> (строка)

Указывает имя группы экземпляров.

InstanceType -> (строка)

Указывает тип экземпляра группы экземпляров.

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

Указывает конфигурацию LifeCycle для группы экземпляров.

SourceS3Uri -> (строка)

Путь к ведру Amazon S3, где хранятся ваши скрипты жизненного цикла.

Предупреждение

Убедитесь, что путь к ведру S3 начинается с s3://sagemaker-. Роль IAM для SageMaker HyperPod имеет прикреплённую управляемую роль ` AmazonSageMakerClusterInstanceRolePolicy https://docs.aws.amazon.com/sagemaker/latest/dg/security-iam-awsmanpol-cluster.html`__, которая позволяет получить доступ к ведрам S3 со специфическим префиксом sagemaker-.

OnCreate -> (строка)

Имя файла скрипта точки входа скриптов жизненного цикла в SourceS3Uri. Этот скрипт точки входа выполняется во время создания кластера.

ExecutionRole -> (строка)

Указывает роль выполнения IAM, которую должна принять группа экземпляров.

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

Указывает значение для Потоков на ядро. Для типов экземпляров, которые поддерживают многопоточность, вы можете указать 1 для отключения многопоточности и 2 для включения многопоточности. Для типов экземпляров, которые не поддерживают многопоточность, укажите 1. Дополнительную информацию см. в справочной таблице процессорных ядер и потоков на процессорное ядро на тип экземпляра в «Руководстве пользователя Amazon Elastic Compute Cloud».

InstanceStorageConfigs -> (список)

Указывает дополнительные конфигурации хранения для экземпляров в группе экземпляров кластера SageMaker HyperPod.

(структура с маркированным объединением)

Определяет конфигурацию для подключения дополнительного хранилища к экземплярам в группе экземпляров кластера SageMaker HyperPod. Дополнительную информацию см. в заметках к релизу SageMaker HyperPod: 20 июня 2024 г.

Примечание

Это структура с маркированным объединением. Только один из следующих верхних ключей может быть установлен: EbsVolumeConfig.

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

Определяет конфигурацию для подключения дополнительных томов Amazon Elastic Block Store (EBS) к экземплярам в группе экземпляров кластера SageMaker HyperPod. Дополнительный том EBS подключается к каждому экземпляру внутри группы экземпляров кластера SageMaker HyperPod и монтируется на /opt/sagemaker.

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

Размер дополнительного тома EBS в гигабайтах (ГБ), который необходимо подключить к экземплярам в группе экземпляров кластера SageMaker HyperPod. Дополнительный том EBS подключается к каждому экземпляру внутри группы экземпляров кластера SageMaker HyperPod и монтируется на /opt/sagemaker.

OnStartDeepHealthChecks -> (список)

Флаг, указывающий, следует ли выполнять глубокую проверку работоспособности при создании или обновлении группы экземпляров кластера.

(строка)

TrainingPlanArn -> (строка)

Идентификатор ресурса Amazon (ARN) плана обучения, который необходимо использовать для этой группы экземпляров кластера.

Дополнительную информацию о резервировании вычислительной мощности GPU для кластеров SageMaker HyperPod с помощью Amazon SageMaker Training Plan см. в разделе `` CreateTrainingPlan ``.

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

Для настройки многозонных развертываний настройте конфигурацию Amazon VPC на уровне группы экземпляров. Вы можете указать разные подсети и группы безопасности в разных зонах доступности в спецификации группы экземпляров, чтобы переопределить стандартную конфигурацию Amazon VPC кластера SageMaker HyperPod. Дополнительную информацию о развертывании кластера в нескольких зонах доступности см. в разделе Настройка кластеров SageMaker HyperPod в нескольких зонах доступности.

Примечание

Если ваша Amazon VPC и подсети поддерживают IPv6, сетевые коммуникации отличаются в зависимости от платформы оркестрации кластера:

  • Кластеры, оркестрированные с помощью Slurm, автоматически настраивают узлы с двойными адресами IPv6 и IPv4, что позволяет немедленно использовать сетевые коммуникации IPv6.
  • В кластерах, оркестрированных с помощью Amazon EKS, узлы получают адресацию двойного стека, но поддомены могут использовать IPv6 только в том случае, если кластер Amazon EKS явно настроен на IPv6. Дополнительную информацию о развертывании кластера Amazon EKS с IPv6 см. в разделе Развертывание кластера Amazon EKS с IPv6.

Дополнительные ресурсы для конфигурации IPv6:

  • Дополнительную информацию о добавлении поддержки IPv6 в вашу VPC см. в разделе Поддержка IPv6 для VPC.
  • Дополнительную информацию о создании новой совместимой с IPv6 VPC см. в разделе Руководство по созданию Amazon VPC.
  • Дополнительную информацию о настройке SageMaker HyperPod с настраиваемой Amazon VPC см. в разделе Настройка настраиваемой Amazon VPC для SageMaker HyperPod.

SecurityGroupIds -> (список)

Идентификаторы групп безопасности VPC в формате sg-xxxxxxxx. Укажите группы безопасности для VPC, указанной в поле Subnets.

(строка)

Subnets -> (список)

Идентификатор подсетей в VPC, к которым вы хотите подключить свою задачу обучения или модель. Дополнительную информацию о доступности определённых типов экземпляров см. в разделе Поддерживаемые типы экземпляров и зоны доступности.

(строка)

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

Объект конфигурации расписания, который SageMaker использует для обновления AMI.

ScheduleExpression -> (строка)

Выражение cron, которое задаёт расписание, по которому SageMaker обновляет AMI.

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

Конфигурация, используемая при обновлении версий AMI.

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

Политика, которую SageMaker использует при обновлении версий AMI кластера.

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

Максимальное количество экземпляров в кластере, которое SageMaker может обновить за один раз.

Type -> (строка)

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

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

Указывает количество или процент экземпляров, которые SageMaker обновляет за один раз.

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

Максимальное количество экземпляров в кластере, которое SageMaker может откатить за один раз.

Type -> (строка)

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

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

Указывает количество или процент экземпляров, которые SageMaker обновляет за один раз.

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

Время ожидания в секундах, которое SageMaker ожидает перед обновлением дополнительных экземпляров в кластере.

AutoRollbackConfiguration -> (список)

Массив, содержащий тревоги, которые SageMaker отслеживает, чтобы узнать, следует ли откатить обновление AMI.

(структура)

Подробности тревоги для отслеживания во время обновления AMI.

AlarmName -> (строка)

Название тревоги.

Синтаксис JSON:

[
  {
    "InstanceCount": integer,
    "InstanceGroupName": "string",
    "InstanceType": "ml.p4d.24xlarge"|"ml.p4de.24xlarge"|"ml.p5.48xlarge"|"ml.trn1.32xlarge"|"ml.trn1n.32xlarge"|"ml.g5.xlarge"|"ml.g5.2xlarge"|"ml.g5.4xlarge"|"ml.g5.8xlarge"|"ml.g5.12xlarge"|"ml.g5.16xlarge"|"ml.g5.24xlarge"|"ml.g5.48xlarge"|"ml.c5.large"|"ml.c5.xlarge"|"ml.c5.2xlarge"|"ml.c5.4xlarge"|"ml.c5.9xlarge"|"ml.c5.12xlarge"|"ml.c5.18xlarge"|"ml.c5.24xlarge"|"ml.c5n.large"|"ml.c5n.2xlarge"|"ml.c5n.4xlarge"|"ml.c5n.9xlarge"|"ml.c5n.18xlarge"|"ml.m5.large"|"ml.m5.xlarge"|"ml.m5.2xlarge"|"ml.m5.4xlarge"|"ml.m5.8xlarge"|"ml.m5.12xlarge"|"ml.m5.16xlarge"|"ml.m5.24xlarge"|"ml.t3.medium"|"ml.t3.large"|"ml.t3.xlarge"|"ml.t3.2xlarge"|"ml.g6.xlarge"|"ml.g6.2xlarge"|"ml.g6.4xlarge"|"ml.g6.8xlarge"|"ml.g6.16xlarge"|"ml.g6.12xlarge"|"ml.g6.24xlarge"|"ml.g6.48xlarge"|"ml.gr6.4xlarge"|"ml.gr6.8xlarge"|"ml.g6e.xlarge"|"ml.g6e.2xlarge"|"ml.g6e.4xlarge"|"ml.g6e.8xlarge"|"ml.g6e.16xlarge"|"ml.g6e.12xlarge"|"ml.g6e.24xlarge"|"ml.g6e.48xlarge"|"ml.p5e.48xlarge"|"ml.p5en.48xlarge"|"ml.trn2.48xlarge"|"ml.c6i.large"|"ml.c6i.xlarge"|"ml.c6i.2xlarge"|"ml.c6i.4xlarge"|"ml.c6i.8xlarge"|"ml.c6i.12xlarge"|"ml.c6i.16xlarge"|"ml.c6i.24xlarge"|"ml.c6i.32xlarge"|"ml.m6i.large"|"ml.m6i.xlarge"|"ml.m6i.2xlarge"|"ml.m6i.4xlarge"|"ml.m6i.8xlarge"|"ml.m6i.12xlarge"|"ml.m6i.16xlarge"|"ml.m6i.24xlarge"|"ml.m6i.32xlarge"|"ml.r6i.large"|"ml.r6i.xlarge"|"ml.r6i.2xlarge"|"ml.r6i.4xlarge"|"ml.r6i.8xlarge"|"ml.r6i.12xlarge"|"ml.r6i.16xlarge"|"ml.r6i.24xlarge"|"ml.r6i.32xlarge"|"ml.i3en.large"|"ml.i3en.xlarge"|"ml.i3en.2xlarge"|"ml.i3en.3xlarge"|"ml.i3en.6xlarge"|"ml.i3en.12xlarge"|"ml.i3en.24xlarge"|"ml.m7i.large"|"ml.m7i.xlarge"|"ml.m7i.2xlarge"|"ml.m7i.4xlarge"|"ml.m7i.8xlarge"|"ml.m7i.12xlarge"|"ml.m7i.16xlarge"|"ml.m7i.24xlarge"|"ml.m7i.48xlarge"|"ml.r7i.large"|"ml.r7i.xlarge"|"ml.r7i.2xlarge"|"ml.r7i.4xlarge"|"ml.r7i.8xlarge"|"ml.r7i.12xlarge"|"ml.r7i.16xlarge"|"ml.r7i.24xlarge"|"ml.r7i.48xlarge",
    "LifeCycleConfig": {
      "SourceS3Uri": "string",
      "OnCreate": "string"
    },
    "ExecutionRole": "string",
    "ThreadsPerCore": integer,
    "InstanceStorageConfigs": [
      {
        "EbsVolumeConfig": {
          "VolumeSizeInGB": integer
        }
      }
      ...
    ],
    "OnStartDeepHealthChecks": ["InstanceStress"|"InstanceConnectivity", ...],
    "TrainingPlanArn": "string",
    "OverrideVpcConfig": {
      "SecurityGroupIds": ["string", ...],
      "Subnets": ["string", ...]
    },
    "ScheduledUpdateConfig": {
      "ScheduleExpression": "string",
      "DeploymentConfig": {
        "RollingUpdatePolicy": {
          "MaximumBatchSize": {
            "Type": "INSTANCE_COUNT"|"CAPACITY_PERCENTAGE",
            "Value": integer
          },
          "RollbackMaximumBatchSize": {
            "Type": "INSTANCE_COUNT"|"CAPACITY_PERCENTAGE",
            "Value": integer
          }
        },
        "WaitIntervalInSeconds": integer,
        "AutoRollbackConfiguration": [
          {
            "AlarmName": "string"
          }
          ...
        ]
      }
    }
  }
  ...
]

--node-recovery (строка)

Режим восстановления узлов для применения к кластеру SageMaker HyperPod.

Возможные значения:

  • Automatic
  • None

--instance-groups-to-delete (список)

Укажите имена групп экземпляров для удаления. Используйте единственную , в качестве разделителя между несколькими именами.

(строка)

Синтаксис:

"string" "string" ...

--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)

Файл с корневым сертификатом для проверки 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 версии 1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку, 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.

Вывод

ClusterArn -> (string)

Amazon Resource Name (ARN) обновленного кластера SageMaker HyperPod.

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

Spec-Zone.ru

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