ユーザーの追加またはインポート
/essbase/rest/v1/users
ユーザーを追加またはインポートします。
要求
- application/json
- application/xml
作成するユーザーの詳細(Accept='application/json'またはAccept='application/xml'の場合)。 または、ユーザーのインポート元のCSVファイル(Accept='application/octet-stream'の場合)。
object- email(optional): string
ユーザーの電子メール・アドレス。
- groups(optional): array groups
このユーザーに関連付けられているグループ名のカンマ区切りリスト。
- id(optional): string
ユーザーID。
- links(optional): array links
- name(optional): string
ユーザー名。 256文字に制限されます。 次の特殊文字は使用できません:
; , = + * ? [ ] | < > \ " ' / Space Tab。 また、グループ名にピリオド(.)は使用できません。 - password(optional): string
ユーザーのパスワード。
- role(optional): string
ユーザー・ロール。 有効なロール: User、パワー・ユーザーおよびサービス管理者。
- token(optional): string
レスポンス
- application/json
- application/xml
200 レスポンス
OK
ユーザーは正常に追加されました。 Accept='application/json'またはAccept='application/xml'の場合、ユーザーはレスポンス本文に返されます。 Accept='application/octet-stream'の場合、追加されたユーザーはインポートされますが、レスポンス本文には含まれません。
object- email(optional): string
ユーザーの電子メール・アドレス。
- groups(optional): array groups
このユーザーに関連付けられているグループ名のカンマ区切りリスト。
- id(optional): string
ユーザーID。
- links(optional): array links
- name(optional): string
ユーザー名。 256文字に制限されます。 次の特殊文字は使用できません:
; , = + * ? [ ] | < > \ " ' / Space Tab。 また、グループ名にピリオド(.)は使用できません。 - password(optional): string
ユーザーのパスワード。
- role(optional): string
ユーザー・ロール。 有効なロール: User、パワー・ユーザーおよびサービス管理者。
- token(optional): string
400 レスポンス
不正なリクエスト
ログイン・ユーザーが適切なサービス・ロールを持っていない可能性があります。
500 レスポンス
内部サーバー・エラー。
例
次の例では、cURLを使用してWindowsシェル・スクリプトからREST APIにアクセスし、Essbaseユーザーを追加する方法を示します。
コール元のユーザーIDおよびパスワードは、properties.batで値が設定される変数です。
cURLコマンドを含むスクリプト
call properties.bat
curl -X POST "https://192.0.2.1:443/essbase/rest/v1/users"
-H "accept: application/json"
-H "Content-Type: application/json"
-d "{ \"password\": \"tempPa55\",
\"role\": \"user\",
\"email\": \"user001@example.com\",
\"id\": \"User001\",
\"name\": \"User One\"
}"
-u %User%:%Password%レスポンス本体の例
JSON形式のレスポンス本文のコンテンツの例を次に示します:
{
"id": "User001",
"name": "User One",
"email": "user001@example.com",
"role": "User",
"links": [
{
"rel": "get",
"href": "https://192.0.2.1:443/essbase/rest/v1/users/User001",
"method": "GET"
},
{
"rel": "edit",
"href": "https://192.0.2.1:443/essbase/rest/v1/users/User001",
"method": "PUT"
},
{
"rel": "delete",
"href": "https://192.0.2.1:443/essbase/rest/v1/users/User001",
"method": "DELETE"
},
{
"rel": "provisionReport",
"href": "https://192.0.2.1:443/essbase/rest/v1/users/User001/provisionReport",
"method": "GET"
}
]
}