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

Получить список пользователей кластера

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed PostgreSQL.
Нажмите на имя нужного кластера и перейдите на вкладку Пользователи.

Откроется список пользователей кластера.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя кластера:
bash
```
1
mws mpostgres cluster list
```

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

1
mws mpostgres user list --cluster <имя кластера>

1
+--------------------+----------------------+---------------+
2
|        NAME        | RECONCILIATION STATE |     ROLE      |
3
+--------------------+----------------------+---------------+
4
| <имя пользователя> | OK                   | DB_OWNER_USER |
5
+--------------------+----------------------+---------------+

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя кластера:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:
bash
```
1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера>/users \
2
  -H "Authorization: Bearer <IAM-токен>"
```
Если запрос был успешно принят, в ответе будет выведен список пользователей кластера с детализацией параметров.

Получить информацию о конкретном пользователе кластера

MWS CLI
API

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя кластера:
bash
```
1
mws mpostgres cluster list
```

Узнайте имя пользователя:

1
mws mpostgres user list --cluster <имя кластера>

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

1
mws mpostgres user get <имя пользователя> --cluster <имя кластера>

1
metadata:
2
    displayName: "<отображаемое имя>"
3
    createTime: "2025-09-30T02:08:56Z"
4
    updateTime: "2025-09-30T07:42:10Z"
5
    description: "<описание пользователя>"
6
    id: mpostgres/projects/<имя проекта>/clusters/<имя кластера>/users/<имя пользователя>
7
spec:
8
    password: ""
9
    role: <роль пользователя, например DB_OWNER_USER>
10
status:
11
    ready:
12
        state: OK

Изменить пароль пользователя

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed PostgreSQL.
Нажмите на имя нужного кластера и перейдите на вкладку Пользователи.
Нажмите на значок ... для нужного пользователя и выберите Задать новый пароль.
В открывшемся окне сгенерируйте пароль или введите его вручную.
Нажмите кнопку Сохранить и дождитесь открытия окна с новым паролем пользователя.
Сохраните новый пароль локально или в секрете Secret Manager. За использование сервиса Secret Manager взимается плата.

Не закрывайте окно, пока не сохраните пароль: позже доступа к паролю не будет.

Чтобы сохранить пароль в Secret Manager:
1. Нажмите на строку Сохранить пароль в Secret Manager.
2. Сохраните учетные данные пользователя одним из способов:
  В новом секрете
  В существующем секрете
  
  На вкладке Новый нажмите кнопку Создать секрет.
  
  Откроется страница создания секрета.
  
  (опционально) Измените автоматически сгенерированное имя секрета. Позже это имя (name) и созданный из него идентификатор (ID) секрета нельзя изменить, меняется только отображаемое имя (display name) секрета.
  
  (опционально) Чтобы использовать для шифрования ключ KMS, выберите Пользовательский ключ, затем выберите нужный ключ KMS или создайте новый. По умолчанию используется Системный ключ, которым управляет MWS Cloud Platform.
  
  (опционально) Измените автоматически сгенерированное описание секрета.
  
  Нажмите кнопку Сохранить.
  
  Учетные данные пользователя будут сохранены в первой версии секрета.
  
  Выбирайте существующий секрет, если хотите сохранить учетные данные пользователя вместе со значениями из текущей версии секрета. Новая версия станет текущей, а предыдущие версии сохранятся.
  
  Перейдите на вкладку Существующий.
  
  Выберите нужный секрет и нажмите кнопку Сохранить в новой версии секрета.
  
  Проверьте содержимое новой версии. Значения текущей версии секрета будут перенесены в нее. Если в текущей версии нет пар с ключами username и password, они будут добавлены. Если такие пары есть, их значения будут заменены именем пользователя и новым паролем.
  
  Нажмите кнопку Создать.
  
  Учетные данные пользователя будут сохранены в новой версии выбранного секрета.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя кластера:
bash
```
1
mws mpostgres cluster list
```

Узнайте имя пользователя:

1
mws mpostgres user list --cluster <имя кластера>

Выполните команду:
bash
```
1
mws mpostgres user update <имя пользователя> \
2
  --cluster <имя кластера> \
3
  --password <новый пароль>
```
Если пароль был изменен успешно, в ответе будут выведены параметры пользователя без значения пароля.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя кластера:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters \
2
  -H "Authorization: Bearer <IAM-токен>"

Узнайте имя пользователя:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера>/users \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:

1
curl -X POST https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера>/users/<имя пользователя> \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  -d '{
5
    "spec": {
6
      "password": "<новый пароль>"
7
    }
8
  }'

Если запрос был успешно принят, в ответе будут выведены параметры пользователя без значения пароля. До завершения изменения пароля в поле status.ready.state будет указано состояние PROCESSING.

Назначить роль migrator

Роль migrator нужна для миграции из сторонней БД в Managed PostgreSQL. Назначить роль можно только владельцу БД.

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed PostgreSQL.
Нажмите на имя нужного кластера и перейдите на вкладку Пользователи.
Нажмите на значок ... для нужного пользователя и выберите Назначить роль migrator.
В открывшемся окне укажите срок действия роли.
Нажмите кнопку Назначить.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя кластера:
bash
```
1
mws mpostgres cluster list
```

Узнайте имя пользователя:

1
mws mpostgres user list --cluster <имя кластера>

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

1
mws mpostgres user update <имя пользователя> \
2
  --cluster <имя кластера> \
3
  --role DB_OWNER_USER \
4
  --additional-roles 'expiresAt: "YYYY-MM-DDTHH:MM:SSZ", name: DB_MIGRATOR_ROLE' # Срок действия роли не должен превышать 14 дней

Если роль migrator задана успешно, в ответе будут выведены обновленные параметры пользователя.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя кластера:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters \
2
  -H "Authorization: Bearer <IAM-токен>"

Узнайте имя пользователя:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера>/users \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:

1
curl -X POST https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера>/users/<имя пользователя> \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  -d '{
5
    "spec": {
6
      "role": "DB_OWNER_USER",
7
      "additionalRoles" : [
8
          {
9
            "name": "DB_MIGRATOR_ROLE",
10
            "expiresAt": "YYYY-MM-DDTHH:MM:SSZ" // Срок действия роли не должен превышать 14 дней
11
          }
12
      ]
13
    }
14
}'

Если запрос был успешно принят, в ответе будут выведены обновленные параметры пользователя с заданной ролью migrator.

Отозвать роль migrator

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed PostgreSQL.
Нажмите на имя нужного кластера и перейдите на вкладку Пользователи.
Нажмите на значок ... для нужного пользователя и выберите Отозвать для роли migrator.
Подтвердите действие.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя кластера:
bash
```
1
mws mpostgres cluster list
```

Узнайте имя пользователя:

1
mws mpostgres user list --cluster <имя кластера>

Выполните команду:
bash
```
1
mws mpostgres user update <имя пользователя> \
2
  --cluster <имя кластера> \
3
  --role DB_OWNER_USER \
4
  --additional-roles '[]'
```
Если роль migrator успешно отозвана, в ответе будут выведены обновленные параметры пользователя.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя кластера:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters \
2
  -H "Authorization: Bearer <IAM-токен>"

Узнайте имя пользователя:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера>/users \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:

1
curl -X POST https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера>/users/<имя пользователя> \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  -d '{
5
    "spec": {
6
      "role": "DB_OWNER_USER",
7
      "additionalRoles": []
8
    }
9
}'

Если запрос был успешно принят, в ответе будут выведены обновленные параметры пользователя.

Обновить срок действия роли migrator

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed PostgreSQL.
Нажмите на имя нужного кластера и перейдите на вкладку Пользователи.
Нажмите на значок ... для нужного пользователя и выберите Обновить срок действия для роли migrator.
В открывшемся окне укажите новый срок действия роли.
Нажмите кнопку Сохранить.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя кластера:
bash
```
1
mws mpostgres cluster list
```

Узнайте имя пользователя:

1
mws mpostgres user list --cluster <имя кластера>

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

1
mws mpostgres user update <имя пользователя> \
2
  --cluster <имя кластера> \
3
  --role DB_OWNER_USER \
4
  --additional-roles 'expiresAt: "YYYY-MM-DDTHH:MM:SSZ", name: DB_MIGRATOR_ROLE' # Срок действия роли не должен превышать 14 дней

Если срок действия роли migrator успешно обновлен, в ответе будут выведены обновленные параметры пользователя.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя кластера:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters \
2
  -H "Authorization: Bearer <IAM-токен>"

Узнайте имя пользователя:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера>/users \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос.

Новый срок действия роли не должен превышать 14 дней.

1
curl -X POST https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера>/users/<имя пользователя> \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  -d '{
5
    "spec": {
6
      "role": "DB_OWNER_USER",
7
      "additionalRoles" : [
8
          {
9
            "name": "DB_MIGRATOR_ROLE",
10
            "expiresAt": "YYYY-MM-DDTHH:MM:SSZ"
11
          }
12
      ]
13
    }
14
}'

Если запрос был успешно принят, в ответе будут выведены обновленные параметры пользователя.

Удалить пользователя

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed PostgreSQL.
Нажмите на имя нужного кластера и перейдите на вкладку Пользователи.
Нажмите на значок ... для удаляемого пользователя и выберите Удалить.
Подтвердите удаление.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя кластера:
bash
```
1
mws mpostgres cluster list
```

Узнайте имя пользователя:

1
mws mpostgres user list --cluster <имя кластера>

Выполните команду:
bash
```
1
mws mpostgres user delete <имя пользователя> --cluster <имя кластера>
```
В случае успешного удаления на экран будет выведен ответ success.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя кластера:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters \
2
  -H "Authorization: Bearer <IAM-токен>"

Узнайте имя пользователя:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера>/users \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:

1
curl -X DELETE https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера>/users/<имя пользователя> \
2
  -H "Authorization: Bearer <IAM-токен>"

Если пользователь был успешно удален, вы получите ответ с кодом 204 No Content.