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

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

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

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

   yc iam service-account update --help
   

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

   yc iam service-account list
   

   Результат:

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

3. Измените параметры сервисного аккаунта, например имя и описание:

   yc iam service-account update my-robot \
     --new-name my-service-account \
     --description "this is my service account"
   

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

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

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

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

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

1. Откройте файл конфигурации Terraform и измените фрагмент с описанием сервисного аккаунта.
   Пример описания сервисного аккаунта в конфигурации Terraform:

   ...
   resource "yandex_iam_service_account" "sa" {
     name        = "my-robot"
     description = "this is new description"
    }
   ...
   

2. Проверьте конфигурацию командой:

   terraform validate
   

   Если конфигурация является корректной, появится сообщение:

   Success! The configuration is valid.
   

3. Выполните команду:

   terraform plan
   

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

4. Примените изменения конфигурации:

   terraform apply
   

5. Подтвердите изменения: введите в терминал слово yes и нажмите Enter.

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

   yc iam service-account list
   

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

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

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