Spec-Zone.ru › AWS CLI v2

[ aws . deadline ]

обновить-флот

Описание

Обновляет флот.

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

Синопсис

  update-fleet
[--client-token <value>]
--farm-id <value>
--fleet-id <value>
[--display-name <value>]
[--description <value>]
[--role-arn <value>]
[--min-worker-count <value>]
[--max-worker-count <value>]
[--configuration <value>]
[--host-configuration <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]

Параметры

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

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

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

Идентификатор фермы для обновления.

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

Идентификатор флота для обновления.

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

Имя для отображения флота для обновления.

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

Это поле может хранить любой контент. Преобразуйте или закодируйте этот контент перед отображением на веб-странице или любой другой системе, которая может интерпретировать содержимое этого поля.

--description (строка)

Описание флота для обновления.

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

Это поле может хранить любой контент. Преобразуйте или закодируйте этот контент перед отображением на веб-странице или любой другой системе, которая может интерпретировать содержимое этого поля.

--role-arn (строка)

ARN роли IAM, которую рабочие флота используют во время выполнения задач.

--min-worker-count (целое число)

Минимальное количество рабочих в флоте.

--max-worker-count (целое число)

Максимальное количество рабочих в флоте.

Deadline Cloud ограничивает количество рабочих значением, меньшим или равным максимальному количеству рабочих в флоте. Сервис поддерживает конечную согласованность для количества рабочих. Если вы выполните несколько быстрых вызовов CreateWorker, прежде чем поле обновится, вы можете превысить максимальное количество рабочих в флоте. Например, если ваш maxWorkerCount равен 10, а в настоящее время у вас 9 рабочих, два быстрых вызова CreateWorker могут успешно создать 2 рабочих вместо 1, что приведет к общему количеству рабочих 11.

--configuration (структура помеченного объединения)

Конфигурация флота для обновления.

Примечание

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

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

Флоты, управляемые клиентом, в рамках конфигурации флота.

mode -> (строка)

Режим автоматического масштабирования для конфигурации флота, управляемого клиентом.

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

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

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

Количество vCPU для возможностей рабочих, управляемых клиентом.

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

Минимальное количество vCPU.

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

Максимальное количество vCPU.

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

Память (MiB).

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

Минимальный объем памяти (в MiB).

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

Максимальный объем памяти (в MiB).

acceleratorTypes -> (список)

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

(строка)

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

Диапазон ускорителя.

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

Минимальное количество ускорителей GPU в хосте рабочего.

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

Максимальное количество ускорителей GPU в хосте рабочего.

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

Общий объем памяти (MiB) для возможностей рабочих, управляемых клиентом.

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

Минимальный объем памяти для использования ускорителя, измеряемый в MiB.

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

Максимальный объем памяти для использования ускорителя, измеряемый в MiB.

osFamily -> (строка)

Семейство операционной системы (ОС).

cpuArchitectureType -> (строка)

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

customAmounts -> (список)

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

(структура)

Количество и атрибуты возможностей флота.

name -> (строка)

Имя возможности флота.

min -> (вещественное число)

Минимальное количество возможностей рабочих флота.

max -> (вещественное число)

Максимальное количество возможностей рабочих флота.

customAttributes -> (список)

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

(структура)

Определяет имя возможности флота, минимум и максимум.

name -> (строка)

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

values -> (список)

Количество атрибутов возможностей флота.

(строка)

storageProfileId -> (строка)

Идентификатор профиля хранения.

tagPropagationMode -> (строка)

Указывает, прикрепляются ли теги, связанные с флотом, к рабочим во время запуска рабочего.

Если tagPropagationMode установлен на PROPAGATE_TAGS_TO_WORKERS_AT_LAUNCH, все теги, связанные с флотом, прикрепляются к рабочим при их запуске. Если теги флота изменяются, теги, связанные с работающими рабочими, не изменяются.

Если tagPropagationMode не указан, значение по умолчанию равно NO_PROPAGATION.

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

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

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

Возможности экземпляров Amazon EC2.

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

Количество vCPU, требуемое для экземпляров в этом флоте.

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

Минимальное количество vCPU.

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

Максимальное количество vCPU.

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

Объем памяти в MiB для типа экземпляра Amazon EC2.

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

Минимальный объем памяти (в MiB).

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

Максимальный объем памяти (в MiB).

osFamily -> (строка)

Семейство операционной системы (ОС).

cpuArchitectureType -> (строка)

Тип архитектуры процессора.

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

Основной том EBS.

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

Размер тома EBS в GiB.

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

IOPS на том.

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

Пропускная способность на том в MiB.

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

Описание возможностей ускорителя GPU, необходимых для хостов рабочих экземпляров в этом флоте.

selections -> (список)

Список возможностей ускорителей GPU, запрошенных для этого флота. Будут использоваться только экземпляры Amazon Elastic Compute Cloud, предоставляющие эти возможности. Например, если вы укажете как L4, так и T4 чипы, Deadline Cloud будет использовать экземпляры Amazon EC2, у которых установлен либо чип L4, либо T4.

(структура)

Описание конкретного ускорителя GPU, требуемого для хоста рабочего Amazon Elastic Compute Cloud.

name -> (строка)

Имя чипа, используемого ускорителем GPU.

Если вы укажете l4 как имя ускорителя, вы должны указать latest или grid:r550 как среду выполнения.

Доступные ускорители GPU:

  • t4 - NVIDIA T4 Tensor Core GPU
  • a10g - NVIDIA A10G Tensor Core GPU
  • l4 - NVIDIA L4 Tensor Core GPU
  • l40s - NVIDIA L40S Tensor Core GPU

runtime -> (строка)

Указывает драйвер среды выполнения для ускорителя GPU. Вы должны использовать одну и ту же среду выполнения для всех GPU.

Вы можете выбрать следующие среды выполнения:

  • latest - Используйте последнюю доступную среду выполнения для чипа. Если вы укажете latest, а новая версия среды выполнения будет выпущена, будет использоваться новая версия среды выполнения.
  • grid:r550 - NVIDIA vGPU программное обеспечение 17
  • grid:r535 - NVIDIA vGPU программное обеспечение 16

Если вы не укажете среду выполнения, Deadline Cloud использует latest в качестве значения по умолчанию. Однако, если у вас несколько ускорителей и вы укажете latest для некоторых и оставите другие пустыми, Deadline Cloud выведет исключение.

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

Количество ускорителей GPU, указанных для хостов рабочих в этом флоте.

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

Минимальное количество ускорителей GPU в хосте рабочего.

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

Максимальное количество ускорителей GPU в хосте рабочего.

allowedInstanceTypes -> (список)

Допустимые типы экземпляров Amazon EC2.

(строка)

excludedInstanceTypes -> (список)

Типы экземпляров, которые нужно исключить из флота.

(строка)

customAmounts -> (список)

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

(структура)

Количество и атрибуты возможностей флота.

name -> (строка)

Имя возможности флота.

min -> (вещественное число)

Минимальное количество возможностей рабочих флота.

max -> (вещественное число)

Максимальное количество возможностей рабочих флота.

customAttributes -> (список)

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

(структура)

Определяет имя возможности флота, минимум и максимум.

name -> (строка)

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

values -> (список)

Количество атрибутов возможностей флота.

(строка)

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

Тип рынка Amazon EC2.

type -> (строка)

Тип экземпляра Amazon EC2.

Синтаксис JSON:

{
  "customerManaged": {
    "mode": "NO_SCALING"|"EVENT_BASED_AUTO_SCALING",
    "workerCapabilities": {
      "vCpuCount": {
        "min": integer,
        "max": integer
      },
      "memoryMiB": {
        "min": integer,
        "max": integer
      },
      "acceleratorTypes": ["gpu", ...],
      "acceleratorCount": {
        "min": integer,
        "max": integer
      },
      "acceleratorTotalMemoryMiB": {
        "min": integer,
        "max": integer
      },
      "osFamily": "WINDOWS"|"LINUX"|"MACOS",
      "cpuArchitectureType": "x86_64"|"arm64",
      "customAmounts": [
        {
          "name": "string",
          "min": float,
          "max": float
        }
        ...
      ],
      "customAttributes": [
        {
          "name": "string",
          "values": ["string", ...]
        }
        ...
      ]
    },
    "storageProfileId": "string",
    "tagPropagationMode": "NO_PROPAGATION"|"PROPAGATE_TAGS_TO_WORKERS_AT_LAUNCH"
  },
  "serviceManagedEc2": {
    "instanceCapabilities": {
      "vCpuCount": {
        "min": integer,
        "max": integer
      },
      "memoryMiB": {
        "min": integer,
        "max": integer
      },
      "osFamily": "WINDOWS"|"LINUX",
      "cpuArchitectureType": "x86_64"|"arm64",
      "rootEbsVolume": {
        "sizeGiB": integer,
        "iops": integer,
        "throughputMiB": integer
      },
      "acceleratorCapabilities": {
        "selections": [
          {
            "name": "t4"|"a10g"|"l4"|"l40s",
            "runtime": "string"
          }
          ...
        ],
        "count": {
          "min": integer,
          "max": integer
        }
      },
      "allowedInstanceTypes": ["string", ...],
      "excludedInstanceTypes": ["string", ...],
      "customAmounts": [
        {
          "name": "string",
          "min": float,
          "max": float
        }
        ...
      ],
      "customAttributes": [
        {
          "name": "string",
          "values": ["string", ...]
        }
        ...
      ]
    },
    "instanceMarketOptions": {
      "type": "on-demand"|"spot"
    }
  }
}

--host-configuration (структура)

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

scriptBody -> (строка)

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

Дополнительную информацию об использовании скрипта см. в разделе Запуск скриптов администратором для настройки рабочих в Руководстве разработчика Deadline Cloud.

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

Скрипт выполняется как пользователь администратора (sudo root в Linux, как Администратор в Windows).

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

Максимальное время, в течение которого может выполняться конфигурация хоста. Если таймаут истекает, рабочий переходит в состояние NOT RESPONDING и завершается. Вы оплачиваете время, в течение которого рабочий выполняет скрипт конфигурации хоста.

Примечание

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

Значение по умолчанию составляет 300 секунд (5 минут).

Упрощенный синтаксис:

scriptBody=string,scriptTimeoutSeconds=integer

Синтаксис JSON:

{
  "scriptBody": "string",
  "scriptTimeoutSeconds": integer
}

--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
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • включено
  • выключено
  • автоматически

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

Вывод

Нет

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

Spec-Zone.ru

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