Изменение сервисного аккаунта

Статья создана

Yandex Cloud

Улучшена

Danila N.

Обновлена 31 августа 2026 г.

Открыть в Markdown

Примеры
- Изменить срок жизни сервисного аккаунта

Вы можете изменить имя и описание сервисного аккаунта. Через API Yandex Cloud также можно назначить метки на сервисный аккаунт.

Чтобы задать или изменить срок жизни аккаунта, используйте параметр --expires-at. По истечении срока жизни система автоматически заблокирует его.

Если вы хотите изменить роли сервисного аккаунта, обратитесь к инструкции.

Консоль управления

CLI

Terraform

API

Чтобы изменить сервисный аккаунт:

В консоли управления на панели сверху нажмите или и выберите каталог, которому принадлежит сервисный аккаунт.
Перейдите в сервис Identity and Access Management.
На панели слева выберите Сервисные аккаунты.
В строке с нужным сервисным аккаунтом нажмите значок и выберите Редактировать.
Измените имя сервисного аккаунта.

Требования к формату имени:
- длина — от 3 до 63 символов;
- может содержать строчные буквы латинского алфавита, цифры и дефисы;
- первый символ — буква, последний — не дефис.
Измените описание сервисного аккаунта.
Нажмите кнопку Сохранить.

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

Чтобы изменить сервисный аккаунт:

Посмотрите описание команды изменения сервисного аккаунта:
```
yc iam service-account update --help
```

Выберите сервисный аккаунт, например my-robot:

yc iam service-account list

Результат:

+----------------------+------------------+-------------------------------+
|          ID          |       NAME       |          DESCRIPTION          |
+----------------------+------------------+-------------------------------+
| aje6o61dvog2******** | my-robot         |                               |
| aje9sda1ufvq******** | account_name     | account_description           |
+----------------------+------------------+-------------------------------+

Измените параметры сервисного аккаунта, например имя и описание:
```
yc iam service-account update my-robot \
  --new-name my-service-account \
  --description "this is my service account"
```
Требования к формату имени:
- длина — от 3 до 63 символов;
- может содержать строчные буквы латинского алфавита, цифры и дефисы;
- первый символ — буква, последний — не дефис.

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

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

Чтобы изменить сервисный аккаунт:

Откройте файл конфигурации Terraform и измените фрагмент с описанием сервисного аккаунта.
Пример описания сервисного аккаунта в конфигурации Terraform:
```
...
resource "yandex_iam_service_account" "sa" {
  name        = "my-robot"
  description = "this is new description"
 }
...
```
Проверьте конфигурацию командой:
```
terraform validate
```
Если конфигурация является корректной, появится сообщение:
```
Success! The configuration is valid.
```
Выполните команду:
```
terraform plan
```
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
Примените изменения конфигурации:
```
terraform apply
```
Подтвердите изменения: введите в терминал слово yes и нажмите Enter.

Проверить изменение сервисного аккаунта можно в консоли управления или с помощью команды CLI:
```
yc iam service-account list
```

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

Примеры

Изменить срок жизни сервисного аккаунта

Укажите новый срок жизни сервисного аккаунта. По истечении срока жизни система автоматически заблокирует его. Чтобы снять блокировку, обратитесь к инструкции.

CLI

API

yc iam service-account update my-robot \
  --expires-at 2027-01-01T00:00:00Z

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

Чтобы убрать ограничение по сроку жизни, передайте пустое значение:

yc iam service-account update my-robot \
  --expires-at ""

curl \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header "Authorization: Bearer <IAM-токен>" \
  --data '{
    "updateMask": "expiresAt",
    "expiresAt": "2027-01-01T00:00:00Z"
  }' \
  https://iam.api.cloud.yandex.net/iam/v1/serviceAccounts/<идентификатор_сервисного_аккаунта>

Значение поля expiresAt задается в формате RFC 3339. Чтобы убрать ограничение по сроку жизни, передайте пустое значение: "expiresAt": "".

Изменение сервисного аккаунта

ПримерыПримеры

Изменить срок жизни сервисного аккаунтаИзменить срок жизни сервисного аккаунта

Была ли статья полезна?

Примеры

Изменить срок жизни сервисного аккаунта