Access management in Yandex Cloud AI Studio

Access managementAccess management

Yandex Identity and Access Management checks all operations in Yandex Cloud AI Studio. If an entity does not have required permissions, IAM returns an error.

To grant permissions for a resource, assign the relevant resource roles to an entity performing operations. You can assign roles to a Yandex account, service account, local user, federated user, user group, system group, or public group. For more information, see How access management works in Yandex Cloud.

Resources you can assign a role forResources you can assign a role for

You can assign a role to an organization, cloud, or folder. The roles assigned to organizations, clouds, and folders also apply to their nested resources.

Roles existing in this serviceRoles existing in this service

Service rolesService roles

ai.playground.userai.playground.user

The ai.playground.user role enables creating experiments, getting a list of all available models, and using these models in AI Playground in the Yandex Cloud management console. To work with search indexes in the management console, you also need the ai.assistants.editor role.

ai.languageModels.userai.languageModels.user

The ai.languageModels.user role enables using text generation models, text embedding models, and classifier models in Yandex AI Studio, as well as viewing info on the relevant cloud, folder, and quotas.

ai.imageGeneration.userai.imageGeneration.user

The ai.imageGeneration.user role enables using the YandexART image generation models within Yandex AI Studio, as well as viewing info on the relevant cloud, folder, and quotas.

ai.assistants.auditorai.assistants.auditor

The ai.assistants.auditor role enables viewing info on uploaded files, Vector Store search indexes, Yandex AI Studio quotas, as well as on the relevant cloud and folder.

ai.assistants.viewerai.assistants.viewer

The ai.assistants.viewer role enables viewing info on files and Vector Store search indexes as well as conducting searches using these indexes.

Users with this role can:

• View info on uploaded files and their contents.
• View info on Vector Store search indexes as well as conduct searches using these indexes.
• View info on Yandex AI Studio quotas.
• View info on the relevant cloud.
• View info on the relevant folder.

This role includes the ai.assistants.auditor permissions.

ai.assistants.editorai.assistants.editor

The ai.assistants.editor role enables using AI agents as well as managing files and Vector Store search indexes.

Users with this role can:

• Use AI agents.
• View info on uploaded files as well as create, update, view, and delete them.
• View info on Vector Store search indexes, create, modify, and delete them, as well as conduct searches using these indexes.
• View info on Yandex AI Studio quotas.
• View info on the relevant cloud.
• View info on the relevant folder.

This role includes the ai.assistants.viewer permissions.

ai.assistants.adminai.assistants.admin

The ai.assistants.admin role enables using AI agents as well as managing files and Vector Store search indexes.

Users with this role can:

• Use AI agents.
• View info on uploaded files as well as create, update, view, and delete them.
• View info on Vector Store search indexes, create, modify, and delete them, as well as conduct searches using these indexes.
• View info on Yandex AI Studio quotas.
• View info on the relevant cloud.
• View info on the relevant folder.

This role includes the ai.assistants.editor permissions.

ai.datasets.auditorai.datasets.auditor

The ai.datasets.auditor role enables viewing the dataset metadata.

ai.datasets.viewerai.datasets.viewer

The ai.datasets.viewer role enables viewing the info on datasets.

This role includes the ai.datasets.auditor permissions.

ai.datasets.userai.datasets.user

The ai.datasets.user role enables viewing info on datasets and using them to fine-tune models in AI Studio.

This role includes the ai.datasets.viewer permissions.

ai.datasets.editorai.datasets.editor

The ai.datasets.editor role enables viewing info on datasets, creating, modifying, and deleting them, as well as using them to fine-tune models in AI Studio.

This role includes the ai.datasets.user permissions.

ai.datasets.adminai.datasets.admin

The ai.datasets.admin role enables viewing info on datasets, creating, modifying, and deleting them, as well as using them to fine-tune models in AI Studio.

This role includes the ai.datasets.editor permissions.

ai.models.auditorai.models.auditor

The ai.models.auditor role enables viewing the text generation model metadata in Yandex AI Studio.

ai.models.viewerai.models.viewer

The ai.models.viewer role enables viewing info on the text generation models in Yandex AI Studio.

This role includes the ai.models.auditor permissions.

ai.models.userai.models.user

The ai.models.user role enables using AI agents, text and image generation models, text embedding models, and classifier models in Yandex AI Studio, as well as employing Yandex Translate, Yandex Vision OCR, and Yandex SpeechKit.

Users with this role can:

• View info on text generation models in Yandex AI Studio.
• Use AI agents, text and image generation models, text embedding models, and classifier models in Yandex AI Studio.
• Use Yandex Translate to translate texts.
• Use Yandex Vision OCR to analyze images.
• Use Yandex SpeechKit for speech recognition and synthesis.

This role includes the ai.models.viewer permissions.

ai.models.editorai.models.editor

The ai.models.editor role enables managing the fine-tuning of Yandex AI Studio models as well as using Yandex Translate, Yandex Vision OCR, Yandex SpeechKit, and Yandex AI Studio.

Users with this role can:

• View info on text generation models in Yandex AI Studio.
• Fine-tune Yandex AI Studio models as well as create, modify, and delete fine-tuned models.
• Use AI agents, text and image generation models, text embedding models, and classifier models in Yandex AI Studio.
• Use Yandex Translate to translate texts.
• Use Yandex Vision OCR to analyze images.
• Use Yandex SpeechKit for speech recognition and synthesis.

This role includes the ai.models.user permissions.

ai.models.adminai.models.admin

The ai.models.admin role enables managing the fine-tuning of Yandex AI Studio models as well as using Yandex Translate, Yandex Vision OCR, Yandex SpeechKit, and Yandex AI Studio.

Users with this role can:

• View info on text generation models in Yandex AI Studio.
• Fine-tune Yandex AI Studio models as well as create, modify, and delete fine-tuned models.
• Use AI agents, text and image generation models, text embedding models, and classifier models in Yandex AI Studio.
• Use Yandex Translate to translate texts.
• Use Yandex Vision OCR to analyze images.
• Use Yandex SpeechKit for speech recognition and synthesis.

This role includes the ai.models.editor permissions.

ai.guardrails.auditorai.guardrails.auditor

The ai.guardrails.auditor role enables viewing metadata on guardrails for model responses.

ai.guardrails.viewerai.guardrails.viewer

The ai.guardrails.viewer role enables viewing info on guardrails for model responses.

This role includes the ai.guardrails.auditor permissions.

ai.guardrails.userai.guardrails.user

The ai.guardrails.user role enables applying guardrails for model responses and viewing metadata on such rules.

ai.guardrails.editorai.guardrails.editor

The ai.guardrails.editor role enables viewing info on guardrails for model responses, as well as creating, applying, modifying, and deleting such rules.

This role includes the ai.guardrails.viewer and ai.guardrails.user permissions.

ai.guardrails.adminai.guardrails.admin

The ai.guardrails.admin role enables viewing info on guardrails for model responses, as well as creating, applying, modifying, and deleting such rules.

This role includes the ai.guardrails.editor permissions.

serverless.mcpGateways.auditorserverless.mcpGateways.auditor

The serverless.mcpGateways.auditor role allows the user to view info on MCP servers and their access permissions.

serverless.mcpGateways.viewerserverless.mcpGateways.viewer

The serverless.mcpGateways.viewer role allows the user to view info on MCP servers and their access permissions.

This role includes the serverless.mcpGateways.auditor permissions.

serverless.mcpGateways.invokerserverless.mcpGateways.invoker

The serverless.mcpGateways.invoker role allows the user to access MCP servers, including access via MCP Hub.

serverless.mcpGateways.anonymousInvokerserverless.mcpGateways.anonymousInvoker

The serverless.mcpGateways.anonymousInvoker role allows the user to access MCP servers, including access via MCP Hub.

serverless.mcpGateways.editorserverless.mcpGateways.editor

The serverless.mcpGateways.editor role allows the user to create, modify and delete MCP servers, view info on them and their access permissions.

This role includes the serverless.mcpGateways.viewer permissions.

serverless.mcpGateways.adminserverless.mcpGateways.admin

The serverless.mcpGateways.admin role allows the user to manage MCP servers and access to them.

Users with this role can:

• View MCP server info, create, update, and delete MCP servers.
• View MCP server access permission info, modify MCP server access permissions.
• Access MCP servers, including external ones, via MCP Hub.

This role includes the serverless.mcpGateways.editor, serverless.mcpGateways.invoker, and serverless.mcpGateways.anonymousInvoker permissions.

ai.auditorai.auditor

The ai.auditor role enables viewing info on quotas for Yandex Translate, Yandex Vision OCR, Yandex SpeechKit, and Yandex AI Studio, on uploaded files, Vector Store search indexes, datasets, and text generation models in Yandex AI Studio, view metadata on guardrails for model responses, as well as info on the relevant cloud and folder.

This role includes the ai.assistants.auditor, ai.datasets.auditor, ai.models.auditor, and ai.guardrails.auditor permissions.

ai.viewerai.viewer

The ai.viewer role enables viewing info on quotas for Yandex Translate, Yandex Vision OCR, Yandex SpeechKit, and Yandex AI Studio, on text generation models, guardrails for model responses, datasets, uploaded files, and Vector Store search indexes in Yandex AI Studio, read such files and conduct searches using these indexes, as well as view info on the relevant cloud and folder.

This role includes the ai.auditor, ai.assistants.viewer, ai.datasets.viewer, ai.models.viewer, and ai.guardrails.viewer permissions.

ai.editorai.editor

The ai.editor role enables using Yandex Translate, Yandex Vision OCR, Yandex SpeechKit, and Yandex AI Studio.

Users with this role can:

• Use Yandex Translate to translate texts.
• Use Yandex Vision OCR to analyze images.
• Use Yandex SpeechKit for speech recognition and synthesis.
• View info on text generation models in Yandex AI Studio.
• View info on guardrails for model responses, as well as create, apply, modify, and delete guardrails.
• Use AI agents, text and image generation models, text embedding models, and classifier models in Yandex AI Studio.
• View info on uploaded files as well as create, update, view, and delete them.
• View info on Vector Store search indexes, create, modify, and delete them, as well as conduct searches using these indexes.
• Fine-tune Yandex AI Studio models as well as create, modify, and delete fine-tuned models.
• View info on datasets, use them to fine-tune models, as well as create, modify, and delete datasets.
• View info on the relevant cloud and folder.
• View info on quotes for Yandex Translate, Yandex Vision OCR, Yandex SpeechKit, and Yandex AI Studio.

This role includes the ai.viewer, ai.translate.user, ai.vision.user, ai.speechkit-stt.user, ai.speechkit-tts.user, ai.languageModels.user, ai.imageGeneration.user, ai.assistants.editor, ai.datasets.editor, ai.models.editor, and ai.guardrails.editor permissions.

ai.adminai.admin

The ai.admin role enables using Yandex Translate, Yandex Vision OCR, Yandex SpeechKit, and Yandex AI Studio.

Users with this role can:

• Use Yandex Translate to translate texts.
• Use Yandex Vision OCR to analyze images.
• Use Yandex SpeechKit for speech recognition and synthesis.
• View info on text generation models in Yandex AI Studio.
• View info on guardrails for model responses, as well as create, apply, modify, and delete guardrails.
• Use AI agents, text and image generation models, text embedding models, and classifier models in Yandex AI Studio.
• View info on uploaded files as well as create, update, view, and delete them.
• View info on Vector Store search indexes, create, modify, and delete them, as well as conduct searches using these indexes.
• Fine-tune Yandex AI Studio models as well as create, modify, and delete fine-tuned models.
• View info on datasets, use them to fine-tune models, as well as create, modify, and delete datasets.
• View info on the relevant cloud and folder.
• View info on Yandex Translate, Yandex Vision OCR, Yandex SpeechKit, and Yandex AI Studio quotes.

This role includes the ai.editor, ai.assistants.admin, ai.datasets.admin, ai.models.admin, and ai.guardrails.admin permissions.

Primitive rolesPrimitive roles

Primitive roles allow users to perform actions in all Yandex Cloud services.

auditorauditor

The auditor role grants a permission to read configuration and metadata of any Yandex Cloud resources without any access to data.

For instance, users with this role can:

• View info on a resource.
• View the resource metadata.
• View the list of operations with a resource.

auditor is the most secure role that does not grant any access to the service data. This role suits the users who need minimum access to the Yandex Cloud resources.

viewerviewer

The viewer role grants the permissions to read the info on any Yandex Cloud resources.

This role includes the auditor permissions.

Unlike auditor, the viewer role provides access to service data in read mode.

editoreditor

The editor role provides permissions to manage any Yandex Cloud resources, except for assigning roles to other users, transferring organization ownership, removing an organization, and deleting Key Management Service encryption keys.

For instance, users with this role can create, modify, and delete resources.

This role includes the viewer permissions.

adminadmin

The admin role enables assigning any roles, except for resource-manager.clouds.owner and organization-manager.organizations.owner, and provides permissions to manage any Yandex Cloud resources (except for transferring organization ownership and removing an organization).

Prior to assigning the admin role for an organization, cloud, or billing account, make sure to check out the information on protecting privileged accounts.

This role includes the editor permissions.

Instead of primitive roles, we recommend using service roles with more granular access control, allowing you to implement the least privilege principle.

See alsoSee also

• How to assign a role
• How to revoke a role
• Learn more about access management in Yandex Cloud
• Learn more about role inheritance