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.mediumml.t2.largeml.t2.xlargeml.t2.2xlargeml.t3.mediumml.t3.largeml.t3.xlargeml.t3.2xlargeml.m4.xlargeml.m4.2xlargeml.m4.4xlargeml.m4.10xlargeml.m4.16xlargeml.m5.xlargeml.m5.2xlargeml.m5.4xlargeml.m5.12xlargeml.m5.24xlargeml.m5d.largeml.m5d.xlargeml.m5d.2xlargeml.m5d.4xlargeml.m5d.8xlargeml.m5d.12xlargeml.m5d.16xlargeml.m5d.24xlargeml.c4.xlargeml.c4.2xlargeml.c4.4xlargeml.c4.8xlargeml.c5.xlargeml.c5.2xlargeml.c5.4xlargeml.c5.9xlargeml.c5.18xlargeml.c5d.xlargeml.c5d.2xlargeml.c5d.4xlargeml.c5d.9xlargeml.c5d.18xlargeml.p2.xlargeml.p2.8xlargeml.p2.16xlargeml.p3.2xlargeml.p3.8xlargeml.p3.16xlargeml.p3dn.24xlargeml.g4dn.xlargeml.g4dn.2xlargeml.g4dn.4xlargeml.g4dn.8xlargeml.g4dn.12xlargeml.g4dn.16xlargeml.r5.largeml.r5.xlargeml.r5.2xlargeml.r5.4xlargeml.r5.8xlargeml.r5.12xlargeml.r5.16xlargeml.r5.24xlargeml.g5.xlargeml.g5.2xlargeml.g5.4xlargeml.g5.8xlargeml.g5.16xlargeml.g5.12xlargeml.g5.24xlargeml.g5.48xlargeml.inf1.xlargeml.inf1.2xlargeml.inf1.6xlargeml.inf1.24xlargeml.trn1.2xlargeml.trn1.32xlargeml.trn1n.32xlargeml.inf2.xlargeml.inf2.8xlargeml.inf2.24xlargeml.inf2.48xlargeml.p4d.24xlargeml.p4de.24xlargeml.p5.48xlargeml.m6i.largeml.m6i.xlargeml.m6i.2xlargeml.m6i.4xlargeml.m6i.8xlargeml.m6i.12xlargeml.m6i.16xlargeml.m6i.24xlargeml.m6i.32xlargeml.m7i.largeml.m7i.xlargeml.m7i.2xlargeml.m7i.4xlargeml.m7i.8xlargeml.m7i.12xlargeml.m7i.16xlargeml.m7i.24xlargeml.m7i.48xlargeml.c6i.largeml.c6i.xlargeml.c6i.2xlargeml.c6i.4xlargeml.c6i.8xlargeml.c6i.12xlargeml.c6i.16xlargeml.c6i.24xlargeml.c6i.32xlargeml.c7i.largeml.c7i.xlargeml.c7i.2xlargeml.c7i.4xlargeml.c7i.8xlargeml.c7i.12xlargeml.c7i.16xlargeml.c7i.24xlargeml.c7i.48xlargeml.r6i.largeml.r6i.xlargeml.r6i.2xlargeml.r6i.4xlargeml.r6i.8xlargeml.r6i.12xlargeml.r6i.16xlargeml.r6i.24xlargeml.r6i.32xlargeml.r7i.largeml.r7i.xlargeml.r7i.2xlargeml.r7i.4xlargeml.r7i.8xlargeml.r7i.12xlargeml.r7i.16xlargeml.r7i.24xlargeml.r7i.48xlargeml.m6id.largeml.m6id.xlargeml.m6id.2xlargeml.m6id.4xlargeml.m6id.8xlargeml.m6id.12xlargeml.m6id.16xlargeml.m6id.24xlargeml.m6id.32xlargeml.c6id.largeml.c6id.xlargeml.c6id.2xlargeml.c6id.4xlargeml.c6id.8xlargeml.c6id.12xlargeml.c6id.16xlargeml.c6id.24xlargeml.c6id.32xlargeml.r6id.largeml.r6id.xlargeml.r6id.2xlargeml.r6id.4xlargeml.r6id.8xlargeml.r6id.12xlargeml.r6id.16xlargeml.r6id.24xlargeml.r6id.32xlargeml.g6.xlargeml.g6.2xlargeml.g6.4xlargeml.g6.8xlargeml.g6.12xlargeml.g6.16xlargeml.g6.24xlargeml.g6.48xlarge
--subnet-id (строка)
--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 (строка)
--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 (строка)
--direct-internet-access (строка)
Устанавливает, предоставляет ли SageMaker AI доступ к интернету для инстанции ноутбука. Если вы устанавливаете это значение в Disabled, эта инстанция ноутбука может получать доступ только к ресурсам в вашей VPC и не сможет подключиться к SageMaker AI обучения и сервисам конечных точек, если вы не настроите шлюз NAT в вашей VPC.
Дополнительная информация приведена в разделе Инстанции ноутбуков по умолчанию имеют доступ к интернету. Вы можете установить значение этого параметра в Disabled только в случае, если вы задали значение для параметра SubnetId.
Возможные значения:
EnabledDisabled
--volume-size-in-gb (целое число)
--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 (строка)
--additional-code-repositories (список)
Массив из не более чем трех репозиториев Git для ассоциации с инстанцией ноутбука. Это могут быть либо имена репозиториев Git, хранящихся как ресурсы в вашей учетной записи, либо URL-адреса репозиториев Git в Amazon Web Services CodeCommit или любом другом репозитории Git. Эти репозитории клонируются на одном уровне с репозиторием по умолчанию вашей инстанции ноутбука. Дополнительная информация приведена в разделе Связывание репозиториев Git с инстанциями ноутбуков SageMaker AI.
(строка)
Синтаксис:
"string" "string" ...
--root-access (строка)
Включен или выключен доступ к корневому уровню для пользователей экземпляра блокнота. Значение по умолчанию — Enabled.
Примечание
Конфигурации жизненного цикла нуждаются в доступе к корневому уровню для настройки экземпляра блокнота. По этой причине конфигурации жизненного цикла, связанные с экземпляром блокнота, всегда выполняются с доступом к корневому уровню, даже если вы отключите доступ к корневому уровню для пользователей.Возможные значения:
EnabledDisabled
--platform-identifier (строка)
--instance-metadata-service-configuration (структура)
Информация о конфигурации IMDS экземпляра блокнота
MinimumInstanceMetadataServiceVersion -> (строка)
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 -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.