groupLifecyclePolicy 资源类型groupLifecyclePolicy resource type

命名空间:microsoft.graphNamespace: microsoft.graph


Microsoft Graph /beta 中版本下的 API 可能会更改。APIs under the /beta version in Microsoft Graph are subject to change. 不支持在生产应用程序中使用这些 API。Use of these APIs in production applications is not supported. 若要确定 API 在 v1.0 中是否可用,请使用 版本选择 器。To determine whether an API is available in v1.0, use the Version selector.

表示 Microsoft 365 组的生命周期策略。Represents a lifecycle policy for a Microsoft 365 group. 使用组生命周期策略,管理员可以为组设置到期期限。A group lifecycle policy allows administrators to set an expiration period for groups. 例如,组在 180 天后到期。For example, after 180 days, a group expires. 如果组到期,组的所有者必须在管理员定义的时间段内续订组。When a group reaches its expiration, owners of the group are required to renew their group within a time interval defined by the administrator. 续订后,组的有效期就会延长策略中定义的天数。Once renewed, the group expiration is extended by the number of days defined in the policy. 例如,续订后,组的新到期时间是在 180 天后。For example, the group's new expiration is 180 days after renewal. 如果不续订组,组就会到期并被删除。If the group is not renewed, it expires and is deleted. 可以在删除后的 30 天内还原组。The group can be restored within a period of 30 days from deletion.


方法Method 返回类型Return Type 说明Description
获取 groupLifecyclePolicyGet groupLifecyclePolicy groupLifecyclePolicygroupLifecyclePolicy 读取 groupLifecyclePolicy 对象的属性和关系。Read properties and relationships of a groupLifecyclePolicy object.
列出 groupLifecyclePolicyList groupLifecyclePolicies groupLifecyclePolicy 集合groupLifecyclePolicy collection 列出所有 groupLifecyclePolicy。List all the groupLifecyclePolicies.
更新 groupLifecyclePolicyUpdate groupLifecyclePolicy groupLifecyclePolicygroupLifecyclePolicy 更新 groupLifecyclePolicy 对象。Update a groupLifecyclePolicy object.
删除 groupLifecyclePolicyDelete groupLifecyclePolicy None 删除 groupLifecyclePolicy 对象。Delete a groupLifecyclePolicy object.
向 groupLifecyclePolicy 添加组Add a group to a groupLifecyclePolicy None 向生命周期策略添加组Add a group to a lifecycle policy
从 groupLifecyclePolicy 中删除组Remove a group from a groupLifecyclePolicy None 从生命周期策略中删除组Remove a group to a lifecycle policy.
续订组Renew a group None 续订组的到期日期。Renew a group's expiration date.


属性Property 类型Type 说明Description
alternateNotificationEmailsalternateNotificationEmails StringString 针对没有所有者的组向其发送通知的电子邮件地址列表。List of email address to send notifications for groups without owners. 可以用分号隔开电子邮件地址,从而定义多个电子邮件地址。Multiple email address can be defined by separating email address with a semicolon.
groupLifetimeInDaysgroupLifetimeInDays Int32Int32 还剩多少天组就到期且需要续订。Number of days before a group expires and needs to be renewed. 续订后,组的有效期就会延长定义的天数。Once renewed, the group expiration is extended by the number of days defined.
idid GuidGuid 策略的唯一标识符。A unique identifier for a policy. 只读。Read-only.
managedGroupTypesmanagedGroupTypes StringString 到期策略适用的组类型。The group type for which the expiration policy applies. 可取值为 AllSelectedNonePossible values are All, Selected or None.



JSON 表示形式JSON representation

下面是资源的 JSON 表示形式。Here is a JSON representation of the resource.

  "alternateNotificationEmails": "String",
  "groupLifetimeInDays": 180,
  "id": "Guid (identifier)",
  "managedGroupTypes": "String"