Временные пользователи БД (dbusers)

Обзор

Управляет временными учетными записями пользователей баз данных домена.

Информация для подключения к БД получается из параметров соответствующей роли, исключая 'dc', доступ к БД которой запрещен.

Запросы

HTTP verb Endpoint Описание

GET

/rest/v1/iam/dbusers

Получение списка баз данных

POST

/rest/v1/iam/dbusers/<DB>

Создание нового временного пользователя БД

GET

/rest/v1/iam/dbusers/<DB>

Получение списка временных пользователей БД

DELETE

/rest/v1/iam/dbusers/<DB>

Удаление всех временных пользователей БД

DELETE

/rest/v1/iam/dbusers/<DB>/<login>

Удаление временного пользователя БД

Получение списка баз данных

Возвращает список баз данных домена. Каждый из элементов является строкой-ключом базы данных, используемым в endpoint запросов на управление временными пользователями БД.

Запрос

Пример запроса
GET /rest/v1/iam/dbusers HTTP/1.1

Ответ

Пример ответа
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

[
  {
    "name": "dummy",
    "_links": {
      "self": {
        "href": "/rest/v1/iam/dbusers/dummy"
      }
    }
  }
]

Создание нового временного пользователя БД

Создает роль и временную учетную запись пользователя с ограничением действия до конца текущего дня в часовом поясе сервера БД. Возвращает пароль учетной записи в открытом виде.

В качестве содержания запроса передается объект, который может содержать свойство access, определяющий уровень доступа для пользователя (варианты значений: read, write).

Устанавливаемый уровень доступа не может быть выше, чем разрешенный для домена (свойство текущего домена, устанавливаемое из родительского домена).

Запрос

Пример запроса
POST /rest/v1/iam/dbusers/dummy HTTP/1.1
Content-Type: application/json; charset=utf-8

{
  "access": "read"
}

Ответ

Пример ответа
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "host": "192.168.0.32",
  "port": 5432,
  "login": "tmp_rRpyH0hgS",
  "pwd": "2WJ0wCyHHeci",
  "database": "era_dummy_central_common",
  "access": "read",
  "validuntil": "2019-09-23 00:00:00+03"
}

Получение списка временных пользователей БД

Возвращает список актуальных учетных записей временных пользователей указанной БД. Пароли не возвращает.

Запрос

Пример запроса
GET /rest/v1/iam/dbusers/dummy HTTP/1.1

Ответ

Пример ответа
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

[
  {
    "host": "192.168.0.32",
    "port": 5432,
    "login": "tmp_rRpyH0hgS",
    "database": "era_dummy_central_common",
    "validuntil": "2019-09-23 00:00:00+03"
  },
  {
    "host": "192.168.0.32",
    "port": 5432,
    "login": "tmp_wyPHG0NN1",
    "database": "era_dummy_central_common",
    "validuntil": "2019-09-21 00:00:00+03"
  }
]

Удаление временного пользователя БД

Запрос

Пример запроса
DELETE /rest/v1/iam/dbusers/dummy/tmp_rRpyH0hgS HTTP/1.1

Ответ

Пример ответа
HTTP/1.1 204 No Content

Удаление всех временных пользователей БД

Запрос

Пример запроса
DELETE /rest/v1/iam/dbusers/dummy HTTP/1.1

Ответ

Пример ответа
HTTP/1.1 204 No Content

См. также

  • API управления временными пользователями БД с истекшим временем действия (rest/v1/iam/dbusers_by_expiration)

  • Персонализация
  • Увеличить шрифт
  • Уменьшить шрифт