Yandex Cloud
Search
Contact UsTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
  • Marketplace
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2026 Direct Cursus Technology L.L.C.
Yandex Compute Cloud
  • Yandex Container Solution
  • Access management
  • Pricing policy
    • Overview
    • connect-to-serial-port
      • Overview
      • add-access-binding
      • add-labels
      • add-metadata
      • add-one-to-one-nat
      • attach-disk
      • attach-filesystem
      • attach-network-interface
      • create
      • create-with-container
      • delete
      • detach-disk
      • detach-filesystem
      • detach-network-interface
      • get
      • get-serial-port-output
      • list
      • list-access-bindings
      • list-operations
      • move
      • relocate
      • remove-access-binding
      • remove-labels
      • remove-metadata
      • remove-one-to-one-nat
      • restart
      • set-access-bindings
      • simulate-maintenance-event
      • start
      • stop
      • update
      • update-container
      • update-network-interface
  • Terraform reference
  • Monitoring metrics
  • Audit Trails events
  • Release notes
  1. CLI reference
  2. instance
  3. update

yc compute instance update

Written by
Yandex Cloud
Updated at January 27, 2026

Update the specified virtual machine instance

Command UsageCommand Usage

Syntax:

yc compute instance update <INSTANCE-NAME>|<INSTANCE-ID> [Flags...] [Global Flags...]

FlagsFlags

Flag

Description

--id

string

Instance id.

--name

string

Instance name.

--async

Display information about the operation in progress, without waiting for the operation to complete.

--new-name

string

A new name of the instance.

--description

string

Specifies a textual description of the instance.

--labels

key=value[,key=value...]

A list of label KEY=VALUE pairs to add. For example, to add two labels named 'foo' and 'bar', both with the value 'baz', use '--labels foo=baz,bar=baz'.

--metadata

key=value[,key=value...]

Metadata to be made available to the guest operating system running on the instance.
See for details https://yandex.cloud/ru/docs/compute/concepts/vm-metadata

--metadata-options

PROPERTY=VALUE[,PROPERTY=VALUE...]

Options set the access mode to instance's metadata.

Possible property names:

  • aws-v1-http-endpoint: Enables access to AWS flavored metadata (IMDSv1). Values: enabled, disabled

  • aws-v1-http-token: Enables access to IAM credentials with AWS flavored metadata (IMDSv1). Values: enabled, disabled

  • gce-http-endpoint: Enables access to GCE flavored metadata. Values: enabled, disabled

  • gce-http-token: Enables access to IAM credentials with GCE flavored metadata. Values: enabled, disabled

--metadata-from-file

key=value[,key=value...]

Same as --metadata except that the value for the entry will be read from a local file.

--memory

byteSize

Specifies how much memory instance should have in GB. You can also use M and T suffixes to specify smaller or greater size respectively.

--cores

int

Specifies how many CPU cores instance should have.

--core-fraction

int

If provided, specifies baseline performance for a core in percent.

--gpus

int

Specifies how many GPUs instance should have.

--platform

string

Specifies platform for the instance.

--network-settings

PROPERTY=VALUE[,PROPERTY=VALUE...]

Network settings for the instance.

Possible property names:

  • type: Type of a network for virtual machine instance. Values: standard, software-accelerated

--serial-port-settings

PROPERTY=VALUE[,PROPERTY=VALUE...]

Serial port settings for the instance.

Possible property names:

  • ssh-authorization: Authorization mode in interactive serial port console via SSH. Values: instance_metadata, os_login

--preemptible

Specifies whether instance preemptible or not

--maintenance-policy

string

Behaviour on maintenance events. Values: 'restart', 'migrate'

--maintenance-grace-period

duration

Time between notification via metadata service and maintenance.

--placement-group-id

string

Placement group to add the instance to (use an empty string to remove the instance from placement group).

--placement-group-name

string

Placement group to add the instance to (use an empty string to remove the instance from placement group).

--placement-group-partition

int

Specifies placement group partition for the instance.

--host-group-id

string

Host group to place the instance to (to clear affinity rules use --no-host-affinity-rules).

--host-group-name

string

Host group to place the instance to (to clear affinity rules use --no-host-affinity-rules).

--host-id

string

Host to place the instance to (to remove all affinity rules use --no-host-affinity-rules).

--no-host-affinity-rules

Clear host affinity rules

--reserved-instance-pool-id

string

Link instance to specified reserved instance pool.

--reserved-instance-pool-name

string

Link instance to specified reserved instance pool.

--service-account-id

string

Service account, which token can be obtained inside VM from metadata service.

--service-account-name

string

Service account, which token can be obtained inside VM from metadata service.

Global FlagsGlobal Flags

Flag

Description

--profile

string

Set the custom configuration file.

--debug

Debug logging.

--debug-grpc

Debug gRPC logging. Very verbose, used for debugging connection problems.

--no-user-output

Disable printing user intended output to stderr.

--retry

int

Enable gRPC retries. By default, retries are enabled with maximum 5 attempts.
Pass 0 to disable retries. Pass any negative value for infinite retries.
Even infinite retries are capped with 2 minutes timeout.

--cloud-id

string

Set the ID of the cloud to use.

--folder-id

string

Set the ID of the folder to use.

--folder-name

string

Set the name of the folder to use (will be resolved to id).

--endpoint

string

Set the Cloud API endpoint (host:port).

--token

string

Set the OAuth token to use.

--impersonate-service-account-id

string

Set the ID of the service account to impersonate.

--no-browser

Disable opening browser for authentication.

--format

string

Set the output format: text (default), yaml, json, json-rest.

--jq

string

Query to select values from the response using jq syntax

-h, --help

Display help for the command.

  • Updating a GPU cluster
  • Adding a VM to a placement group
  • Removing a VM from a placement group
  • Attaching an existing VM to a pool
  • Connecting to a serial console
  • Connecting to a serial console
  • Enable the authorization method you need
  • Linking to an existing VM
  • Disabling access via OS Login
  • Linking to an existing VM
  • Change the VM maintenance policy type
  • Changing the vCPU and RAM configuration
  • Enabling access via OS Login
  • Changing the VM type
  • Configuring parameters of the VM metadata service
  • Enabling access via OS Login

Was the article helpful?

Previous
stop
Next
update-container
© 2026 Direct Cursus Technology L.L.C.