Создание группы пользователей
Объедините пользователей в группу, если им нужно выдать одинаковый набор ролей. Например, это могут быть сотрудники с одинаковыми должностными обязанностями или из одного отдела. Объединять пользователей можно по любому признаку.
Чтобы объединить пользователей в группу, создайте ее и добавьте в нее пользователей.
Создайте группу
-
Войдите в сервис Yandex Cloud Organization
. -
На панели слева выберите
Группы. -
В правом верхнем углу страницы нажмите
Создать группу. -
Задайте название и описание группы.
Название должно быть уникальным в организации и соответствовать требованиям:
- длина — от 1 до 63 символов;
- может содержать строчные буквы латинского алфавита, цифры и дефисы;
- первый символ — буква, последний — не дефис.
-
Нажмите кнопку Создать группу.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
-
Посмотрите описание команды создания группы пользователей Cloud Organization:
yc organization-manager group create --help
-
Чтобы создать группу пользователей в Cloud Organization, выполните команду:
yc organization-manager group create \ --name <имя_группы> \ --organization-id <идентификатор_организации> \ --description <описание_группы>
Где:
-
--name
— имя группы пользователей. Обязательный параметр. Название должно быть уникальным в организации и соответствовать требованиям:- длина — от 1 до 63 символов;
- может содержать строчные буквы латинского алфавита, цифры и дефисы;
- первый символ — буква, последний — не дефис.
-
--organization-id
— идентификатор организации. Необязательный параметр. -
--description
— текстовое описание группы пользователей. Необязательный параметр.
-
Terraform
Terraform распространяется под лицензией Business Source License
Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
-
Опишите в конфигурационном файле параметры группы:
resource "yandex_organizationmanager_group" "my-group" { name = "<название_группы>" description = "<описание_группы>" organization_id = "<идентификатор_организации>" }
Где:
-
name
— название группы. Название должно быть уникальным в организации и соответствовать требованиям:- длина — от 1 до 63 символов;
- может содержать строчные буквы латинского алфавита, цифры и дефисы;
- первый символ — буква, последний — не дефис.
-
description
— описание группы. Необязательный параметр. -
organization_id
— идентификатор организации, к которой нужно присоединить группу.
-
-
Создайте ресурсы:
-
В терминале перейдите в папку, где вы отредактировали конфигурационный файл.
-
Проверьте корректность конфигурационного файла с помощью команды:
terraform validate
Если конфигурация является корректной, появится сообщение:
Success! The configuration is valid.
-
Выполните команду:
terraform plan
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Примените изменения конфигурации:
terraform apply
-
Подтвердите изменения: введите в терминале слово
yes
и нажмите Enter.
Terraform создаст все требуемые ресурсы. Проверить появление ресурсов и их настройки можно в консоли управления
или с помощью команды CLI:yc organization-manager group list \ --organization-id <идентификатор_организации>
-
Воспользуйтесь методом REST API Group.create для ресурса Group или вызовом gRPC API GroupService/Create.
Добавьте в группу пользователей
-
Войдите в сервис Yandex Cloud Organization
. -
На панели слева выберите
Группы и нажмите строку с названием группы. -
Перейдите на вкладку Участники.
-
Нажмите кнопку Добавить участника.
-
В открывшемся окне выберите нужных пользователей или сервисные аккаунты. При необходимости воспользуйтесь поиском.
-
Нажмите Сохранить.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
-
Посмотрите описание команды добавления участников в группу пользователей Cloud Organization:
yc organization-manager group add-members --help
-
Чтобы добавить участников в группу пользователей, выполните команду:
yc organization-manager group add-members \ --name <имя_группы> \ --organization-id <идентификатор_организации> \ --subject-id <идентификатор_участника>
Где:
--name
— имя группы пользователей. Обязательный параметр.--organization-id
— идентификатор организации.--subject-id
— идентификатор участника, которого добавляют в группу.
Terraform
Terraform распространяется под лицензией Business Source License
Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
-
Опишите в конфигурационном файле новых участников группы:
resource "yandex_organizationmanager_group_membership" "group-members" { group_id = "<идентификатор_группы>" members = [ "<идентификатор_участника_1>", "<идентификатор_участника_2>" ] }
Где:
group_id
— идентификатор группы, к которой нужно присоединить участника.members
— идентификаторы участников, которых надо присоединить к группе.
-
Создайте ресурсы:
-
В терминале перейдите в папку, где вы отредактировали конфигурационный файл.
-
Проверьте корректность конфигурационного файла с помощью команды:
terraform validate
Если конфигурация является корректной, появится сообщение:
Success! The configuration is valid.
-
Выполните команду:
terraform plan
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Примените изменения конфигурации:
terraform apply
-
Подтвердите изменения: введите в терминале слово
yes
и нажмите Enter.
Terraform создаст все требуемые ресурсы. Проверить появление ресурсов и их настройки можно в консоли управления
или с помощью команды CLI:yc organization-manager group list-memebers \ --name <имя_группы> \ --organization-id <идентификатор_организации>
-
Воспользуйтесь методом REST API Group.updateMembers для ресурса Group или вызовом gRPC API GroupService/UpdateMembers.