グループ・ユーザーの取得
get
/essbase/rest/v1/groups/{id}/members/users
1つのグループのユーザー・メンバーを取得します。
EPM共有サービス・セキュリティ・モードを使用している場合、この操作は実行できません。かわりに、共有サービス・コンソールでユーザー、グループおよび権限を管理します。
リクエスト
パス・パラメータ
- id(required): string
グループのID。
レスポンス
サポートされているメディア・タイプ
- application/json
- application/xml
200 レスポンス
OK
グループ・メンバー・リストが正常に返されました。
ネストされたスキーマ : User
型:
ソースの表示
object
- email: string
- groups: array groups
このユーザーに関連付けられているグループ名のカンマ区切りリスト。
- id: string
ユーザーID。
- links: array links
- name: string
ユーザー名。256文字以内で入力してください。特殊文字
; , = + * ? [ ] | < > \ " ' / スペース タブ
は使用できません。また、ピリオド(.
)はグループ名で使用できません。 - password: string
ユーザーのパスワード。
- role: string
ユーザーの役割。有効な役割は、ユーザー、パワー・ユーザーおよびサービス管理者です。
- token: string
400 レスポンス
不正なリクエスト
ログインしているユーザーに、適切な権限がない可能性があります。
500 レスポンス
サーバーの内部エラーです。
例
次の例では、グループに属するユーザーのリストを取得する方法を示します。
この例では、cURLを使用して、Windowsシェル・スクリプトからREST APIにアクセスします。呼出し元ユーザーのIDおよびパスワードは変数であり、properties.bat
内でその変数値が設定されています。
cURLコマンドを含むスクリプト
次の例では、どのユーザーがグループID sample_appmgrsのメンバーであるかをリクエストします。
call properties.bat
curl -X GET "https://myserver.example.com:9001/essbase/rest/v1/groups/sample_appmgrs/members/users?links=none" -H "Accept:application/json" -u %User%:%Password%
レスポンス本体の例
AishaとFredはグループのメンバーです。
{
"items" : [ {
"id" : "user4",
"name" : "Aisha",
"email" : ""
}, {
"id" : "user8",
"name" : "Fred",
"email" : ""
} ]
}