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 Audit Trails
  • Getting started
    • All guides
    • Creating a trail
    • Managing a trail
    • Drafting a trail specification
      • Viewing roles assigned to a trail
      • Assigning roles for a trail
      • Revoking roles assigned for a trail
    • Handling errors
    • Viewing operations with service resources
  • Access management
  • Pricing policy
  • Terraform reference
  • Monitoring metrics
  • Management event reference
  • Data event reference
  • Release notes
  1. Step-by-step guides
  2. Managing trail access permissions
  3. Assigning roles for a trail

Assigning roles for a trail

Written by
Yandex Cloud
Updated at May 5, 2026
CLI
API

If you do not have the Yandex Cloud CLI yet, install and initialize it.

The folder used by default is the one specified when creating the CLI profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also specify a different folder for any command using --folder-name or --folder-id. If you access a resource by its name, the search will be limited to the default folder. If you access a resource by its ID, the search will be global, i.e., through all folders based on access permissions.

  1. See the description of the CLI command for assigning roles for a trail:

    yc audit-trails trail set-access-bindings --help
    
  2. Get a list of trails:

    yc audit-trails trail list
    

    Result:

    +----------------------+--------------+--------+-------------------+
    |          ID          |     NAME     | STATUS |      FILTERS      |
    +----------------------+--------------+--------+-------------------+
    | cnp82sb0phnm******** | trailfromapi | ACTIVE | storage compute   |
    |                      |              |        | management.events |
    | cnp8v52idttr******** | tf-trail     | ACTIVE | storage compute   |
    |                      |              |        | mdb.postgresql    |
    | cnpnkcubr529******** | test-2       | ACTIVE | compute           |
    +----------------------+--------------+--------+-------------------+
    
  3. Run the following command to assign a role for a trail:

    • To a user:

      yc audit-trails trail set-access-bindings \
        --id <trail_ID> \
        --access-binding role=<role>,user-account-id=<user_ID>
      
      done (1s)
      
    • To a service account:

      yc audit-trails trail set-access-bindings \
        --id <trail_ID> \
        --access-binding role=<role>,service-account-id=<service_account_ID>
      
      done (1s)
      
    • To all authenticated users (the All authenticated users public group):

      yc audit-trails trail set-access-bindings \
        --id <trail_ID> \
        --access-binding role=<role>,all-authenticated-users
      
      done (1s)
      

To assign roles for a trail, use the setAccessBindings REST API method for the Trail resource or the TrailService/SetAccessBindings gRPC API call.

Was the article helpful?

Previous
Viewing roles assigned to a trail
Next
Revoking roles assigned for a trail
© 2026 Direct Cursus Technology L.L.C.