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

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

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

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

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

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

    $ yc compute instance update --help
    
  2. Получите список виртуальных машин в каталоге по умолчанию:

    $ yc compute instance list
    +----------------------+-----------------+---------------+---------+----------------------+
    |          ID          |       NAME      |    ZONE ID    | STATUS  |     DESCRIPTION      |
    +----------------------+-----------------+---------------+---------+----------------------+
    | fhm0b28lgfp4tkoa3jl6 | first-instance  | ru-central1-a | RUNNING | my first vm via CLI  |
    | fhm9gk85nj7gcoji2f8s | 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
    

Чтобы изменить виртуальную машину, воспользуйтесь методом update для ресурса Instance.

Примеры

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

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

$ yc compute instance update --help

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

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

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

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

  1. Получите список виртуальных машин в каталоге по умолчанию:

    $ yc compute instance list
    +----------------------+-----------------+---------------+---------+----------------------+
    |          ID          |       NAME      |    ZONE ID    | STATUS  |     DESCRIPTION      |
    +----------------------+-----------------+---------------+---------+----------------------+
    | fhm0b28lgfp4tkoa3jl6 | first-instance  | ru-central1-a | RUNNING | my first vm via CLI  |
    | fhm9gk85nj7gcoji2f8s | 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"
    

    Примечание

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

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

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

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

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

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

  1. Получите список виртуальных машин в каталоге по умолчанию:

    $ yc compute instance list
    +----------------------+-----------------+---------------+---------+----------------------+
    |          ID          |       NAME      |    ZONE ID    | STATUS  |     DESCRIPTION      |
    +----------------------+-----------------+---------------+---------+----------------------+
    | fhm0b28lgfp4tkoa3jl6 | first-instance  | ru-central1-a | RUNNING | my first vm via CLI  |
    | fhm9gk85nj7gcoji2f8s | 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 — для изменения значения из нескольких строк.

    Пример изменения пароля администратора на виртуальной машине, на базе ОС Windows:

    1. Создайте YAML-файл (например, metadata.yaml) и укажите следующие данные:

      #ps1
      net user administrator "<пароль>"
      
    2. Выполните команду:

      $ yc compute instance update first-instance \
          --metadata-from-file user-data=metadata.yaml
      

      Имеющийся набор метаданных будет полностью перезаписан.