Связаться с экспертомПопробовать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»

Создание сервисного аккаунта

Статья создана
Улучшена
Обновлена 6 августа 2026 г.
Открыть в Markdown

Важно

Создание сервисных аккаунтов может быть запрещено политиками авторизации на уровне каталога, облака или организации.

Создайте сервисный аккаунт, чтобы управлять ресурсами от имени другой учетной записи.

Если нужно временно остановить работу сервисного аккаунта без удаления, заблокируйте его. После блокировки аккаунт нельзя использовать, пока вы его не разблокируете.

Чтобы создать сервисный аккаунт, у вас должна быть роль iam.serviceAccounts.admin или выше на каталог.

Примечание

Сервисный аккаунт создается внутри каталога. После создания сервисного аккаунта сменить каталог нельзя.

Сервисному аккаунту можно назначать роли на любые ресурсы в любом облаке, если эти ресурсы относятся к той же организации, что и сервисный аккаунт. Также сервисному аккаунту можно назначать роли на саму организацию.

Создать сервисный аккаунт

  1. В консоли управления на панели сверху нажмите или и выберите нужный каталог.

  2. Перейдите в сервис Identity and Access Management.

  3. Нажмите кнопку Создать сервисный аккаунт.

  4. Введите имя сервисного аккаунта.

    Требования к формату имени:

    • длина — от 3 до 63 символов;
    • может содержать строчные буквы латинского алфавита, цифры и дефисы;
    • первый символ — буква, последний — не дефис.

    Имя сервисного аккаунта должно быть уникальным в рамках облака.

  5. Нажмите кнопку Создать.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

  1. Посмотрите описание команды создания сервисного аккаунта:

    yc iam service-account create --help

  2. Создайте сервисный аккаунт с именем my-robot:

    yc iam service-account create --name my-robot

    Требования к формату имени:

    • длина — от 3 до 63 символов;
    • может содержать строчные буквы латинского алфавита, цифры и дефисы;
    • первый символ — буква, последний — не дефис.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы управлять инфраструктурой с помощью Terraform от имени сервисного аккаунта или пользовательских аккаунтов: аккаунта на Яндексе, федеративного аккаунта и локального пользователя, аутентифицируйтесь соответствующим способом.

  1. Опишите в конфигурационном файле параметры ресурсов, которые необходимо создать:

    resource "yandex_iam_service_account" "sa" {
  name        = "<имя_сервисного_аккаунта>"
  description = "<описание_сервисного_аккаунта>"
  folder_id   = "<идентификатор_каталога>"
}
    • name — имя сервисного аккаунта. Обязательный параметр.
    • description — описание сервисного аккаунта. Необязательный параметр.
    • folder_id — идентификатор каталога. Необязательный параметр. По умолчанию будет использовано значение, указанное в настройках провайдера.

    Подробнее о параметрах ресурса yandex_iam_service_account в Terraform читайте в документации провайдера.

  2. Проверьте корректность конфигурационных файлов.

    1. В командной строке перейдите в папку, где вы создали конфигурационный файл.

    2. Выполните проверку с помощью команды:

      terraform plan

    Если конфигурация описана верно, в терминале отобразится информация о сервисном аккаунте. Если в конфигурации есть ошибки, Terraform на них укажет.

  3. Разверните облачные ресурсы.

    1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply

    2. Подтвердите создание сервисного аккаунта: введите в терминал слово yes и нажмите Enter.

      После этого будет создан сервисный аккаунт. Проверить появление сервисного аккаунта можно в консоли управления или с помощью команды CLI:

      yc iam service-account list

Чтобы создать сервисный аккаунт, воспользуйтесь методом REST API create для ресурса ServiceAccount или вызовом gRPC API ServiceAccountService/Create.

Примеры

Добавить описание при создании

Создайте сервисный аккаунт с именем и описанием:

yc iam service-account create --name my-robot \
  --description "this is my favorite service account"

 resource "yandex_iam_service_account" "sa" {
   name        = "my-robot"
   description = "this is my favorite service account"
 }

curl \
  --request POST \
  --header 'Content-Type: application/json' \
  --header "Authorization: Bearer <IAM-токен>" \
  --data '{
    "folderId": "b1gvmob95yys********",
    "name": "my-robot",
    "description": "this is my favorite service account"
  }' \
  https://iam.api.yandexcloud.kz/iam/v1/serviceAccounts

Задать срок жизни сервисного аккаунта

Создайте сервисный аккаунт с ограниченным сроком жизни. По истечении срока жизни система автоматически заблокирует его.

yc iam service-account create --name my-robot \
  --expires-at 2026-12-02T15:04:05Z

Значение параметра --expires-at задается в формате RFC 3339.

curl \
  --request POST \
  --header 'Content-Type: application/json' \
  --header "Authorization: Bearer <IAM-токен>" \
  --data '{
    "folderId": "<идентификатор_каталога>",
    "name": "<имя_сервисного_аккаунта>",
    "expiresAt": "2026-12-02T15:04:05Z"
  }' \
  https://iam.api.yandexcloud.kz/iam/v1/serviceAccounts

Значение поля expiresAt задается в формате RFC 3339.

Полезные ссылки

Предыдущая
Обзор
Следующая
Просмотр сервисных аккаунтов каталога