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

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

Улучшена

Обновлена 21 апреля 2025 г.

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

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

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

CLI

Terraform

API

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

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

Требования к формату имени:
- длина — от 2 до 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"
```
Требования к формату имени:
- длина — от 2 до 63 символов;
- может содержать строчные буквы латинского алфавита, цифры и дефисы;
- первый символ — буква, последний — не дефис.

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

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

Откройте файл конфигурации 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.

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

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