Spec-Zone.ru › AWS CLI v2

[ aws . pcs ]

create-cluster

Описание

Создаёт кластер в вашем аккаунте. Amazon Web Services PCS создаёт контроллер кластера в аккаунте, принадлежащем службе. Контроллер кластера взаимодействует с ресурсами кластера в вашем аккаунте. Подсети и группы безопасности для кластера должны быть созданы перед использованием этого действия API.

Примечание

У Amazon Web Services PCS требуется время для создания кластера. Кластер находится в состоянии Creating, пока он не готов к использованию. В одной области Amazon Web Services и в одном аккаунте Amazon Web Services может находиться только 1 кластер в состоянии Creating. CreateCluster завершается с ошибкой ServiceQuotaExceededException, если в данной области Amazon Web Services и в этом аккаунте Amazon Web Services уже существует кластер в состоянии Creating.

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

Синтаксис

  create-cluster
--cluster-name <value>
--scheduler <value>
--size <value>
--networking <value>
[--slurm-configuration <value>]
[--client-token <value>]
[--tags <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 (строка)

Имя для идентификации кластера. Пример: MyCluster

--scheduler (структура)

Программное обеспечение для управления кластером и планирования задач, связанное с кластером.

type -> (строка)

Программное обеспечение, которое Amazon Web Services PCS использует для управления масштабированием кластера и планированием задач.

version -> (строка)

Версия указанного программного обеспечения планирования, используемого Amazon Web Services PCS для управления масштабированием кластера и планированием задач. Дополнительную информацию см. в разделе «Версии Slurm в Amazon Web Services PCS» в руководстве пользователя Amazon Web Services PCS.

Допустимые значения: 23.11 | 24.05 | 24.11

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

type=string,version=string

Синтаксис JSON:

{
  "type": "SLURM",
  "version": "string"
}

--size (строка)

Значение, определяющее максимальное количество вычислительных узлов в кластере и максимальное количество задач (активных и в очереди).

  • SMALL : 32 вычислительных узла и 256 задач
  • MEDIUM : 512 вычислительных узлов и 8192 задачи
  • LARGE : 2048 вычислительных узлов и 16 384 задачи

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

  • SMALL
  • MEDIUM
  • LARGE

--networking (структура)

Конфигурация сети, используемая для настройки контрольной плоскости кластера.

subnetIds -> (список)

Список идентификаторов подсетей, в которых Amazon Web Services PCS создаёт интерфейс Elastic Network Interface (ENI) для обеспечения связи между управляемыми контроллерами и ресурсами Amazon Web Services PCS. Идентификаторы подсетей имеют вид subnet-0123456789abcdef0 .

Подсети не могут находиться в Outposts, Wavelength или в локальной зоне Amazon Web Services.

Примечание

В настоящее время Amazon Web Services PCS поддерживает только 1 подсеть в этом списке.

(строка)

securityGroupIds -> (список)

Список идентификаторов групп безопасности, связанных с интерфейсом Elastic Network Interface (ENI), созданным в подсетях.

(строка)

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

subnetIds=string,string,securityGroupIds=string,string

Синтаксис JSON:

{
  "subnetIds": ["string", ...],
  "securityGroupIds": ["string", ...]
}

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

Дополнительные параметры, связанные с планировщиком Slurm.

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

Время (в секундах) до того, как неактивный узел будет уменьшен.

Значение по умолчанию: 600

slurmCustomSettings -> (список)

Дополнительная конфигурация, специфичная для Slurm, которая напрямую соответствует настройкам Slurm.

(структура)

Дополнительные настройки, которые напрямую соответствуют настройкам Slurm.

parameterName -> (строка)

Amazon Web Services PCS поддерживает конфигурацию следующих параметров Slurm:

  • Для кластеров
    • `Prolog https://slurm.schedmd.com/slurm.conf.html#OPT_Prolog_1`__
    • `Epilog https://slurm.schedmd.com/slurm.conf.html#OPT_Epilog_1`__
    • `SelectTypeParameters https://slurm.schedmd.com/slurm.conf.html#OPT_SelectTypeParameters`__
  • Для групп вычислительных узлов
    • `Weight https://slurm.schedmd.com/slurm.conf.html#OPT_Weight`__
    • `RealMemory https://slurm.schedmd.com/slurm.conf.html#OPT_Weight`__

parameterValue -> (строка)

Значения для настроенных параметров Slurm.

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

Конфигурация учёта включает в себя настраиваемые параметры для учёта Slurm.

mode -> (строка)

Значение по умолчанию для mode — STANDARD. Значение STANDARD означает, что учёт Slurm включён.

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

Значение по умолчанию для всех параметров удаления для slurmdbd.conf. Дополнительную информацию см. в документации slurmdbd.conf на SchedMD.

Значение по умолчанию для defaultPurgeTimeInDays — -1.

Значение -1 означает, что время очистки не задано, и записи сохраняются до тех пор, пока существует кластер.

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

0 — недопустимое значение.

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

scaleDownIdleTimeInSeconds=integer,slurmCustomSettings=[{parameterName=string,parameterValue=string},{parameterName=string,parameterValue=string}],accounting={mode=string,defaultPurgeTimeInDays=integer}

Синтаксис JSON:

{
  "scaleDownIdleTimeInSeconds": integer,
  "slurmCustomSettings": [
    {
      "parameterName": "string",
      "parameterValue": "string"
    }
    ...
  ],
  "accounting": {
    "mode": "STANDARD"|"NONE",
    "defaultPurgeTimeInDays": integer
  }
}

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

Уникальный, чувствительный к регистру идентификатор, который вы предоставляете для обеспечения идемпотентности запроса. Идемпотентность гарантирует, что запрос API выполняется только один раз. С идемпотентным запросом, если исходный запрос завершен успешно, последующие повторные запросы с тем же маркером клиента возвращают результат от исходного успешного запроса и не оказывают дополнительного влияния. Если вы не указываете маркер клиента, CLI и SDK автоматически генерируют его для вас.

--tags (карта)

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

key -> (строка)

value -> (строка)

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

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"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 (логическое значение)

Включить отладовую запись журнала.

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

  • base64
  • raw-in-base64-out

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

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

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

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

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

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

Вывод

кластер -> (структура)

Ресурс кластера.

название -> (строка)

Имя, идентифицирующее кластер.

id -> (строка)

Сгенерированный уникальный идентификатор кластера.

arn -> (строка)

Уникальное Amazon Resource Name (ARN) кластера.

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

Статус подготовки кластера.

Примечание

Статус подготовки не отражает общее состояние кластера.

createdAt -> (метка времени)

Дата и время создания ресурса.

modifiedAt -> (метка времени)

Дата и время изменения ресурса.

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

Программное обеспечение для управления кластером и планирования задач, связанное с кластером.

тип -> (строка)

Программное обеспечение, которое Amazon Web Services PCS использует для управления масштабированием кластера и планирования задач.

версия -> (строка)

Версия указанного планирующего программного обеспечения, которое Amazon Web Services PCS использует для управления масштабированием кластера и планирования задач. Дополнительную информацию см. в разделе Версии Slurm в Amazon Web Services PCS в руководстве пользователя Amazon Web Services PCS.

Допустимые значения: 23.11 | 24.05 | 24.11

размер -> (строка)

Размер кластера.

  • SMALL : 32 вычислительных узла и 256 задач
  • MEDIUM : 512 вычислительных узлов и 8192 задачи
  • LARGE : 2048 вычислительных узлов и 16 384 задачи

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

Дополнительные параметры, связанные с планировщиком Slurm.

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

Время (в секундах) до того, как неактивный узел будет уменьшен в размерах.

По умолчанию: 600

slurmCustomSettings -> (список)

Дополнительная настройка Slurm, которая напрямую отображается в настройках Slurm.

(структура)

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

parameterName -> (строка)

Amazon Web Services PCS поддерживает настройку следующих параметров Slurm:

  • Для кластеров
    • `Prolog https://slurm.schedmd.com/slurm.conf.html#OPT_Prolog_1`__
    • `Epilog https://slurm.schedmd.com/slurm.conf.html#OPT_Epilog_1`__
    • `SelectTypeParameters https://slurm.schedmd.com/slurm.conf.html#OPT_SelectTypeParameters`__
  • Для групп вычислительных узлов
    • `Weight https://slurm.schedmd.com/slurm.conf.html#OPT_Weight`__
    • `RealMemory https://slurm.schedmd.com/slurm.conf.html#OPT_Weight`__

parameterValue -> (строка)

Значения настроенных параметров Slurm.

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

Общий ключ Slurm для аутентификации, также известный как секрет кластера.

secretArn -> (строка)

Amazon Resource Name (ARN) общего ключа Slurm.

secretVersion -> (строка)

Версия общего ключа Slurm.

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

Настройка учета включает настраиваемые параметры для учета Slurm.

режим -> (строка)

Значение по умолчанию для mode равно STANDARD . Значение STANDARD означает, что учет Slurm включен.

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

Значение по умолчанию для всех параметров очистки для slurmdbd.conf . Дополнительную информацию см. в документации slurmdbd.conf на SchedMD.

Значение по умолчанию для defaultPurgeTimeInDays равно -1.

Значение -1 означает, что время очистки отсутствует и записи сохраняются до тех пор, пока существует кластер.

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

0 не является допустимым значением.

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

Настройка сети для управляющей плоскости кластера.

subnetIds -> (список)

Идентификатор подсети, где Amazon Web Services PCS создает интерфейс Elastic Network Interface (ENI) для обеспечения связи между управляемыми контроллерами и ресурсами Amazon Web Services PCS. Подсеть должна иметь доступный IP-адрес, не должна находиться в AWS Outposts, AWS Wavelength или AWS Local Zone.

Пример: subnet-abcd1234

(строка)

securityGroupIds -> (список)

Список идентификаторов групп безопасности, связанных с интерфейсом Elastic Network Interface (ENI), созданным в подсетях.

Требуются следующие правила:

  • Правило входящего трафика 1
    • Протокол: Все
    • Порты: Все
    • Источник: Сам себя
  • Правило исходящего трафика 1
    • Протокол: Все
    • Порты: Все
    • Получатель: 0.0.0.0/0 (IPv4)
  • Правило исходящего трафика 2
    • Протокол: Все
    • Порты: Все
    • Получатель: Сам себя

(строка)

endpoints -> (список)

Список доступных конечных точек для взаимодействия с планировщиком.

(структура)

Конечная точка, доступная для взаимодействия с планировщиком.

тип -> (строка)

Указывает тип конечной точки, работающей по указанному IP-адресу.

privateIpAddress -> (строка)

Приватный IP-адрес конечной точки.

Пример: 2.2.2.2

publicIpAddress -> (строка)

Публичный IP-адрес конечной точки.

Пример: 1.1.1.1

port -> (строка)

Номер порта подключения конечной точки.

Пример: 1234

errorInfo -> (список)

Список ошибок, произошедших во время подготовки кластера.

(структура)

Ошибка, произошедшая во время создания ресурса.

код -> (строка)

Короткое кодовое обозначение ошибки.

сообщение -> (строка)

Подробная информация об ошибке.

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

Spec-Zone.ru

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