ユーザ一覧

    ユーザ一覧


    記事の要約

    ユーザ情報の一覧を取得する。

    QUERY PARAMETERS

    start

    number

    Default: 0

    取得開始位置 (先頭は0)

    length

    number

    Default: 100

    取得件数

    sort

    string

    Default: "login_id"

    ソートキー (返却するユーザ情報のキー名のいずれか)

    order

    string

    Default: "asc"

    Enum: "asc" "desc"

    ソート順

    columns

    string

    取得する項目 (複数指定する場合は","区切り)

    HEADER PARAMETERS

    Authorization

    required

    string

    認証情報 (付録参照)

    Accept

    required

    string

    Value: "application/json"

    レスポンスの形式

    X-iDoperation-User-Key

    string

    Default: login_id

    Enum: "id" "login_id"

    ユーザ識別キー

    X-iDoperation-User-Value

    string

    ユーザ識別情報

    Responses

    RESPONSE SCHEMA: application/json

    total

    required

    integer

    ユーザ件数

    start

    required

    integer

    取得開始位置 (先頭は0)

    length

    required

    integer

    取得件数

    sort

    required

    string

    ソートキー

    order

    required

    string

    ソート順

    required

    Array of objects (User)

    ユーザ情報

    Array 

    id

    required

    string <uuid>

    ユーザID

    login_id

    required

    string <email>

    ログインID (メールアドレス)

    is_external

    required

    integer

    外部IdPユーザフラグ

    1. iDoperationのユーザ

    2. 外部アイデンティティプロバイダーのユーザ

    services 

    required

    Array of integers

    使えるサービス

    1. PAM

    2. EPM

    name

    required

    string

    ユーザ名

    is_initial_user

    required

    integer

    初期ユーザフラグ

    1. 初期ユーザでない

    2. 初期ユーザである

    is_administrator

    required

    integer

    全権管理者フラグ

    1. 全権管理者でない

    2. 全権管理者である

    logged_in_at

    required

    string or null <date-time>

    最新ログイン日時

    is_disabled

    required

    integer

    ログイン禁止フラグ

    1. ログイン可能

    2. ログイン禁止

    locale

    required

    string

    Enum: "ja" "en"

    通知メール言語

    is_notified

    required

    integer

    通知メール送信フラグ

    1. 通知メールを送信しない

    2. 通知メールを送信する

    memo

    required

    string or null

    メモ

    required

    Array of objects

    ユーザグループ

    Array 

    id

    required

    string <uuid>

    ユーザグループID

    name

    required

    string

    ユーザグループ名



    Response samples

    Content type

    application/json

    {

    • "total": 2,

    • "start": 0,

    • "length": 2,

    • "sort": "login_id",

    • "order": "asc",

    • "users": [

      • {

        • "id": "89ff0b48-e180-43b2-b932-486a4ff90d2b",

        • "login_id": "idadmin@example.com",

        • "is_external": 0,
          "services": [

          • 1,

          • 2

          ],

        • "name": "iDoperation Administrator",

        • "is_initial_user": 1,

        • "is_administrator": 1,

        • "logged_in_at": "2023-05-16T00:00:00.000Z",

        • "is_disabled": 0,

        • "locale": "ja",

        • "is_notified": 1,

        • "memo": null,

        • "user_groups": [

          • {

            • "id": "43b8f00b-933f-4a87-b907-3fec64a41f6e",

            • "name": "Root"

            }

          ]

        },

      • {

        • "id": "df87eb73-9135-41ad-95a7-6954f95e6302",

        • "login_id": "user@example.com",

        • "is_external": 0,

          "services": 1,

        • "name": "Sample User",

        • "is_initial_user": 0,

        • "is_administrator": 0,

        • "logged_in_at": "2023-05-16T01:00:00.000Z",

        • "is_disabled": 0,

        • "locale": "ja",

        • "is_notified": 1,

        • "memo": "メモ",

        • "user_groups": [

          • {

            • "id": "43b8f00b-933f-4a87-b907-3fec64a41f6e",

            • "name": "Root"

            }

          ]

        }

      ]

    }