29.2. サポート対象の Security Management REST API エンドポイント
Security Management REST API は、Business Central でグループ、ロール、ユーザー、およびパーミッションを管理するためのエンドポイントを提供します。これには、管理者が Business Central の Security Management ページでも実行できるセキュリティーおよびパーミッション管理タスクが含まれます。
29.2.1. Groups リンクのコピーリンクがクリップボードにコピーされました!
Security Management REST API は Business Central のグループを管理するための以下のエンドポイントをサポートします。Security Management REST API のベース URL は http://SERVER:PORT/decision-central/rest/ です。ユーザーロール admin では、すべての要求で HTTP Basic 認証またはトークンベースの認証が必要です。
- [GET] /groups
Business Central のすべてのグループを返します。
サーバーの応答例 (JSON)
[ { "group1" }, { "group2" } ]- [POST] /groups
Business Central でグループを作成します。グループには、少なくともユーザーを 1 つ割り当てる必要があります。
Expand 表29.1 要求パラメーター Name 説明 タイプ 要件 ボディ
新しいグループに割り当てられたグループとユーザーの名前
要求ボディ
必須
要求ボディ (JSON) 例
{ "name": "groupName", "users": [ "userNames" ] }サーバーの応答例 (JSON)
{ "status": "OK", "message": "Group newGroup is created successfully." }- [DELETE] /groups/{groupName}
Business Central から指定のグループを削除します。
Expand 表29.2 要求パラメーター Name 説明 タイプ 要件 groupName削除するグループの名前
文字列
必須
サーバーの応答例 (JSON)
{ "status": "OK", "message": "Group newGroup is deleted successfully." }