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 Managed Service for YDB
  • Getting started
  • Access management
    • Overview
      • Overview
      • add-access-binding
      • add-labels
      • backup
      • create
      • delete
      • get
      • list
      • list-access-bindings
      • move
      • remove-access-binding
      • remove-labels
      • restore
      • set-access-bindings
      • start
      • stop
      • update
  • Monitoring metrics
  • Audit Trails events
  • FAQ
  • Public materials
  1. CLI reference
  2. database
  3. create

yc ydb database create

Written by
Yandex Cloud
Updated at January 27, 2026

Create YDB database.

Command UsageCommand Usage

Syntax:

yc ydb database create <DATABASE-NAME> [Flags...] [Global Flags...]

FlagsFlags

Flag

Description

--name

string

Name of the database.

--description

string

Description of the database.

--resource-preset

string

Database resource preset ID.

--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'.

--public-ip

Assign public ips for the database.

--deletion-protection

Inhibits deletion of a database.

--network-id

string

Network id.

--network-name

string

Network name.

--subnet-name

value[,value]

Adds subnet by Name for the database.

--subnet-id

value[,value]

Adds subnet by ID for the database.

--security-group-name

value[,value]

Adds security-group by Name for the database.

--security-group-id

value[,value]

Adds security-group by ID for the database.

--storage

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

YDB database storage options.

Possible property names:

  • type: YDB database storage type id.

  • groups: YDB database storage group count.

--fixed-size

int

Specifies fixed scale policy size.

--zone

string

Specifies database type - zonal.

--region

string

Specifies database type - regional.

--location

string

Specifies database location.

--dedicated

Specifies database type - dedicated.

--sls-enable-throttling-rcu

Enable RU/s throttling limit for a serverless database, true/false.

--sls-throttling-rcu

int

Throttling limit for a serverless database, RU/s. Use sls-enable-throttling-rcu flag to trigger throttling on/off.

--sls-provisioned-rcu

int

Provisioned capacity limit for a serverless database, RU/s. Set to zero to disable provisioned capacity hourly billing.

--sls-storage-size

byteSize

Maximum size for a serverless database. Example: 10GB, 100GB. Units are in GB if not specified. Default value for a new database is 50GB.

--serverless

Specifies database type - serverless.

--backup

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

YDB database backup config options.

Possible property names:

  • source: Adds source path to backup.

  • exclude: Exclude path from backup.

  • ttl: Specify backup time to live. Example: '120m', '15m', '7200s'

  • name: Specify backup settings name.

  • description: Specify backup settings description.

  • daily-execute-time: Time of day in UTC time zone, HH:MM 24-hour clock format, when daily backup should be executed. Example: '02:30

  • weekly-execute-time: Time of day in UTC time zone, HH:MM 24-hour clock format, when weekly backup should be executed. Example: '02:30

  • weekly-days: Specify days when weekly backup should be executed.

  • storage-class: Specify backup storage class Values: 'standard', 'reduced-redundancy', 'standard-ia', 'onezone-ia', 'intelligent-tiering', 'glacier', 'deep-archive', 'outposts'

--async

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

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.

  • Creating a serverless database
  • Create a database in Managed Service for YDB

Was the article helpful?

Previous
backup
Next
delete
© 2026 Direct Cursus Technology L.L.C.