Skip to content

Commit a02d4f7

Browse files
authored
Merge pull request #216349 from v-amallick/Oct-20-2022-QualityStrategy
Quality strategy - Freshness
2 parents 6c8aabd + d2d3cb0 commit a02d4f7

File tree

1 file changed

+29
-17
lines changed

1 file changed

+29
-17
lines changed

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

Lines changed: 29 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,44 +1,56 @@
11
---
2-
title: Create backup policies for blobs using data protection REST API
2+
title: Create Azure Backup policies for blobs using data protection REST API
33
description: In this article, you'll learn how to create and manage backup policies for blobs using REST API.
4-
ms.topic: conceptual
5-
ms.date: 07/09/2021
4+
ms.topic: how-to
5+
ms.date: 10/28/2022
66
ms.assetid: 472d6a4f-7914-454b-b8e4-062e8b556de3
7+
author: v-amallick
8+
ms.service: backup
9+
ms.author: v-amallick
10+
ms.custom: engagement-fy23
711
---
812
# Create Azure Data Protection backup policies for blobs using REST API
913

14+
Azure Backup policy typically governs the retention and schedule of your backups. As operational backup for blobs is continuous in nature, you don't need a schedule to perform backups. The policy is essentially needed to specify the retention period. You can reuse the backup policy to configure backup for multiple storage accounts to a vault.
15+
1016
> [!IMPORTANT]
11-
> Read [this section](blob-backup-configure-manage.md#before-you-start) before proceeding to create the policy and configuring backups for Azure blobs.
17+
> Before you proceed to create the policy and configure backups for Azure blobs, see [this section](blob-backup-configure-manage.md#before-you-start).
1218
13-
A backup policy typically governs the retention and schedule of your backups. Since operational backup for blobs is continuous in nature, you don't need a schedule to perform backups. The policy is essentially needed to specify the retention period. You can reuse the backup policy to configure backup for multiple storage accounts to a vault.
19+
This article describes how to create a policy for blobs in a storage account. Learn about [the process to create a backup policy for an Azure Recovery Services vault using REST API](/rest/api/dataprotection/backup-policies/create-or-update).
1420

1521
>[!NOTE]
16-
>Restoring over long durations may lead to restore operations taking longer to complete. Furthermore, the time that it takes to restore a set of data is based on the number of write and delete operations made during the restore period. For example, an account with one million objects with 3,000 objects added per day and 1,000 objects deleted per day will require approximately two hours to restore to a point 30 days in the past. A retention period and restoration more than 90 days in the past would not be recommended for an account with this rate of change.
22+
>Restoring over long durations may lead to restore operations taking longer to complete. Further, the time that it takes to restore a set of data is based on the number of write and delete operations made during the restore period.
23+
>For example, an account with one million objects with 3,000 objects added per day and 1,000 objects deleted per day will require approximately two hours to restore to a point 30 days in the past. A retention period and restoration more than 90 days in the past would not be recommended for an account with this rate of change.
1724
18-
The steps to create a backup policy for an Azure Recovery Services vault are outlined in the policy [REST API document](/rest/api/dataprotection/backup-policies/create-or-update). Let's use this document as a reference to create a policy for blobs in a storage account.
25+
In this article, you'll learn about:
1926

20-
## Create a policy
27+
> [!div class="checklist"]
28+
> - Create a policy
29+
> - Create the request body
30+
> - Responses
2131
22-
> [!IMPORTANT]
23-
> Currently, we do not support updating or modifying an existing policy. An alternative is to create a new policy with the required details and assign it to the relevant backup instance.
32+
## Create a policy
2433

25-
To create an Azure Backup policy, use the following *PUT* operation
34+
To create an Azure Backup policy, use the following *PUT* operation:
2635

2736
```http
2837
PUT https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupPolicies/{policyName}?api-version=2021-01-01
2938
```
3039

31-
The `{policyName}` and `{vaultName}` are provided in the URI. Additional information is provided in the request body.
40+
The `{policyName}` and `{vaultName}` are provided in the URI. You can find additional information the request body.
41+
42+
> [!IMPORTANT]
43+
> Currently, we don't support updating or modifying an existing policy. So, you can create a new policy with the required details and assign it to the relevant backup instance.
3244
3345
## Create the request body
3446

35-
For example, to create a policy for Blob backup, following are the components of the request body.
47+
For example, to create a policy for Blob backup, use the following component of the request body:
3648

3749
|Name |Required |Type |Description |
3850
|---------|---------|---------|---------|
39-
|properties | True | BaseBackupPolicy:[BackupPolicy](/rest/api/dataprotection/backup-policies/create-or-update#backuppolicy) | BaseBackupPolicyResource properties |
51+
|`properties` | True | BaseBackupPolicy:[BackupPolicy](/rest/api/dataprotection/backup-policies/create-or-update#backuppolicy) | BaseBackupPolicyResource properties |
4052

41-
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).
53+
For the complete list of definitions in the request body, see the [backup policy REST API document](/rest/api/dataprotection/backup-policies/create-or-update).
4254

4355
### Example request body
4456

@@ -80,11 +92,11 @@ The policy says:
8092
```
8193

8294
> [!IMPORTANT]
83-
> The time formats for support only DateTime. They don't support Time format alone.
95+
> The supported time formats is *DateTime* only. They don't support *Time* format alone.
8496
8597
## Responses
8698

87-
The backup policy creation/update is a synchronous operation and returns OK once the operation is successful.
99+
The backup policy creation/update is an asynchronous operation and returns *OK* once the operation is successful.
88100

89101
|Name |Type |Description |
90102
|---------|---------|---------|

0 commit comments

Comments
 (0)