Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
  • Blog
  • Pricing
  • Documentation
Yandex project
© 2025 Yandex.Cloud LLC
Command line interface
  • Getting started with the CLI
    • Overview
    • help
    • init
      • Overview
        • Overview
        • check-regression
        • create
        • delete
        • get
        • get-report-table
        • list
        • stop
        • wait
    • version
  • CLI releases
  • Troubleshooting
  1. CLI reference
  2. loadtesting
  3. test
  4. create

yc loadtesting test create

Written by
Yandex Cloud
Updated at December 2, 2024

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.

Was the article helpful?

Previous
check-regression
Next
delete
Yandex project
© 2025 Yandex.Cloud LLC