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

SharePoint REST API を使用してファイルに対してロールを付与するには、AddRoleAssignment エンドポイントを使用します。以下は、このエンドポイントの使用例です。

http

Copy code

POST https://<site-url>/_api/web/GetFileByServerRelativeUrl('<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 オブジェクトが返されることが期待されます。