Skip to content

Commit f817011

Browse files
authored
Merge pull request #28561 from microsoftgraph/user/abbhadauria/deactivateAndDeleteBrief
Delete and deactivate explained
2 parents d5e5fae + a2f3662 commit f817011

7 files changed

Lines changed: 30 additions & 6 deletions

File tree

api-reference/beta/api/protectionpolicybase-deactivate.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,10 @@ Namespace: microsoft.graph
1717

1818
Deactivate a [protectionPolicyBase](../resources/protectionpolicybase.md).
1919

20+
When a protection policy is deactivated, backup activity stops immediately, no new backups are taken, and the protected resources are no longer covered by the policy. Any backups taken before deactivation are retained according to the retention policy, after which they're offboarded. You can restore data using previous restore points even after deactivation.
21+
22+
To reactivate a deactivated policy, use the [activate](protectionpolicybase-activate.md) API.
23+
2024
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
2125

2226
## Permissions

api-reference/beta/api/protectionpolicybase-delete.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "Delete protectionPolicyBase"
3-
description: "Delete a protection policy"
3+
description: "Delete a protectionPolicyBase object."
44
author: "tushar20"
55
ms.reviewer: "manikantsinghms"
66
ms.localizationpriority: medium
@@ -14,7 +14,9 @@ Namespace: microsoft.graph
1414

1515
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
1616

17-
Delete a protection policy. Read the properties and relationships of a [protectionPolicyBase](../resources/protectionpolicybase.md) object.
17+
Delete a [protectionPolicyBase](../resources/protectionpolicybase.md) object.
18+
19+
A protection policy can be deleted only after it was deactivated. When you delete a policy, all associated protection units are removed, and backup protection stops for the resources previously covered by the policy. Existing backup data is retained according to the retention policy before it's offboarded. You can restore data using previous restore points even after deletion.
1820

1921
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
2022

api-reference/beta/resources/protectionpolicybase.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ Base type for [sharePointProtectionPolicy](../resources/sharepointprotectionpoli
2727
|:---|:---|:---|
2828
|[List](../api/backuprestoreroot-list-protectionpolicies.md)|[protectionPolicyBase](../resources/protectionpolicybase.md) collection|Get a list of the [protectionPolicyBase](../resources/protectionpolicybase.md) and their properties.|
2929
|[Get](../api/protectionpolicybase-get.md)|[protectionPolicyBase](../resources/protectionpolicybase.md)|Read the properties and relationships of a [protectionPolicyBase](../resources/protectionpolicybase.md).|
30-
|[Delete](../api/protectionpolicybase-delete.md)|None|Delete a [protectionPolicyBase](../resources/protectionpolicybase.md).|
30+
|[Delete](../api/protectionpolicybase-delete.md)|None|Delete a [protectionPolicyBase](../resources/protectionpolicybase.md) object.|
3131
|[Activate](../api/protectionpolicybase-activate.md)|[protectionPolicyBase](../resources/protectionpolicybase.md)|Activate an inactive protection policy.|
3232
|[Deactivate](../api/protectionpolicybase-deactivate.md)|[protectionPolicyBase](../resources/protectionpolicybase.md)|Deactivate an active protection policy.|
3333

api-reference/v1.0/api/protectionpolicybase-deactivate.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,10 @@ Namespace: microsoft.graph
1515

1616
Deactivate a [protectionPolicyBase](../resources/protectionpolicybase.md).
1717

18+
When a protection policy is deactivated, backup activity stops immediately, no new backups are taken, and the protected resources are no longer covered by the policy. Any backups taken before deactivation are retained according to the retention policy, after which they're offboarded. You can restore data using previous restore points even after deactivation.
19+
20+
To reactivate a deactivated policy, use the [activate](protectionpolicybase-activate.md) API.
21+
1822
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
1923

2024
## Permissions

api-reference/v1.0/api/protectionpolicybase-delete.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "Delete protectionPolicyBase"
3-
description: "Delete a protection policy"
3+
description: "Delete a protectionPolicyBase object."
44
author: "tushar20"
55
ms.reviewer: "manikantsinghms"
66
ms.localizationpriority: medium
@@ -12,7 +12,9 @@ ms.date: 09/10/2024
1212

1313
Namespace: microsoft.graph
1414

15-
Delete a protection policy. Read the properties and relationships of a [protectionPolicyBase](../resources/protectionpolicybase.md) object.
15+
Delete a [protectionPolicyBase](../resources/protectionpolicybase.md) object.
16+
17+
A protection policy can be deleted only after it was deactivated. When you delete a policy, all associated protection units are removed, and backup protection stops for the resources previously covered by the policy. Existing backup data is retained according to the retention policy before it's offboarded. You can restore data using previous restore points even after deletion.
1618

1719
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
1820

api-reference/v1.0/resources/protectionpolicybase.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ Base type for [sharePointProtectionPolicy](../resources/sharepointprotectionpoli
2525
|:---|:---|:---|
2626
|[List](../api/backuprestoreroot-list-protectionpolicies.md)|[protectionPolicyBase](../resources/protectionpolicybase.md) collection|Get a list of the [protectionPolicyBase](../resources/protectionpolicybase.md) and their properties.|
2727
|[Get](../api/protectionpolicybase-get.md)|[protectionPolicyBase](../resources/protectionpolicybase.md)|Read the properties and relationships of a [protectionPolicyBase](../resources/protectionpolicybase.md).|
28-
|[Delete](../api/protectionpolicybase-delete.md)|None|Delete a [protectionPolicyBase](../resources/protectionpolicybase.md).|
28+
|[Delete](../api/protectionpolicybase-delete.md)|None|Delete a [protectionPolicyBase](../resources/protectionpolicybase.md) object.|
2929
|[Activate](../api/protectionpolicybase-activate.md)|[protectionPolicyBase](../resources/protectionpolicybase.md)|Activate an inactive protection policy.|
3030
|[Deactivate](../api/protectionpolicybase-deactivate.md)|[protectionPolicyBase](../resources/protectionpolicybase.md)|Deactivate an active protection policy.|
3131

concepts/whats-new-overview.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,10 +20,22 @@ For details about previous updates to Microsoft Graph, see [Microsoft Graph what
2020
2121
## April 2026: New and generally available
2222

23+
### Backup storage
24+
25+
- When a [protection policy is deactivated](/graph/api/protectionpolicybase-deactivate), backup activity stops immediately, no new backups are taken, and the protected resources are no longer covered by the policy. Any backups taken before deactivation are retained according to the retention policy, after which they're offboarded. You can restore data using previous restore points even after deactivation.
26+
- A [protection policy can be deleted](/graph/api/protectionpolicybase-delete) only after it was [deactivated](/graph/api/protectionpolicybase-deactivate). When you delete a policy, all associated protection units are removed, and backup protection stops for the resources previously covered by the policy. Existing backup data is retained according to the retention policy before it's offboarded. You can restore data using previous restore points even after deletion.
27+
2328
### Teamwork and communications | Messaging
2429

2530
Removed the `model` parameters and payment-model guidance from Microsoft Teams export APIs and related change-notification documentation. The `model` query parameter is no longer required and is ignored if supplied. For more information, see [Payment models and licensing requirements for Microsoft Teams APIs](/graph/teams-licenses).
2631

32+
## April 2026: New in preview only
33+
34+
### Backup storage
35+
36+
- When a [protection policy is deactivated](/graph/api/protectionpolicybase-deactivate?view=graph-rest-beta&preserve-view=true), backup activity stops immediately, no new backups are taken, and the protected resources are no longer covered by the policy. Any backups taken before deactivation are retained according to the retention policy, after which they're offboarded. You can restore data using previous restore points even after deactivation.
37+
- A [protection policy can be deleted](/graph/api/protectionpolicybase-delete?view=graph-rest-beta&preserve-view=true) only after it was [deactivated](/graph/api/protectionpolicybase-deactivate?view=graph-rest-beta&preserve-view=true). When you delete a policy, all associated protection units are removed, and backup protection stops for the resources previously covered by the policy. Existing backup data is retained according to the retention policy before it's offboarded. You can restore data using previous restore points even after deletion.
38+
2739
## March 2026: New and generally available
2840

2941
### Applications

0 commit comments

Comments
 (0)