Yandex Cloud
Documentation
PresentationContact UsTry it for free
© 2026 Direct Cursus Technology L.L.C.
Yandex Audit Trails
  • Getting started
  • Access management
  • Pricing policy
    • Overview
      • Overview
      • add-access-binding
      • create
      • delete
      • get
      • list
      • list-access-bindings
      • list-operations
      • remove-access-binding
      • set-access-bindings
      • update
  • Terraform reference
  • Monitoring metrics
  • Management event reference
  • Data event reference
  • Release notes
  1. CLI reference
  2. trail
  3. create

yc audit-trails trail create

Written by
Yandex Cloud
Updated at November 13, 2026
View in Markdown

Create the specified trail

Command UsageCommand Usage

Syntax:

yc audit-trails trail create <TRAIL-NAME> [Flags...] [Global Flags...]

FlagsFlags

Flag

Description

--file

string

Path to a file with a gRPC request to be executed, see proto files in the protobuf API specification: https://github.com/yandex-cloud/cloudapi/blob/master/yandex/cloud/audittrails/v1/trail_service.proto

--name

string

A name of the trail.

--description

string

Specifies the textual description of the trail.

--labels

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

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

--service-account-id

string

Specifies the trail service account ID.

--destination-bucket

string

Specifies the name of the destination bucket.

--destination-bucket-object-prefix

string

Specifies the prefix for uploaded results of the trail. Requires specifying 'destination-bucket'.

--destination-bucket-aggregation-period

duration

Target interval between the starts of exports to Object Storage, from 1m to 1h inclusive. If omitted, the server default is 5m. Requires specifying 'destination-bucket'.

--destination-log-group-id

string

Specifies the ID of the destination log group.

--destination-yds-database-id

string

Specifies the ID of the YDB hosting a destination YDS stream. Requires specifying 'destination-yds-stream'.

--destination-yds-stream

string

Specifies the name of the destination YDS stream. Requires specifying 'destination-yds-database-id'.

--destination-yds-codec

string

Codec for compressing events. Allowed values: RAW, GZIP, ZSTD. Default: RAW.

--destination-eventrouter-connector-id

string

Specifies the ID of the destination EventRouter Connector.

--destination-monium

Specifies Monium as the destination.

--filter-all-folder-id

string

Specifies the ID of the folder from which all management events will be collected.

--filter-all-cloud-id

string

Specifies the ID of the cloud from which all management events will be collected.

--filter-all-organisation-id

string

Specifies the ID of the organisation from which all management events will be collected.

--filter-from-cloud-id

string

Specifies the ID of the cloud which contain all folders specified at 'filter-some-folder-ids'. Deprecated

--filter-some-folder-ids

[]string

Specifies the list of folder IDs from which all management events will be collected.

--filter-from-organisation-id

string

Specifies the ID of the organisation which contain all clouds specified at 'filter-some-cloud-ids'. Deprecated

--filter-some-cloud-ids

[]string

Specifies a list of cloud IDs from which all management events will be collected.

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

--region

string

Set the region.

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

--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 (default), yaml, json, json-rest.

--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 OAuth token to use.

--jq

string

Query to select values from the response using jq syntax

--endpoint

string

Set the Cloud API endpoint (host:port).

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

  • Creating a trail

Was the article helpful?

Previous
add-access-binding
Next
delete
© 2026 Direct Cursus Technology L.L.C.