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/business-central/rest/ です。ユーザーロール admin では、すべての要求で HTTP Basic 認証またはトークンベースの認証が必要です。

[GET] /groups

Business Central のすべてのグループを返します。

サーバーの応答例 (JSON)

[
  	{
		"group1"
	},
	{
		"group2"
	}
]

[POST] /groups

Business Central でグループを作成します。グループには、少なくともユーザーを 1 つ割り当てる必要があります。

表29.1 要求パラメーター

Name説明タイプ要件

ボディ

新しいグループに割り当てられたグループとユーザーの名前

要求ボディ

必須

要求ボディ (JSON) 例

{
  "name": "groupName",
  "users": [
    "userNames"
  ]
}

サーバーの応答例 (JSON)

{
  "status": "OK",
  "message": "Group newGroup is created successfully."
}

[DELETE] /groups/{groupName}

Business Central から指定のグループを削除します。

表29.2 要求パラメーター

Name説明タイプ要件

groupName

削除するグループの名前

文字列

必須

サーバーの応答例 (JSON)

{
  "status": "OK",
  "message": "Group newGroup is deleted successfully."
}