5.8. ユーザ情報の取得

GET /1/(tenantId)/users/(userId)

ユーザ情報を取得する。

Request Headers:  

• X-Application-Id -- アプリケーションID(必須)
• X-Application-Key -- アプリケーションキー(必須)
• X-Session-Token -- セッショントークン(オプション)

Parameters:

• userId (string) -- ユーザID

Status Codes:

• 200 OK -- 正常取得した
• 401 Unauthorized -- 認証エラー
• 403 Forbidden -- 権限エラー
• 404 Not Found -- 該当ユーザが存在しない

Response JSON Object:  

• _id (string) -- ユーザID
• username (string) -- ユーザ名
• email (string) -- E-mail アドレス
• groups (array) -- ユーザが所属する全グループ名の一覧 (authenticated, anonymous は含まず)
• options (object) -- オプション情報
• createdAt (string) -- ユーザ作成日時
• updatedAt (string) -- ユーザ更新日時
• lastLoginAt (string) -- 最終ログイン日時。マスターキー使用時のみ返却する。
• etag (string) -- 新規作成・更新の度に変更される固有値
• federated (boolean) -- 外部認証連携有無
• primaryLinkedUserId (string) -- OpenID Connect認証でユーザ自動生成時のリンクユーザID
• clientCertUser (boolean) -- クライアント証明書認証ユーザフラグ
• enabled (boolean) -- 有効フラグ

レスポンスボディの例

{
    "_id":"52116f01ac521e1742000001",
    "username": "foo",
    "email": "foo@example.com",
    "groups": [ "group1", "group2", "group3" ],
    "options": {
        "displayName": "日電 太郎",
        "division": "日電事業部"
    },
    "createdAt": "2013-08-27T04:37:30.000Z",
    "updatedAt": "2013-08-27T04:37:30.000Z",
    "lastLoginAt": "2013-08-27T04:37:30.000Z", //マスターキー使用時のみ返却
    "etag": "8c92c97e-01a7-11e4-9598-53792c688d1b",
    "federated": false,
    "primaryLinkedUserId": "5953a6b10b1fed0f61c49ead",
    "clientCertUser": false,
    "enabled": true
}

注意事項

• _USERS バケットのcontentACL対するread権限が必要である。