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