「東雲 忠太郎」の平凡な日常のできごと

SharePoint REST API を使用してフォルダに対してロールを割り当てるには、以下の手順に従います。

フォルダの ID を取得します。

ロールの定義 (Role Definition) の ID を取得します。ロールの定義は、例えば "読み取り" や "編集" などの権限を定義します。

ロールを割り当てたいユーザーまたはグループの ID を取得します。

AddRoleAssignment エンドポイントを使用して、指定されたフォルダに対してロールを割り当てます。

以下は、この手順に基づいたエンドポイントの使用例です。

http

Copy code

POST https://<site-url>/_api/web/GetFolderByServerRelativeUrl('<server-relative-url>')/ListItemAllFields/roleassignments/addroleassignment(principalid=<principal-id>, roleDefId=<role-def-id>)

Content-Type: application/json

Authorization: Bearer <access-token>

{

  "__metadata": {

    "type": "SP.RoleAssignment"

  },

  "PrincipalId": <principal-id>,

  "RoleDefId": <role-def-id>

}

このリクエストは、指定されたサーバー上の相対URLにあるフォルダに対して、特定のユーザーまたはグループに特定のロール（権限）を割り当てます。<site-url> は、SharePoint サイトのURL、<server-relative-url> はフォルダのサーバー上の相対URL、<principal-id> はアクセスを付与するユーザーまたはグループのID、<role-def-id> は割り当てるロールの定義のIDです。<access-token> は、適切な認証トークンに置き換える必要があります。

このリクエストの応答は、新しいロールの割り当てを示す JSON オブジェクトが返されることが期待されます。