Merge pull request #237446 from AbhishekMallick01/May-9-2023-QS

QS - Freshness - Article updates

Author: prmerger-automator[bot]

articles/backup/backup-azure-dataprotection-use-rest-api-create-update-disk-policy.md

@@ -1,27 +1,27 @@
 ---
 title: Create backup policies for disks using data protection REST API
 description: In this article, you'll learn how to create and manage backup policies for disks using REST API.
-ms.topic: conceptual
-ms.date: 10/06/2021
+ms.topic: how-to
+ms.date: 05/10/2023
 ms.assetid: ecc107c0-311c-42d0-a094-654d7ee30443
 ms.service: backup
 author: jyothisuri
 ms.author: jsuri
+ms.custom: engagement-fy23
 ---
 
 # Create Azure Data Protection backup policies for disks using REST API
 
-A backup policy governs the retention and schedule of your backups. Azure Disk Backup offers multiple backups per day.
+This article describes how to create a backup policy via REST API.
 
-You can reuse the backup policy to configure backup for multiple Azure Disks to a vault or [create a backup policy for an Azure Recovery Services vault using REST API](/rest/api/dataprotection/backup-policies/create-or-update).
+Azure Disk Backup offers a turnkey solution that provides snapshot lifecycle management for managed disks by automating periodic creation of snapshots and retaining it for configured duration using backup policy. You can manage the disk snapshots with zero infrastructure cost and without the need for custom scripting or any management overhead. This is a crash-consistent backup solution that takes point-in-time backup of a managed disk using incremental snapshots with support for multiple backups per day. It's also an agent-less solution and doesn't impact production application performance. It supports backup and restore of both OS and data disks (including shared disks), whether or not they're currently attached to a running Azure virtual machine.
+
+The backup policy helps to govern the retention and schedule of your backups. The backup policy offers multiple backups per day. You can reuse the backup policy to configure backup for multiple Azure Disks to a vault or [create a backup policy for an Azure Recovery Services vault using REST API](/rest/api/dataprotection/backup-policies/create-or-update).
 
 To create a policy for backing up disks, perform the following actions:
 
 ## Create a policy
 
->[!IMPORTANT]
->Currently, updating or modifying an existing policy isn't supported. Alternatively, you can create a new policy with the required details and assign it to the relevant backup instance.
-
 To create an Azure Backup policy, use the following *PUT* operation:
 
 ```http
@@ -30,7 +30,10 @@ PUT https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{
 
 The `{policyName}` and `{vaultName}` are provided in the URI. Additional information is provided in the request body.
 
-## Create the request body
+>[!IMPORTANT]
+>Currently, updating or modifying an existing policy isn't supported. Alternatively, you can create a new policy with the required details and assign it to the relevant backup instance.
+
+### Create the request body
 
 For example, to create a policy for Disk backup, the request body needs the following components:
 
@@ -40,7 +43,7 @@ For example, to create a policy for Disk backup, the request body needs the foll
 
 For the complete list of definitions in the request body, refer to the [backup policy REST API document](/rest/api/dataprotection/backup-policies/create-or-update).
 
-### Example request body
+**Example request body**
 
 The policy says:
 
@@ -116,15 +119,15 @@ The time required for completing the backup operation depends on various factors
 
 To know more details about policy creation, refer to the [Azure Disk Backup policy](backup-managed-disks.md#create-backup-policy) document.
 
-## Responses
+### Responses
 
 The backup policy creation/update is a synchronous operation and returns OK once the operation is successful.
 
 |Name  |Type  |Description  |
 |---------|---------|---------|
 |200 OK     |     [BaseBackupPolicyResource](/rest/api/dataprotection/backup-policies/create-or-update#basebackuppolicyresource)     |  OK       |
 
-### Example responses
+**Example responses**
 
 Once the operation completes, it returns 200 (OK) with the policy content in the response body.