所有者の追加

名前空間: microsoft.graph

ユーザーまたはサービス プリンシパルを Microsoft 365 またはセキュリティ グループの所有者に追加します。 所有者は、グループ オブジェクトの変更を許可されている、ユーザーまたはサービス プリンシパルのセットです。

Important: グループの所持者を更新しグループのチームを作成した場合、 Microsoft Teams と所有者が同期するまで最大で 2 時間かかります。 また、たとえば Planner プランを作成することによって所有者が Team で変更を加えられるようにしたい場合は、所有者もグループまたはチームのメンバーとして追加する必要があります。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください

アクセス許可の種類 最小特権アクセス許可 特権の高いアクセス許可
委任 (職場または学校のアカウント) Group.ReadWrite.All Directory.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション Group.ReadWrite.All Directory.ReadWrite.All

サインインしたユーザーには、次のMicrosoft Entraロールの少なくとも 1 つを割り当てる必要があります。

Microsoft Entraロール 制限事項
ユーザー管理者 ユーザー所有者のみを変更できます
ディレクトリ製作者 ユーザー所有者のみを変更できます
グループ管理者 すべての種類のグループ所有者を変更できます
Exchange サービス管理者 Microsoft 365 グループの所有者のみを変更できます
SharePoint サービス管理者 Microsoft 365 グループの所有者のみを変更できます
Teams 管理者 Microsoft 365 グループの所有者のみを変更できます
Yammer 管理者 Microsoft 365 グループの所有者のみを変更できます
Intune管理者 セキュリティ グループの所有者のみを変更できます
ナレッジ管理者 セキュリティ グループの所有者のみを変更できます
ナレッジ マネージャー セキュリティ グループの所有者のみを変更できます
Windows 365 管理者 セキュリティ グループの所有者のみを変更できます

HTTP 要求

POST /groups/{id}/owners/$ref

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。
Content-Type application/json. 必須です。

要求本文

要求本文で、追加する ユーザーまたは servicePrincipal オブジェクトの @odata.id を含む JSON 表記を指定します

応答

成功した場合、このメソッドは 204 No Content 応答コードを返します。 応答本文では何も返されません。 このメソッドは、オブジェクトが既にグループのメンバーである場合、 400 Bad Request 応答コードを返します。 このメソッドは、追加されるオブジェクトが存在しない場合、 404 Not Found 応答コードを返します。

要求

次の例は、ユーザーをグループ所有者として追加する要求を示しています。

POST https://graph.microsoft.com/v1.0/groups/{id}/owners/$ref
Content-type: application/json

{
  "@odata.id": "https://graph.microsoft.com/v1.0/users/{id}"
}

要求本文で、追加するユーザーまたは servicePrincipal オブジェクトの @odata.id を含む JSON 表記を指定します。

応答

次の例は応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 204 No Content