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
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
    • Yandex Cloud Partner program
  • Blog
  • Pricing
  • Documentation
© 2025 Direct Cursus Technology L.L.C.
Yandex Audit Trails
  • Getting started
    • All guides
    • Creating a trail
    • Managing a trail
      • Viewing roles assigned for 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 May 5, 2025
CLI
API

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

The folder specified when creating the CLI profile is used by default. To change the default folder, use the yc config set folder-id <folder_ID> command. You can specify a different folder 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 for a trail
Next
Revoking roles assigned for a trail
© 2025 Direct Cursus Technology L.L.C.