groupLifecyclePolicy resource type
Namespace: microsoft.graph
Represents a lifecycle policy for a Microsoft 365 group. A group lifecycle policy allows administrators to set an expiration period for groups. 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 and the group's expirationDateTime property defines the new expiration date.
- If the group is not renewed, it expires and is deleted. The group can be restored within a period of 30 days from deletion.
Methods
Method | Return Type | Description |
---|---|---|
Get groupLifecyclePolicy | groupLifecyclePolicy | Read properties and relationships of a groupLifecyclePolicy object. |
List groupLifecyclePolicies | groupLifecyclePolicy collection | List all the groupLifecyclePolicies. |
Update groupLifecyclePolicy | groupLifecyclePolicy | Update a groupLifecyclePolicy object. |
Delete groupLifecyclePolicy | None | Delete a groupLifecyclePolicy object. |
Add a group to a groupLifecyclePolicy | None | Add a group to a lifecycle policy |
Remove a group from a groupLifecyclePolicy | None | Remove a group to a lifecycle policy. |
Properties
Property | Type | Description |
---|---|---|
alternateNotificationEmails | String | List of email address to send notifications for groups without owners. Multiple email address can be defined by separating email address with a semicolon. |
groupLifetimeInDays | Int32 | 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. |
id | String | A unique identifier for a policy. Read-only. |
managedGroupTypes | String | The group type for which the expiration policy applies. Possible values are All, Selected or None. |
Relationships
None.
JSON representation
The following JSON representation shows the resource type.
{
"alternateNotificationEmails": "String",
"groupLifetimeInDays": 180,
"id": "String (identifier)",
"managedGroupTypes": "String"
}
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for