groupLifecyclePolicy: addGroup

名前空間: microsoft.graph

重要

Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。

ライフサイクル ポリシーに特定のグループを追加します。 このアクションは、groupLifecyclePolicy の managedGroupTypes プロパティが に 設定されている場合にのみ、グループ ライフサイクル ポリシーをグループのセットに制限しますSelected。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

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

HTTP 要求

POST /groupLifecyclePolicies/{id}/addGroup

要求ヘッダー

名前	説明
Authorization	ベアラー {token}。必須。
Content-Type	application/json

要求本文

要求本文で、次のパラメーターを含む JSON オブジェクトを指定します。

パラメーター	型	説明
groupId	文字列型 (String)	ポリシーに追加するグループの識別子。

groupLifecyclePolicy Selectedの managedGroupTypes プロパティがに設定されている場合、最大 500 グループをリストに追加できます。 500 を超えるグループを追加する必要がある場合は、groupLifecyclePolicy の managedGroupTypes プロパティを に設定する必要がありますAll。

要求ごとに追加できるグループは 1 つのみです。

応答

成功した場合、このメソッドは 200 OK 応答コードを返します。 グループがポリシーに追加された場合、応答 true 本文に値が返されます。 それ以外の場合は false 、応答本文で値が返されます。

例

要求

POST https://graph.microsoft.com/beta/groupLifecyclePolicies/{id}/addGroup
Content-type: application/json

{
  "groupId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
}

応答

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": true
}