Spec-Zone.ru › AWS CLI v2

[ aws . sagemaker ]

create-notebook-instance

Описание

Создает экземпляр Jupyter-тетради SageMaker AI. Экземпляр тетради — это вычислительный экземпляр машинного обучения (ML), работающий в Jupyter notebook.

В запросе укажите тип вычислительного экземпляра ML, который вы хотите запустить. SageMaker AI запускает экземпляр, устанавливает общие библиотеки, которые можно использовать для исследования наборов данных для обучения модели, и подключает объем ML-хранилища к экземпляру Jupyter-тетради.

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

После получения запроса SageMaker AI выполняет следующие действия:

  • Создает сетевой интерфейс в VPC SageMaker AI.
  • (Необязательно) Если вы указали SubnetId, SageMaker AI создает сетевой интерфейс в вашей собственной VPC, которая определяется по идентификатору подсети, предоставленному в входных данных. При создании этого сетевого интерфейса SageMaker AI присоединяет указанную в запросе группу безопасности к сетевому интерфейсу, который он создает в вашей VPC.
  • Запускает EC2-экземпляр указанного в запросе типа в VPC SageMaker AI. Если вы указали SubnetId вашей VPC, SageMaker AI указывает оба сетевых интерфейса при запуске этого экземпляра. Это позволяет входящий трафик из вашей собственной VPC в экземпляр Jupyter-тетради, при условии, что группы безопасности это разрешают.

После создания экземпляра Jupyter-тетради SageMaker AI возвращает его Amazon Resource Name (ARN). Вы не можете изменить имя экземпляра Jupyter-тетради после его создания.

После того, как SageMaker AI создаст экземпляр Jupyter-тетради, вы сможете подключиться к серверу Jupyter и работать в Jupyter-тетрадях. Например, вы можете написать код для исследования набора данных, который можно использовать для обучения модели, обучить модель, разместить модели, создав SageMaker AI-эндпоинты, и проверить размещенные модели.

Дополнительную информацию см. в разделе Как это работает.

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

Синтаксис

  create-notebook-instance
--notebook-instance-name <value>
--instance-type <value>
[--subnet-id <value>]
[--security-group-ids <value>]
--role-arn <value>
[--kms-key-id <value>]
[--tags <value>]
[--lifecycle-config-name <value>]
[--direct-internet-access <value>]
[--volume-size-in-gb <value>]
[--accelerator-types <value>]
[--default-code-repository <value>]
[--additional-code-repositories <value>]
[--root-access <value>]
[--platform-identifier <value>]
[--instance-metadata-service-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]

Параметры

--notebook-instance-name (строка)

Имя новой инстанции ноутбука.

--instance-type (строка)

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

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

  • ml.t2.medium
  • ml.t2.large
  • ml.t2.xlarge
  • ml.t2.2xlarge
  • ml.t3.medium
  • ml.t3.large
  • ml.t3.xlarge
  • ml.t3.2xlarge
  • ml.m4.xlarge
  • ml.m4.2xlarge
  • ml.m4.4xlarge
  • ml.m4.10xlarge
  • ml.m4.16xlarge
  • ml.m5.xlarge
  • ml.m5.2xlarge
  • ml.m5.4xlarge
  • ml.m5.12xlarge
  • ml.m5.24xlarge
  • ml.m5d.large
  • ml.m5d.xlarge
  • ml.m5d.2xlarge
  • ml.m5d.4xlarge
  • ml.m5d.8xlarge
  • ml.m5d.12xlarge
  • ml.m5d.16xlarge
  • ml.m5d.24xlarge
  • ml.c4.xlarge
  • ml.c4.2xlarge
  • ml.c4.4xlarge
  • ml.c4.8xlarge
  • ml.c5.xlarge
  • ml.c5.2xlarge
  • ml.c5.4xlarge
  • ml.c5.9xlarge
  • ml.c5.18xlarge
  • ml.c5d.xlarge
  • ml.c5d.2xlarge
  • ml.c5d.4xlarge
  • ml.c5d.9xlarge
  • ml.c5d.18xlarge
  • ml.p2.xlarge
  • ml.p2.8xlarge
  • ml.p2.16xlarge
  • ml.p3.2xlarge
  • ml.p3.8xlarge
  • ml.p3.16xlarge
  • ml.p3dn.24xlarge
  • ml.g4dn.xlarge
  • ml.g4dn.2xlarge
  • ml.g4dn.4xlarge
  • ml.g4dn.8xlarge
  • ml.g4dn.12xlarge
  • ml.g4dn.16xlarge
  • ml.r5.large
  • ml.r5.xlarge
  • ml.r5.2xlarge
  • ml.r5.4xlarge
  • ml.r5.8xlarge
  • ml.r5.12xlarge
  • ml.r5.16xlarge
  • ml.r5.24xlarge
  • ml.g5.xlarge
  • ml.g5.2xlarge
  • ml.g5.4xlarge
  • ml.g5.8xlarge
  • ml.g5.16xlarge
  • ml.g5.12xlarge
  • ml.g5.24xlarge
  • ml.g5.48xlarge
  • ml.inf1.xlarge
  • ml.inf1.2xlarge
  • ml.inf1.6xlarge
  • ml.inf1.24xlarge
  • ml.trn1.2xlarge
  • ml.trn1.32xlarge
  • ml.trn1n.32xlarge
  • ml.inf2.xlarge
  • ml.inf2.8xlarge
  • ml.inf2.24xlarge
  • ml.inf2.48xlarge
  • ml.p4d.24xlarge
  • ml.p4de.24xlarge
  • ml.p5.48xlarge
  • 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.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.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.c7i.large
  • ml.c7i.xlarge
  • ml.c7i.2xlarge
  • ml.c7i.4xlarge
  • ml.c7i.8xlarge
  • ml.c7i.12xlarge
  • ml.c7i.16xlarge
  • ml.c7i.24xlarge
  • ml.c7i.48xlarge
  • 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.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
  • ml.m6id.large
  • ml.m6id.xlarge
  • ml.m6id.2xlarge
  • ml.m6id.4xlarge
  • ml.m6id.8xlarge
  • ml.m6id.12xlarge
  • ml.m6id.16xlarge
  • ml.m6id.24xlarge
  • ml.m6id.32xlarge
  • ml.c6id.large
  • ml.c6id.xlarge
  • ml.c6id.2xlarge
  • ml.c6id.4xlarge
  • ml.c6id.8xlarge
  • ml.c6id.12xlarge
  • ml.c6id.16xlarge
  • ml.c6id.24xlarge
  • ml.c6id.32xlarge
  • ml.r6id.large
  • ml.r6id.xlarge
  • ml.r6id.2xlarge
  • ml.r6id.4xlarge
  • ml.r6id.8xlarge
  • ml.r6id.12xlarge
  • ml.r6id.16xlarge
  • ml.r6id.24xlarge
  • ml.r6id.32xlarge
  • ml.g6.xlarge
  • ml.g6.2xlarge
  • ml.g6.4xlarge
  • ml.g6.8xlarge
  • ml.g6.12xlarge
  • ml.g6.16xlarge
  • ml.g6.24xlarge
  • ml.g6.48xlarge

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

Идентификатор подсети в VPC, к которой вы хотите обеспечить подключение с вашей ML вычислительной инстанции.

--security-group-ids (список)

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

(строка)

Синтаксис:

"string" "string" ...

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

При отправке запросов в ресурсы Amazon Web Services из инстанции ноутбука, SageMaker AI предполагает эту роль для выполнения задач от вашего имени. Вы должны предоставить этой роли необходимые разрешения, чтобы SageMaker AI мог выполнять эти задачи. Политика должна разрешать службе SageMaker AI (sagemaker.amazonaws.com) разрешение на принятие этой роли. Подробнее см. SageMaker AI Roles.

Примечание

Чтобы передать эту роль SageMaker AI, вызывающий эту API должен иметь разрешение iam:PassRole.

--kms-key-id (строка)

Идентификатор Amazon Resource Name (ARN) ключа службы управления ключами Amazon Web Services, который SageMaker AI использует для шифрования данных на томе хранения, подключенном к вашей инстанции ноутбука. Предоставляемый вами ключ KMS должен быть включен. Дополнительная информация приведена в разделе Включение и выключение ключей в Руководстве разработчика Amazon Web Services Key Management Service.

--tags (список)

Массив пар ключ-значение. Вы можете использовать теги для категоризации ресурсов Amazon Web Services различными способами, например, по назначению, владельцу или среде. Дополнительная информация приведена в разделе Помечение ресурсов Amazon Web Services.

(структура)

Объект тега, состоящий из ключа и необязательного значения, используемый для управления метаданными для ресурсов SageMaker Amazon Web Services.

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

Дополнительная информация о добавлении метаданных к ресурсам Amazon Web Services с помощью тегов приведена в разделе Помечение ресурсов Amazon Web Services. Советы по лучшим практикам управления ресурсами Amazon Web Services с помощью тегов см. в разделе Лучшие практики по тегам: реализация эффективной стратегии тегирования ресурсов Amazon Web Services.

Ключ -> (строка)

Ключ тега. Ключи тегов должны быть уникальными для каждого ресурса.

Значение -> (строка)

Значение тега.

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

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

--lifecycle-config-name (строка)

Имя конфигурации жизненного цикла для ассоциации с инстанцией ноутбука. Дополнительную информацию о конфигурациях жизненного цикла см. в шаге 2.1: (необязательно) Настройка инстанции ноутбука.

--direct-internet-access (строка)

Устанавливает, предоставляет ли SageMaker AI доступ к интернету для инстанции ноутбука. Если вы устанавливаете это значение в Disabled, эта инстанция ноутбука может получать доступ только к ресурсам в вашей VPC и не сможет подключиться к SageMaker AI обучения и сервисам конечных точек, если вы не настроите шлюз NAT в вашей VPC.

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

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

  • Enabled
  • Disabled

--volume-size-in-gb (целое число)

Размер тома ML-хранилища в ГБ для подключения к инстанции ноутбука. Значение по умолчанию — 5 ГБ.

--accelerator-types (список)

Этот параметр больше не поддерживается. Elastic Inference (EI) больше не доступен.

Этот параметр использовался для указания списка типов экземпляров EI для ассоциации с этой инстанцией ноутбука.

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  ml.eia1.medium
  ml.eia1.large
  ml.eia1.xlarge
  ml.eia2.medium
  ml.eia2.large
  ml.eia2.xlarge

--default-code-repository (строка)

Репозиторий Git, который необходимо связать с инстанцией ноутбука в качестве ее репозитория кода по умолчанию. Это может быть имя репозитория Git, хранящегося как ресурс в вашей учетной записи, или URL-адрес репозитория Git в Amazon Web Services CodeCommit или любом другом репозитории Git. При открытии инстанции ноутбука она открывается в каталоге, содержащем этот репозиторий. Дополнительная информация приведена в разделе Связывание репозиториев Git с инстанциями ноутбуков SageMaker AI.

--additional-code-repositories (список)

Массив из не более чем трех репозиториев Git для ассоциации с инстанцией ноутбука. Это могут быть либо имена репозиториев Git, хранящихся как ресурсы в вашей учетной записи, либо URL-адреса репозиториев Git в Amazon Web Services CodeCommit или любом другом репозитории Git. Эти репозитории клонируются на одном уровне с репозиторием по умолчанию вашей инстанции ноутбука. Дополнительная информация приведена в разделе Связывание репозиториев Git с инстанциями ноутбуков SageMaker AI.

(строка)

Синтаксис:

"string" "string" ...

--root-access (строка)

Включен или выключен доступ к корневому уровню для пользователей экземпляра блокнота. Значение по умолчанию — Enabled.

Примечание

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

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

  • Enabled
  • Disabled

--platform-identifier (строка)

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

--instance-metadata-service-configuration (структура)

Информация о конфигурации IMDS экземпляра блокнота

MinimumInstanceMetadataServiceVersion -> (строка)

Указывает минимальную версию IMDS, поддерживаемую экземпляром блокнота. При передаче в рамках CreateNotebookInstance, если значение не выбрано, оно по умолчанию устанавливается в IMDSv1. Это означает, что поддерживаются как IMDSv1, так и IMDSv2. Если передается в рамках UpdateNotebookInstance, по умолчанию ничего нет.

Сокращенная синтаксическая запись:

MinimumInstanceMetadataServiceVersion=string

Синтаксис JSON:

{
  "MinimumInstanceMetadataServiceVersion": "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 для вывода.

--cli-auto-prompt (булево)

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

--no-cli-auto-prompt (булево)

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

Вывод

NotebookInstanceArn -> (строка)

Amazon Resource Name (ARN) экземпляра блокнота.

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

Spec-Zone.ru

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