groupLifecyclePolicy: addGroup

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

将特定组添加到生命周期策略。 只有在 groupLifecyclePolicy 的 managedGroupTypes 属性设置为 时，此操作才将组生命周期策略限制到一组Selected组。

Permissions

要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	Directory.ReadWrite.All
委派（个人 Microsoft 帐户）	不支持
Application	Directory.ReadWrite.All

HTTP 请求

POST /groupLifecyclePolicies/{id}/addGroup

请求标头

名称	说明
Authorization	Bearer {token}。必需。
Content-Type	application/json

请求正文

在请求正文中，提供具有以下参数的 JSON 对象。

参数	类型	说明
groupId	String	要添加到策略的组的标识符。

当 groupLifecyclePolicy Selected的 managedGroupTypes 属性设置为 时，您最多可以将 500 个组添加到列表中。 如果需要添加 500 多个组，groupLifecyclePolicy 的 managedGroupTypes 属性必须设置为 All。

每个请求只能添加一个组。

响应

如果成功，此方法返回 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
}