Yandex Cloud
Search
Contact UsTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • AI for business
    • Business tools
  • 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
© 2025 Direct Cursus Technology L.L.C.
Yandex Audit Trails
  • Getting started
    • All guides
    • Creating a trail
    • Managing a trail
      • 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 permissions to access a trail
  3. Assigning roles for a trail

Assigning roles for a trail

Written by
Yandex Cloud
Updated at June 9, 2025
CLI
API

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

By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also set a different folder for any specific command using the --folder-name or --folder-id parameter.

  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
© 2025 Direct Cursus Technology L.L.C.