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.
MethodsMethods
方法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. |
属性Properties
属性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. 可取值为 All、Selected 或 None。Possible values are All, Selected or None. |
关系Relationships
无。None.
JSON 表示形式JSON representation
下面是资源的 JSON 表示形式。Here is a JSON representation of the resource.
{
"alternateNotificationEmails": "String",
"groupLifetimeInDays": 180,
"id": "Guid (identifier)",
"managedGroupTypes": "String"
}