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 Load Testing
  • Getting started
  • Access management
  • Pricing policy
    • Overview
      • Overview
      • check-regression
      • create
      • delete
      • get
      • get-report-table
      • list
      • stop
      • wait
  • Terraform reference
  • Audit Trails events
  • Release notes
  1. CLI reference
  2. test
  3. create

yc loadtesting test create

Written by
Yandex Cloud
Updated at January 27, 2026

Create a test

Command UsageCommand Usage

Syntax:

yc loadtesting test create [Flags...] [Global Flags...]

FlagsFlags

Flag

Description

--name

string

A name of the load test.

--description

string

A descriptions of the test.

--labels

key1=value1[,key2=value2][,"key3=val3a,val3b"]

Labels of the test.

--configuration

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

Load test configuration.

Possible property names:

  • id: Specifies the id of test config to use in test.

  • agent-id: Specifies the ID of the load testing agent to run configuration.

  • agent-by-filter: Execute test on first available agent that matches filter string. As example:

  • --filter='id IN ("1", "2", "3")':

  • --filter='name contains agent AND labels.key=value1 AND labels.another-key=value2':

  • anonymous-agent: Specifies that test will run on anonymous agent.

  • test-data: Test data to use in configuration in format test-data=name1[,test-data=name2...]

--test-data

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

Test data sources in format name=<name>,s3file=<s3file-name>,s3bucket=<s3bucket-name>

Possible property names:

  • name: The name of test data object.

  • s3bucket: Specifies the object storage bucket name where test data is stored.

  • s3file: Specifies the file name in object storage bucket.

--artifacts-output-bucket

string

Object Storage bucket into which test artifacts will be uploaded.

--artifacts-make-archive

Upload all artifacts as a single archive.

--artifacts

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

Rules defining which files should be uploaded as artifacts. Example: 'include=*,exclude=token.json,exclude=phout.log'.

Default: 'include=.log,include=.yaml,exclude=phout*.log'.

Possible property names:

  • include: Filename mask specifying which files should be uploaded as artifacts.

  • exclude: Filename mask to make exceptions from 'include' filters.

--wait-idle-timeout

duration

The timeout to interrupt the command if test is stuck. Works only if --wait flag is set.

--wait

Wait until test is finished

--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 test

Was the article helpful?

Previous
check-regression
Next
delete
© 2026 Direct Cursus Technology L.L.C.