Merge pull request #266801 from AbhishekMallick-MS/Feb-20-2024-Freshness

Freshness - CCreate RS policy via REST API

Author: prmerger-automator[bot]

articles/backup/backup-azure-arm-userestapi-createorupdatepolicy.md

@@ -1,20 +1,23 @@
 ---
-title: Create backup policies using REST API
+title: Create backup policies via REST API in Azure Backup
 description: In this article, you'll learn how to create and manage backup policies (schedule and retention) using REST API.
 ms.topic: how-to
-ms.date: 02/14/2023
+ms.date: 02/21/2024
 ms.assetid: 5ffc4115-0ae5-4b85-a18c-8a942f6d4870
 ms.service: backup
+ms.custom: engagement-fy24
 author: AbhishekMallick-MS
 ms.author: v-abhmallick
 ---
-# Create Azure Recovery Services backup policies using REST API
+# Create Azure Recovery Services backup policies by using REST API
 
-The steps to create a backup policy for an Azure Recovery Services vault are outlined in the [policy REST API document](/rest/api/backup/protection-policies/create-or-update). Let's use this document as a reference to create a policy for Azure VM backup.
+This article describes how to create policies for the backup of Azure VM, SQL database in Azure VM, SAP HANA database in Azure VM, and Azure File share.
+
+Learn more about [creating or modifying a backup policy for an Azure Recovery Services vault by using REST API](/rest/api/backup/protection-policies/create-or-update). 
 
 ## Create or update a policy
 
-To create or update an Azure Backup policy, use the following *PUT* operation
+To create or update an Azure Backup policy, use the following *PUT* operation.
 
 ```http
 PUT https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupPolicies/{policyName}?api-version=2019-05-13
@@ -24,18 +27,22 @@ The `{policyName}` and `{vaultName}` are provided in the URI. Additional informa
 
 ## Create the request body
 
-For example, to create a policy for Azure VM backup, following are the components of the request body.
+If you want to create a policy for Azure VM backup, the request body needs to have the following components:
 
 |Name  |Required  |Type  |Description  |
 |---------|---------|---------|---------|
 |properties     |   True      |  ProtectionPolicy:[AzureIaaSVMProtectionPolicy](/rest/api/backup/protection-policies/create-or-update#azureiaasvmprotectionpolicy)      | ProtectionPolicyResource properties        |
 |tags     |         | Object        |  Resource tags       |
 
-For the complete list of definitions in the request body, refer to the [backup policy REST API document](/rest/api/backup/protection-policies/create-or-update).
+For the complete list of definitions in the request body, see the [backup policy REST API article](/rest/api/backup/protection-policies/create-or-update).
 
 ### Example request body
 
-#### For Azure VM backup
+This section provides the example request body to create policies for the backup of Azure VM, SQL database in Azure VM, SAP HANA database in Azure VM, and Azure File share.
+
+**Choose a datasource**:
+
+# [Azure VM](#tab/azure-vm)
 
 The following request body defines a standard backup policy for Azure VM backups.
 
@@ -214,9 +221,9 @@ This policy:
 
 
 
-#### For SQL in Azure VM backup
+# [SQL in Azure VM](#tab/sql-in-azure-vm)
 
-The following is an example request body for SQL in Azure VM backup.
+The following request body defines the backup policy for SQL in Azure VM backup.
 
 This policy:
 
@@ -400,9 +407,9 @@ The following is an example of a policy that takes a differential backup everyda
   }
 ```
 
-#### For SAP HANA in Azure VM backup
+# [SAP HANA in Azure VM](#tab/sap-hana-in-azure-vm)
 
-The following is an example request body for SQL in Azure VM backup.
+The following request body defines the policy for SAP HANA database in Azure VM backup.
 
 This policy:
 
@@ -622,9 +629,9 @@ The following is an example of a policy that takes a full backup once a week and
 ```
 
 
-#### For Azure File share backup
+# [Azure File share](#tab/azure-file-share)
 
-The following is an example request body for Azure File share backup.
+The following request body defines the policy for Azure File share backup.
 
 This policy:
 
@@ -675,6 +682,8 @@ This policy:
 
 
 
+---
+
 ## Responses
 
 The backup policy creation/update is a [asynchronous operation](../azure-resource-manager/management/async-operations.md). It means this operation creates another operation that needs to be tracked separately.