principal list#

Возвращает список пользователей.

Необходимые привилегии: principal.list.

Синтаксис#

catalog principal list
  [--principal-type=<principalType>] 
  [--page-size=<pageSize>]
  [--page-token=<pageToken>]

Опции#

--principal-type Тип пользователя. Допустимые значения: user — обычный пользователь; role — роль.

--page-size Максимальное количество возвращаемых записей.

--page-token Идентификатор страницы, начиная с которой необходимо возвращать записи.

Примеры#

Получить список пользователей с отображением в табличном формате:

catalog principal list

+----------------+----------------+--------+---------------+------------------------------------+
| principal-name | principal-type | active | role-names    | properties                         |
+----------------+----------------+--------+---------------+------------------------------------+
| root           | user           | true   | builtin.admin |                                    |
| john           | user           | true   |               | department=ENG;email=john@work.com |
| jane           | user           | true   |               | department=HR;email=jane@work.com  |
+----------------+----------------+--------+---------------+------------------------------------+

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

catalog principal list --page-size 2

+----------------+----------------+--------+---------------+------------------------------------+
| principal-name | principal-type | active | role-names    | properties                         |
+----------------+----------------+--------+---------------+------------------------------------+
| root           | user           | true   | builtin.admin |                                    |
| john           | user           | true   |               | department=ENG;email=john@work.com |
+----------------+----------------+--------+---------------+------------------------------------+
Next page token: 9e5bad44-e01f-4e93-bf23-38118f96357e

Получить следующую страницу результатов с отображением в формате JSON

catalog --json principal list --page-size 2 --page-token 9e5bad44-e01f-4e93-bf23-38118f96357e

{
  "items" : [ {
    "principalName" : "jane",
    "principalType" : "user",
    "active" : true,
    "role-names" : [  ],
    "properties" : {
      "email" : "jane@work.com",
      "department" : "HR"
    }
  } ],
  "next-page-token" : null
}