Управление пользователями Yandex StoreDoc

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

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

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

yc managed-mongodb user list \
  --cluster-name <имя_кластера>

Имя кластера можно запросить со списком кластеров в каталоге.

1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

   export IAM_TOKEN="<IAM-токен>"
   

2. Воспользуйтесь методом User.List и выполните запрос, например с помощью cURL:

   curl \
     --request GET \
     --header "Authorization: Bearer $IAM_TOKEN" \
     --url 'https://mdb.api.cloud.yandex.net/managed-mongodb/v1/clusters/<идентификатор_кластера>/users'
   

   Идентификатор кластера можно запросить со списком кластеров в каталоге.

3. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

   export IAM_TOKEN="<IAM-токен>"
   

2. Клонируйте репозиторий cloudapi:

   cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
   

   Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.

3. Воспользуйтесь вызовом UserService.List и выполните запрос, например с помощью gRPCurl:

   grpcurl \
     -format json \
     -import-path ~/cloudapi/ \
     -import-path ~/cloudapi/third_party/googleapis/ \
     -proto ~/cloudapi/yandex/cloud/mdb/mongodb/v1/user_service.proto \
     -rpc-header "Authorization: Bearer $IAM_TOKEN" \
     -d '{
           "cluster_id": "<идентификатор_кластера>"
         }' \
     mdb.api.cloud.yandex.net:443 \
     yandex.cloud.mdb.mongodb.v1.UserService.List
   

   Идентификатор кластера можно запросить со списком кластеров в каталоге.

4. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

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

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

Чтобы получить информацию о конкретном пользователе:

1. Посмотрите описание команды CLI для получения информации о пользователе:

   yc managed-mongodb user get --help
   

2. Получите информацию о пользователе, выполнив команду:

   yc managed-mongodb user get <имя_пользователя> \
     --cluster-id=<идентификатор_кластера>
   

   Имя пользователя можно получить со списком пользователей в кластере, а идентификатор кластера — со списком кластеров в каталоге.

1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

   export IAM_TOKEN="<IAM-токен>"
   

2. Воспользуйтесь методом User.Get и выполните запрос, например с помощью cURL:

   curl \
     --request GET \
     --header "Authorization: Bearer $IAM_TOKEN" \
     --url 'https://mdb.api.cloud.yandex.net/managed-mongodb/v1/clusters/<идентификатор_кластера>/users/<имя_пользователя>'
   

   Идентификатор кластера можно получить со списком кластеров в каталоге, а имя пользователя — со списком пользователей в кластере.

3. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

   export IAM_TOKEN="<IAM-токен>"
   

2. Клонируйте репозиторий cloudapi:

   cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
   

   Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.

3. Воспользуйтесь вызовом UserService.Get и выполните запрос, например с помощью gRPCurl:

   grpcurl \
     -format json \
     -import-path ~/cloudapi/ \
     -import-path ~/cloudapi/third_party/googleapis/ \
     -proto ~/cloudapi/yandex/cloud/mdb/mongodb/v1/user_service.proto \
     -rpc-header "Authorization: Bearer $IAM_TOKEN" \
     -d '{
       "cluster_id": "<идентификатор_кластера>",
       "user_name": "<имя_пользователя>"
     }' \
     mdb.api.cloud.yandex.net:443 \
     yandex.cloud.mdb.mongodb.v1.UserService.Get
   

   Идентификатор кластера можно получить со списком кластеров в каталоге, а имя пользователя — со списком пользователей в кластере.

4. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

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

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

Чтобы создать пользователя в кластере:

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

   yc managed-mongodb user create --help
   

2. Укажите параметры пользователя в команде создания:

   yc managed-mongodb user create <имя_пользователя> \
     --cluster-name <имя_кластера> \
     --password <пароль_пользователя> \
     --permission database=<имя_БД>,role=<роль>,role=<другая_роль>,... \
     --permission database=<имя_другой_БД>,role=<роль>,... \
     --deletion-protection=<защитить_пользователя_от_удаления>
   

   Где:

   • <имя_пользователя>, --password — имя и пароль пользователя.

     Примечание

     Имя пользователя может содержать латинские буквы, цифры, дефис и подчеркивание, но должно начинаться с буквы, цифры или подчеркивания.

     Длина пароля от 8 до 128 символов.

   • --cluster-name — имя кластера, которое можно запросить со списком кластеров в каталоге.

   • --permission — разрешения пользователя для доступа к базе данных:

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

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

     • role — роль пользователя в базе данных. Список доступных значений приведен в разделе Пользователи и роли.

       Пользователю можно назначить несколько ролей в базе данных. Для этого каждую роль укажите в отдельном параметре role.

     Для каждой базы данных, к которой нужно предоставить доступ пользователю, задайте отдельный параметр --permission.

   • --deletion-protection — защита пользователя от непреднамеренного удаления: true или false. По умолчанию значение не задано, и для пользователя используется значение соответствующей настройки кластера. Если защита включена (true), удалить пользователя нельзя.

1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

   Инструкция по созданию такого файла приведена в разделе Создание кластера.

2. Добавьте ресурс yandex_mdb_mongodb_user:

   resource "yandex_mdb_mongodb_user" "<имя_пользователя>" {
     cluster_id          = <идентификатор_кластера>
     name                = "<имя_пользователя>"
     password            = "<пароль>"
     deletion_protection = <защитить_пользователя_от_удаления>
     permission {
       database_name = "<имя_БД>"
       roles         = [ "<список_ролей_пользователя>" ]
     }
   }
   

   Где:

   • cluster_id — идентификатор кластера, который можно запросить со списком кластеров в каталоге.

   • name, password — имя и пароль пользователя.

     Примечание

     Имя пользователя может содержать латинские буквы, цифры, дефис и подчеркивание, но должно начинаться с буквы, цифры или подчеркивания.

     Длина пароля от 8 до 128 символов.

   • deletion_protection — защита пользователя от непреднамеренного удаления: true или false. По умолчанию значение не задано, и для пользователя используется значение соответствующей настройки кластера. Если защита включена (true), удалить пользователя нельзя.

   • permission — разрешения пользователя для доступа к базе данных:

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

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

     • roles — список ролей пользователя в базе данных. Доступные значения приведены в разделе Пользователи и роли.

3. Проверьте корректность настроек.

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

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

      terraform validate
      

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

4. Подтвердите изменение ресурсов.

   1. Выполните команду для просмотра планируемых изменений:

      terraform plan
      

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

   2. Если вас устраивают планируемые изменения, внесите их:

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

         terraform apply
         

      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

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

1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

   export IAM_TOKEN="<IAM-токен>"
   

2. Воспользуйтесь методом User.Create и выполните запрос, например с помощью cURL:

   curl \
     --request POST \
     --header "Authorization: Bearer $IAM_TOKEN" \
     --header "Content-Type: application/json" \
     --url 'https://mdb.api.cloud.yandex.net/managed-mongodb/v1/clusters/<идентификатор_кластера>/users' \
     --data '{
               "userSpec": {
                 "name": "<имя_пользователя>",
                 "password": "<пароль_пользователя>",
                 "permissions": [
                   {
                     "databaseName": "<имя_БД>",
                     "roles": [
                      "<роль_1>", "<роль_2>", ..., "<роль_N>"
                     ]
                   }
                 ],
                 "deletionProtection": <защитить_пользователя_от_удаления>
               }
             }'
   

   Где:

   • <идентификатор_кластера> — идентификатор кластера, который можно запросить со списком кластеров в каталоге.

   • userSpec.name, userSpec.password — имя и пароль пользователя.

     Примечание

     Имя пользователя может содержать латинские буквы, цифры, дефис и подчеркивание, но должно начинаться с буквы, цифры или подчеркивания.

     Длина пароля от 8 до 128 символов.

   • userSpec.permissions — настройки разрешений пользователя:

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

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

     • roles — массив ролей пользователя. Каждая роль представлена в виде отдельной строки в массиве. Список доступных значений приведен в разделе Пользователи и роли.

     Для каждой базы данных добавьте отдельный элемент с настройками разрешений в массив permissions.

   • userSpec.deletionProtection — защита пользователя от непреднамеренного удаления: true или false. По умолчанию значение не задано, и для пользователя используется значение соответствующей настройки кластера. Если защита включена (true), удалить пользователя нельзя.

3. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

   export IAM_TOKEN="<IAM-токен>"
   

2. Клонируйте репозиторий cloudapi:

   cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
   

   Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.

3. Воспользуйтесь вызовом UserService.Create и выполните запрос, например с помощью gRPCurl:

   grpcurl \
     -format json \
     -import-path ~/cloudapi/ \
     -import-path ~/cloudapi/third_party/googleapis/ \
     -proto ~/cloudapi/yandex/cloud/mdb/mongodb/v1/user_service.proto \
     -rpc-header "Authorization: Bearer $IAM_TOKEN" \
     -d '{
           "cluster_id": "<идентификатор_кластера>",
           "user_spec": {
             "name": "<имя_пользователя>",
             "password": "<пароль_пользователя>",
             "permissions": [
               {
                 "database_name": "<имя_БД>",
                 "roles": [
                    "<роль_1>", "<роль_2>", ..., "<роль_N>"
                 ]   
               }
             ],
             "deletion_protection": <защитить_пользователя_от_удаления>
           }
         }' \
     mdb.api.cloud.yandex.net:443 \
     yandex.cloud.mdb.mongodb.v1.UserService.Create
   

   Где:

   • cluster_id — идентификатор кластера, который можно запросить со списком кластеров в каталоге.

   • user_spec.name, user_spec.password — имя и пароль пользователя.

     Примечание

     Имя пользователя может содержать латинские буквы, цифры, дефис и подчеркивание, но должно начинаться с буквы, цифры или подчеркивания.

     Длина пароля от 8 до 128 символов.

   • user_spec.permissions — настройки разрешений пользователя:

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

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

     • roles — массив ролей пользователя. Каждая роль представлена в виде отдельной строки в массиве. Список доступных значений приведен в разделе Пользователи и роли.

     Для каждой базы данных добавьте отдельный элемент с настройками разрешений в массив permissions.

   • user_spec.deletion_protection — защита пользователя от непреднамеренного удаления: true или false. По умолчанию значение не задано, и для пользователя используется значение соответствующей настройки кластера. Если защита включена (true), удалить пользователя нельзя.

4. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

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

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

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

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

   yc managed-mongodb user update --help
   

2. Укажите параметры пользователя в команде изменения:

   yc managed-mongodb user update <имя_пользователя> \
     --cluster-name <имя_кластера> \
     --password <пароль_пользователя> \
     --permission database=<имя_БД>,role=<роль>,role=<другая_роль>,... \
     --permission database=<имя_другой_БД>,role=<роль>,... \
     --deletion-protection=<защитить_пользователя_от_удаления>
   

   Где:

   • <имя_пользователя> — имя пользователя, которое можно запросить со списком пользователей в кластере.

   • --cluster-name — имя кластера, которое можно запросить со списком кластеров в каталоге.

   • --password — пароль пользователя.

     Длина пароля от 8 до 128 символов.

   • --permission — разрешения пользователя для доступа к базе данных:

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

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

     • role — роль пользователя в базе данных. Список доступных значений приведен в разделе Пользователи и роли.

       Пользователю можно назначить несколько ролей в базе данных. Для этого каждую роль укажите в отдельном параметре role.

     Для каждой базы данных, к которой нужно предоставить доступ пользователю, задайте отдельный параметр --permission.

   • --deletion-protection — защита пользователя от непреднамеренного удаления: true или false. По умолчанию значение не задано, и для пользователя используется значение соответствующей настройки кластера. Если защита включена (true), удалить пользователя нельзя.

Чтобы добавить пользователю доступ к базе данных с определенным набором ролей:

1. Посмотрите описание команды CLI для выдачи прав пользователю:

   yc managed-mongodb user grant-permission --help
   

2. Укажите свойства пользователя в команде выдачи прав:

   yc managed-mongodb user grant-permission <имя_пользователя> \
     --cluster-name <имя_кластера> \
     --database <имя_БД> \
     --role <набор_ролей_через_запятую>
   

Чтобы отозвать доступ у пользователя к базе данных:

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

   yc managed-mongodb user revoke-permission --help
   

2. Укажите свойства пользователя в команде отзыва прав:

   yc managed-mongodb user revoke-permission <имя_пользователя> \
     --cluster-name <имя_кластера> \
     --database <имя_БД>
   

   Эта команда полностью закрывает пользователю доступ к указанной базе данных.

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

1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

   Инструкция по созданию такого файла приведена в разделе Создание кластера.

2. Найдите ресурс yandex_mdb_mongodb_user.

3. Чтобы задать новый пароль, измените значение поля password:

   resource "yandex_mdb_mongodb_user" "<имя_пользователя>" {
     ...
     password   = "<новый_пароль>"
     ...
   }
   

   Длина пароля от 8 до 128 символов.

4. Чтобы настроить разрешения пользователя, измените список ролей в поле roles:

   resource "yandex_mdb_mongodb_user" "<имя_пользователя>" {
     ...
     permission {
       database_name = "<имя_БД>"
       roles         = [ "<новый_список_ролей_пользователя>" ]
     }
     ...
   }
   

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

5. Чтобы включить или отключить защиту пользователя от непреднамеренного удаления, измените значение поля deletion_protection:

   resource "yandex_mdb_mongodb_user" "<имя_пользователя>" {
     ...
     deletion_protection = <защитить_пользователя_от_удаления>
     ...
   }
   

   Где deletion_protection — защита пользователя от непреднамеренного удаления: true или false. По умолчанию значение не задано, и для пользователя используется значение соответствующей настройки кластера. Если защита включена (true), удалить пользователя нельзя.

6. Проверьте корректность настроек.

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

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

      terraform validate
      

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

7. Подтвердите изменение ресурсов.

   1. Выполните команду для просмотра планируемых изменений:

      terraform plan
      

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

   2. Если вас устраивают планируемые изменения, внесите их:

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

         terraform apply
         

      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

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

1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

   export IAM_TOKEN="<IAM-токен>"
   

2. Воспользуйтесь методом User.Update и выполните запрос, например с помощью cURL:

   Важно

   Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask (одной строкой через запятую).

   curl \
     --request PATCH \
     --header "Authorization: Bearer $IAM_TOKEN" \
     --header "Content-Type: application/json" \
     --url 'https://mdb.api.cloud.yandex.net/managed-mongodb/v1/clusters/<идентификатор_кластера>/users/<имя_пользователя>' \
     --data '{
              "updateMask": "password,permissions.databaseName,permissions.roles,deletionProtection",
              "password": "<пароль_пользователя>",
              "permissions": [
                {
                  "databaseName": "<имя_БД>",
                  "roles": [
                    "<роль_1>", "<роль_2>", ..., "<роль_N>"
                  ]
                }
              ],
              "deletionProtection": <защитить_пользователя_от_удаления>
            }'
   

   Где:

   • <идентификатор_кластера> — идентификатор кластера, который можно запросить со списком кластеров в каталоге.

   • <имя_пользователя> — имя пользователя, которое можно запросить со списком пользователей в кластере.

   • updateMask — перечень изменяемых параметров в одну строку через запятую.

   • password — пароль пользователя.

     Длина пароля от 8 до 128 символов.

   • permissions — настройки разрешений пользователя:

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

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

     • roles — массив ролей пользователя. Каждая роль представлена в виде отдельной строки в массиве. Список доступных значений приведен в разделе Пользователи и роли.

   • deletionProtection — защита пользователя от непреднамеренного удаления: true или false. По умолчанию значение не задано, и для пользователя используется значение соответствующей настройки кластера. Если защита включена (true), удалить пользователя нельзя.

3. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

   export IAM_TOKEN="<IAM-токен>"
   

2. Клонируйте репозиторий cloudapi:

   cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
   

   Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.

3. Воспользуйтесь вызовом UserService.Update и выполните запрос, например с помощью gRPCurl:

   Важно

   Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре update_mask (в виде массива строк paths[]).

   Формат перечисления настроек

   "update_mask": {
       "paths": [
           "<настройка_1>",
           "<настройка_2>",
           ...
           "<настройка_N>"
       ]
   }
   

   grpcurl \
     -format json \
     -import-path ~/cloudapi/ \
     -import-path ~/cloudapi/third_party/googleapis/ \
     -proto ~/cloudapi/yandex/cloud/mdb/mongodb/v1/user_service.proto \
     -rpc-header "Authorization: Bearer $IAM_TOKEN" \
     -d '{
           "cluster_id": "<идентификатор_кластера>",
           "user_name": "<имя_пользователя>",
           "update_mask": {
             "paths": [
               "password",
               "permissions.database_name",
               "permissions.roles",
               "deletion_protection"
             ]
           },
           "password": "<пароль_пользователя>",
           "permissions": [
             {
               "database_name": "<имя_БД>",
               "roles": [
                 "<роль_1>", "<роль_2>", ..., "<роль_N>"
               ]
             }
           ],
           "deletion_protection": <защитить_пользователя_от_удаления>
         }' \
     mdb.api.cloud.yandex.net:443 \
     yandex.cloud.mdb.mongodb.v1.UserService.Update
   

   Где:

   • cluster_id — идентификатор кластера, который можно запросить со списком кластеров в каталоге.

   • user_name — имя пользователя, которое можно запросить со списком пользователей в кластере.

   • update_mask — перечень изменяемых параметров в виде массива строк paths[].

   • password — пароль пользователя.

     Длина пароля от 8 до 128 символов.

   • permissions — настройки разрешений пользователя:

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

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

     • roles — массив ролей пользователя. Каждая роль представлена в виде отдельной строки в массиве. Список доступных значений приведен в разделе Пользователи и роли.

   • deletion_protection — защита пользователя от непреднамеренного удаления: true или false. По умолчанию значение не задано, и для пользователя используется значение соответствующей настройки кластера. Если защита включена (true), удалить пользователя нельзя.

4. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

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

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

Чтобы удалить пользователя, выполните команду:

yc managed-mongodb user delete <имя_пользователя> \
  --cluster-name <имя_кластера>

Имя кластера можно запросить со списком кластеров в каталоге.

1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

   Инструкция по созданию такого файла приведена в разделе Создание кластера.

2. Удалите ресурс yandex_mdb_mongodb_user с описанием нужного пользователя.

3. Проверьте корректность настроек.

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

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

      terraform validate
      

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

4. Подтвердите изменение ресурсов.

   1. Выполните команду для просмотра планируемых изменений:

      terraform plan
      

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

   2. Если вас устраивают планируемые изменения, внесите их:

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

         terraform apply
         

      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

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

1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

   export IAM_TOKEN="<IAM-токен>"
   

2. Воспользуйтесь методом User.Delete и выполните запрос, например с помощью cURL:

   curl \
     --request DELETE \
     --header "Authorization: Bearer $IAM_TOKEN" \
     --url 'https://mdb.api.cloud.yandex.net/managed-mongodb/v1/clusters/<идентификатор_кластера>/users/<имя_пользователя>'
   

   Идентификатор кластера можно запросить со списком кластеров в каталоге, а имя пользователя — со списком пользователей в кластере.

3. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

   export IAM_TOKEN="<IAM-токен>"
   

2. Клонируйте репозиторий cloudapi:

   cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
   

   Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.

3. Воспользуйтесь вызовом UserService.Delete и выполните запрос, например с помощью gRPCurl:

   grpcurl \
     -format json \
     -import-path ~/cloudapi/ \
     -import-path ~/cloudapi/third_party/googleapis/ \
     -proto ~/cloudapi/yandex/cloud/mdb/mongodb/v1/user_service.proto \
     -rpc-header "Authorization: Bearer $IAM_TOKEN" \
     -d '{
           "cluster_id": "<идентификатор_кластера>",
           "user_name": "<имя_пользователя>"
         }' \
     mdb.api.cloud.yandex.net:443 \
     yandex.cloud.mdb.mongodb.v1.UserService.Delete
   

   Идентификатор кластера можно запросить со списком кластеров в каталоге, а имя пользователя — со списком пользователей в кластере.

4. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Выполните следующую команду:

yc managed-mongodb user create user2 \
  --cluster-name <имя_кластера> \
  --password <пароль_пользователя> \
  --permission database=db1,role=read \
  --deletion-protection=true

1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

   Как создать такой файл, описано в разделе Создание кластера.

2. Добавьте ресурс yandex_mdb_mongodb_user.

   resource "yandex_mdb_mongodb_user" "user2" {
     cluster_id          = <идентификатор_кластера>
     name                = "user2"
     password            = "<пароль>"
     deletion_protection = true
     permission {
       database_name = "db1"
       roles         = [ "read" ]
     }
   }
   

3. Проверьте корректность настроек.

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

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

      terraform validate
      

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

4. Подтвердите изменение ресурсов.

   1. Выполните команду для просмотра планируемых изменений:

      terraform plan
      

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

   2. Если вас устраивают планируемые изменения, внесите их:

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

         terraform apply
         

      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

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

Выполните следующую команду:

yc managed-mongodb user grant-permission user1 \
  --cluster-name cluster1 \
  --database db2 \
  --role read

1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

   Как создать такой файл, описано в разделе Создание кластера.

2. Найдите ресурс yandex_mdb_mongodb_user.

3. Добавьте блок permission:

   resource "yandex_mdb_mongodb_user" "user1" {
     cluster_id          = <идентификатор_кластера>
     name                = "user1"
     password            = "<пароль>"
     deletion_protection = true
     permission {
       database_name = "db2"
       roles         = [ "read" ]
     }
   }
   

4. Проверьте корректность настроек.

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

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

      terraform validate
      

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

5. Подтвердите изменение ресурсов.

   1. Выполните команду для просмотра планируемых изменений:

      terraform plan
      

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

   2. Если вас устраивают планируемые изменения, внесите их:

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

         terraform apply
         

      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

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