Yandex Cloud
Search
Discuss with expertTry 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 Smart Web Security
  • Getting started
    • Overview
    • Security profiles
    • WAF
    • ARL (request limit)
    • Rules
    • Conditions
    • Lists
    • Managing bot traffic
    • Protecting domains
    • Response templates
    • Logging
    • Quotas and limits
  • Access management
  • Pricing policy
    • Overview
      • Overview
        • Overview
          • Overview
          • create
          • delete
          • get
          • list
          • update
  • Terraform reference
  • Monitoring metrics
  • Audit Trails events
  • Release notes
  1. CLI reference
  2. v1
  3. match-list
  4. match-list
  5. create

yc smartwebsecurity v1 match-list match-list create

Written by
Yandex Cloud
Updated at July 1, 2026
View in Markdown

Creates a MatchList resource in the specified folder.

Command UsageCommand Usage

Syntax:

yc smartwebsecurity v1 match-list match-list create <FOLDER-ID>

FlagsFlags

Flag

Description

--folder-id

string

ID of the folder to create the match list in.

--labels

map<string><string>

Labels as '' key:value '' pairs. Maximum of 64 per resource.

--name

string

Name of the match list.

--description

string

Description of the match list.

--list-type

enum

Match list type. Possible Values: 'managed', 'custom'

--item-type

enum

Match list item type. Possible Values: 'ip', 'bot-name', 'bot-category', 'asn', 'str', 'reg-exp'

--items

shorthand/json

Match list items.

Description
  • value (string)
    Value of the item.
  • description (string)
    Description of the item.
Shorthand Syntax
[
  {
    description = string,
    value = string
  }, ...
]
JSON Syntax
[
  {
    "description": "string",
    "value": "string"
  }, ...
]

--async

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

-r, --request-file

string

Path to a request file.

--example-json

Generates a JSON template of the request.

-e, --example-yaml

Generates a YAML template of the request.

The template can be customized and used as input for the command.

Usage example:

  1. Generate template:
    yc smartwebsecurity v1 match-list match-list create --example-json > request.json
    or
    yc smartwebsecurity v1 match-list match-list create --example-yaml > request.yaml

  2. Edit the template file

  3. Run with template:
    yc smartwebsecurity v1 match-list match-list create -r request.json
    or
    yc smartwebsecurity v1 match-list match-list create -r request.yaml

Global FlagsGlobal Flags

Flag

Description

--profile

string

Set the custom profile.

--region

string

Set the region.

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

--pager

string

Set the custom pager.

--no-pager

Do not pipe help output through a pager.

--format

string

Set the output format: text, yaml, json, table, summary || summary[name, instance.id, instance.disks[0].size].

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

--timeout

string

Set the timeout.

--token

string

Set the IAM token to use.

--impersonate-service-account-id

string

Set the ID of the service account to impersonate.

--no-browser

Disable opening browser for authentication.

--query

string

Query to select values from the response using jq syntax

--print-metadata

Print operation metadata along with result.

--syntax

string

Choose syntax option.

--cli-auto-prompt

string[="on"]

Enable interactive auto-prompt mode. Values: on, partial, off. Bare --cli-auto-prompt is equivalent to --cli-auto-prompt=on.

--no-cli-auto-prompt

Disable interactive auto-prompt mode (overrides --cli-auto-prompt, env and profile).

-h, --help

Display help for the command.

Was the article helpful?

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