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 Key Management Service
  • Getting started
  • Access management
  • Pricing policy
    • Overview
      • Overview
      • add-access-binding
      • cancel-version-destruction
      • create
      • delete
      • get
      • list
      • list-access-bindings
      • list-operations
      • list-versions
      • remove-access-binding
      • rotate
      • schedule-version-destruction
      • set-access-bindings
      • set-primary-version
      • update
  • Terraform reference
  • Monitoring metrics
  • Audit Trails events
  • FAQ
  1. CLI reference
  2. symmetric-key
  3. update

yc kms symmetric-key update

Written by
Yandex Cloud
Updated at January 27, 2026

Update the specified symmetric key

Command UsageCommand Usage

Syntax:

yc kms symmetric-key update <SYMMETRIC-KEY> [Flags...] [Global Flags...]

FlagsFlags

Flag

Description

--id

string

Symmetric key id.

--name

string

Symmetric key name.

--async

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

--new-name

string

New name of a symmetric key.

--description

string

New description of a symmetric key.

--status

string

New status of a symmetric key. Values: 'creating', 'active', 'inactive'

--labels

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

A list of new label KEY=VALUE pairs to update.

--default-algorithm

string

New default symmetric key version algorithm. Values: 'aes-128', 'aes-192', 'aes-256', 'aes-256-hsm', 'gost-r-3412-2015-k'

--rotation-period

duration

New rotation period for symmetric key version.

--deletion-protection

Inhibits deletion of a symmetric key.

--no-deletion-protection

Allows deletion of a symmetric key.

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.

  • Edit a key

Was the article helpful?

Previous
set-primary-version
Next
Terraform reference
© 2026 Direct Cursus Technology L.L.C.