Связаться с намиПодключиться

Изменить виртуальную машину

Статья создана
Обновлена 2 ноября 2024 г.

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

Как изменить конфигурацию ВМ, читайте в разделе Изменить вычислительные ресурсы виртуальной машины.

Чтобы изменить ВМ:

  1. В консоли управления выберите каталог, которому принадлежит ВМ.
  2. Выберите сервис Compute Cloud.
  3. На панели слева выберите Виртуальные машины и нажмите на имя нужной ВМ.
  4. Нажмите кнопку Изменить ВМ.
  5. Измените параметры ВМ, например, переименуйте машину, отредактировав поле Имя.
  6. Нажмите Сохранить изменения.

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

  1. Посмотрите описание команды CLI для обновления параметров ВМ:

    yc compute instance update --help

  2. Получите список ВМ в каталоге по умолчанию:

    yc compute instance list

    Результат:

    +----------------------+-----------------+---------------+---------+----------------------+
|          ID          |       NAME      |    ZONE ID    | STATUS  |     DESCRIPTION      |
+----------------------+-----------------+---------------+---------+----------------------+
| fhm0b28lgfp4******** | first-instance  | ru-central1-a | RUNNING | my first vm via CLI  |
| fhm9gk85nj7g******** | second-instance | ru-central1-a | RUNNING | my second vm via CLI |
+----------------------+-----------------+---------------+---------+----------------------+

  3. Выберите идентификатор (ID) или имя (NAME) нужной машины, например first-instance.

  4. Измените параметры ВМ, например, переименуйте машину:

    yc compute instance update first-instance \
  --new-name windows-vm

Чтобы изменить ВМ, воспользуйтесь методом REST API update для ресурса Instance или вызовом gRPC API InstanceService/Update.

Примечание

При изменении имени ВМ, имя хоста и, соответственно, FQDN не изменяются. Подробнее про генерацию имени FQDN читайте в разделе Имя хоста и внутренний FQDN.

Примеры

Просмотреть список изменяемых параметров

Чтобы просмотреть список изменяемых параметров, выполните команду:

yc compute instance update --help

Изменить имя и описание

Чтобы изменить имя и описание ВМ, выполните следующие шаги:

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

  1. Получите список ВМ в каталоге по умолчанию:

    yc compute instance list

    Результат:

    +----------------------+-----------------+---------------+---------+----------------------+
|          ID          |       NAME      |    ZONE ID    | STATUS  |     DESCRIPTION      |
+----------------------+-----------------+---------------+---------+----------------------+
| fhm0b28lgfp4******** | first-instance  | ru-central1-a | RUNNING | my first vm via CLI  |
| fhm9gk85nj7g******** | second-instance | ru-central1-a | RUNNING | my second vm via CLI |
+----------------------+-----------------+---------------+---------+----------------------+

  2. Выберите идентификатор (ID) или имя (NAME) нужной машины, например first-instance.

  3. Измените имя и описание ВМ:

    yc compute instance update first-instance \
  --new-name first-vm \
  --description "changed description vm via CLI"

Воспользуйтесь методом REST API update для ресурса Instance или вызовом gRPC API InstanceService/Update.

Внимание

Не изменяйте имя ВМ, если она принадлежит группе узлов кластера Managed Service for Kubernetes. Имя для такой ВМ генерируется автоматически, и его изменение нарушит работу кластера.

Изменить метаданные

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

Чтобы изменить метаданные ВМ, выполните следующие шаги:

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

  1. Получите список ВМ в каталоге по умолчанию:

    yc compute instance list

    Результат:

    +----------------------+-----------------+---------------+---------+----------------------+
|          ID          |       NAME      |    ZONE ID    | STATUS  |     DESCRIPTION      |
+----------------------+-----------------+---------------+---------+----------------------+
| fhm0b28lgfp4******** | first-instance  | ru-central1-a | RUNNING | my first vm via CLI  |
| fhm9gk85nj7g******** | second-instance | ru-central1-a | RUNNING | my second vm via CLI |
+----------------------+-----------------+---------------+---------+----------------------+

  2. Выберите идентификатор (ID) или имя (NAME) нужной машины, например first-instance.

  3. Получите информацию о ВМ вместе с метаданными. Все пользовательские метаданные определены в ключе user-data.

    yc compute instance get --full first-instance

  4. Измените метаданные ВМ. Изменить метаданные можно с помощью флагов:

    • --metadata — для изменения значения из одной строки.
    • --metadata-from-file — для изменения значения из нескольких строк.

Удалить SSH-ключи из метаданных

  1. В консоли управления выберите каталог, которому принадлежит ВМ.
  2. Выберите сервис Compute Cloud.
  3. Нажмите на имя нужной ВМ.
  4. В правом верхнем углу страницы нажмите Изменить ВМ.
  5. Раскройте меню Метаданные и удалите ключи, нажав .

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

  1. Посмотрите описание команды CLI для удаления метаданных:

    yc compute instance remove-metadata --help

  2. Удалите ключи:

    yc compute instance remove-metadata <идентификатор_ВМ> --keys <имя_SSH-ключа>

Чтобы удалить SSH-ключи из метаданных ВМ, воспользуйтесь методом REST API updateMetadata для ресурса Instance или вызовом gRPC API InstanceService/UpdateMetadata.

В запросе передайте параметр delete с SSH-ключом.

Пример запроса для REST API

curl \
  --request POST \
  --header "Authorization: Bearer <IAM-токен>" \
  --data '{"delete":["<имя_SSH-ключа>"]}' \
  https://compute.api.cloud.yandex.net/compute/v1/instances/<идентификатор_ВМ>/updateMetadata

Включить доступ по OS Login

Чтобы к ВМ можно было подключиться по OS Login, необходимо включить эту опцию в ее настройках:

  1. В консоли управления выберите каталог, которому принадлежит ВМ.
  2. Выберите сервис Compute Cloud.
  3. На панели слева выберите Виртуальные машины и нажмите на имя нужной ВМ.
  4. В правом верхнем углу экрана нажмите кнопку Изменить ВМ.
  5. В блоке Доступ выберите вариант Доступ по OS Login.
  6. Нажмите Сохранить изменения.

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

  1. Посмотрите описание команды CLI для обновления параметров ВМ:

    yc compute instance update --help

  2. Получите список ВМ в каталоге по умолчанию:

    yc compute instance list

    Результат:

    +----------------------+-----------------+---------------+---------+----------------------+
|          ID          |       NAME      |    ZONE ID    | STATUS  |     DESCRIPTION      |
+----------------------+-----------------+---------------+---------+----------------------+
| fhm0b28lgfp4******** | first-instance  | ru-central1-a | RUNNING | my first vm via CLI  |
| fhm9gk85nj7g******** | second-instance | ru-central1-a | RUNNING | my second vm via CLI |
+----------------------+-----------------+---------------+---------+----------------------+

  3. Выберите идентификатор (ID) или имя (NAME) нужной машины, например first-instance.

  4. Включите доступ по OS Login:

    yc compute instance update first-instance \
  --metadata enable-oslogin=true

Передайте в поле metadata пару enable-oslogin=true в методе REST API update для ресурса Instance или в вызове gRPC API InstanceService/Update.

Примечание

Для пользователей, добавленных через метаданные:

  • после включения доступа к ВМ по OS Login из метаданных удаляются ключи, указанные в user-data и ssh-keys;
  • после отключения доступа к ВМ по OS Login удаленные ключи пересоздаются.
Предыдущая
Изменить внутренний IP-адрес ВМ
Следующая
Изменить вычислительные ресурсы ВМ