Updating a desktop

If you do not have the Yandex Cloud CLI installed yet, install and initialize it.

By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also set a different folder for any specific command using the --folder-name or --folder-id parameter.

1. View the description of the CLI command for updating a desktop:

   yc desktops desktop update-properties --help
   

2. Get a list of desktops in the default folder:

   yc desktops desktop list
   

   Result:

   +----------------------+------------------+--------+----------------------+---------------------+
   |          ID          |       NAME       | STATUS |   DESKTOP GROUP ID   |   CREATED (UTC-0)   |
   +----------------------+------------------+--------+----------------------+---------------------+
   | e3vmvhgbgac4******** | my-cloud-desktop | ACTIVE | e3v1rbln45tl******** | 2024-10-09 22:42:28 |
   | e3vio1bc5ppz******** | reserved-desktop | ACTIVE | e3v9om0ur4rl******** | 2024-10-09 21:35:17 |
   +----------------------+------------------+--------+----------------------+---------------------+
   

3. Select the ID or NAME of the desktop you need, e.g., my-cloud-desktop.

4. Update desktop parameters, e.g., name:

   yc desktops desktop update-properties \
     --name <desktop_name> \
     --new-name <new_desktop_name>
   

   Result:

   id: e3vmvhgbgac4********
   folder_id: b1g681qpemb4********
   desktop_group_id: e3v1rbln45tl********
   created_at: "2024-10-09T22:42:28.020Z"
   status: ACTIVE
   name: renamed-cloud-desktop
   resources:
     memory: "4294967296"
     cores: "2"
     core_fraction: "100"
   network_interfaces:
     - network_id: enp0asmd9pr9********
       subnet_id: e2lb1da2dd9v********
   users:
     - subject_id: ajej2i98kcjd********