Skip to content

Commit 498ff85

Browse files
Merge pull request #294509 from AbhishekMallick01/Feb-12-2025-Incubation
Incubation <50 visitors - Backup blob via REST API
2 parents 6f4fb17 + b1c1e05 commit 498ff85

10 files changed

+34
-32
lines changed

articles/backup/backup-azure-dataprotection-use-rest-api-backup-blobs.md

Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Back up blobs in a storage account using Azure Data Protection REST API.
33
description: In this article, learn how to configure, initiate, and manage backup operations of blobs using REST API.
44
ms.topic: how-to
5-
ms.date: 02/09/2025
5+
ms.date: 02/12/2025
66
ms.assetid: 7c244b94-d736-40a8-b94d-c72077080bbe
77
ms.service: azure-backup
88
ms.custom: engagement-fy23
@@ -12,11 +12,11 @@ ms.author: jsuri
1212

1313
# Back up blobs in a storage account using Azure Data Protection via REST API
1414

15-
Azure Backup enables you to easily configure backup for protecting block blobs in your storage accounts.
15+
This article describes how to configure backups for blobs in a storage account via REST API. Backup of blobs is configured at the storage account level.
1616

17-
This article describes how to configure backups for blobs in a storage account via REST API. Backup of blobs is configured at the storage account level. You can now perform [operational](blob-backup-overview.md?tabs=operational-backup) and [vaulted](blob-backup-overview.md?tabs=vaulted-backup) backups to protect block blobs in your storage accounts using Azure Backup.
17+
Azure Backup enables you to easily configure backup for protecting block blobs in your storage accounts. You can do [operational](blob-backup-overview.md?tabs=operational-backup) and [vaulted](blob-backup-overview.md?tabs=vaulted-backup) backups to protect block blobs in your storage accounts using Azure Backup.
1818

19-
For information on the Azure blob region availability, supported scenarios and limitations, see the [support matrix](blob-backup-support-matrix.md).
19+
Learn [about the Azure blob region availability, supported scenarios, and limitations](blob-backup-support-matrix.md).
2020

2121
## Prerequisites
2222

@@ -34,6 +34,8 @@ Once you create the vault and policy, you need to consider two critical points t
3434

3535
### Key entities
3636

37+
For the backup configuration, review the following key entities involved:
38+
3739
- **Storage account containing the blobs to be protected**: Fetch the Azure Resource Manager ID of the storage account which contains the blobs to be protected. This serves as the identifier of the storage account.
3840

3941
For example, we'll use a storage account named *msblobbackup*, under the resource group *RG-BlobBackup*, in a different subscription and in *west US*.
@@ -48,13 +50,13 @@ Once you create the vault and policy, you need to consider two critical points t
4850

4951
### Assign permissions
5052

51-
You need to assign a few permissions via Azure role-based access control (Azure RBAC) to the created vault (represented by vault Managed Service Identity) and the relevant storage account. You can do these via Azure portal, PowerShell, or REST API. Learn more about all [related permissions](blob-backup-configure-manage.md#grant-permissions-to-the-backup-vault-on-storage-accounts).
53+
Assign a few permissions via Azure role-based access control (Azure RBAC) to the created vault (represented by vault Managed Service Identity) and the relevant storage account. You can assign the permissions via Azure portal, PowerShell, or REST API. Learn more about all [related permissions](blob-backup-configure-manage.md#grant-permissions-to-the-backup-vault-on-storage-accounts).
5254

5355
### Prepare the request to configure blob backup
5456

5557
Once the relevant permissions to the vault and storage account are set, and the vault and policy configuration are done, prepare the request to configure backup.
5658

57-
The following is the request body to configure backup for all blobs within a storage account. The Azure Resource Manager ID (ARM ID) of the storage account and its details are mentioned in the *datasourceinfo* section and the policy information is present in the *policyinfo* section.
59+
The following is the request body to configure backup for all blobs within a storage account. The Azure Resource Manager ID (ARM ID) of the storage account and its details are mentioned in the `datasourceinfo` section and the policy information is present in the `policyinfo` section.
5860

5961
```json
6062
{
@@ -117,7 +119,7 @@ backupInstanceResourceType is Microsoft.Storage/storageAccounts
117119

118120
### Validate the request to configure backup
119121

120-
To validate if the request to configure backup will be successful, use [the validate for backup API](/rest/api/dataprotection/backup-instances/validate-for-backup). You can use the response to perform all required prerequisites and then submit the configuration for backup request.
122+
To validate if the request to configure backup will succeed, use [the validate for backup API](/rest/api/dataprotection/backup-instances/validate-for-backup). You can use the response to perform all required prerequisites and then submit the configuration for backup request.
121123

122124
*Validate for backup request* is a *POST operation and the URI has `{subscriptionId}`, `{vaultName}`, `{vaultresourceGroupName}` parameters.
123125

@@ -192,9 +194,9 @@ The [request body](#prepare-the-request-to-configure-blob-backup) that you prepa
192194

193195
#### Responses for validate backup request
194196

195-
Validate for backup request is an [asynchronous operation](../azure-resource-manager/management/async-operations.md). It means this operation creates another operation that needs to be tracked separately.
197+
Validate for backup request is an [asynchronous operation](../azure-resource-manager/management/async-operations.md). This operation creates another operation that needs to be tracked separately.
196198

197-
It returns two responses: 202 (Accepted) when another operation is created and then 200 (OK) when that operation completes.
199+
It returns two responses: 202 (Accepted) when another operation is created; 200 (OK) when that operation completes.
198200

199201
|Name |Type |Description |
200202
|---------|---------|---------|
@@ -332,7 +334,7 @@ GET https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx
332334
}
333335
```
334336

335-
If all the permissions are granted, then resubmit the validate request and track the resulting operation. It returns 200 (OK) as succeeded, if all the conditions are met.
337+
If all the permissions are granted, then resubmit the validate request job and track the resulting operation. It returns 200 (OK) as succeeded, if all the conditions are met.
336338

337339
```http
338340
GET https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx/providers/Microsoft.DataProtection/locations/westus/operationStatus/ZmMzNDFmYWMtZWJlMS00NGJhLWE4YTgtMDNjYjI4Y2M5OTExOzlhMjk2YWM2LWRjNDMtNGRjZS1iZTU2LTRkZDNiMDhjZDlkOA==?api-version=2021-01-01
@@ -400,9 +402,9 @@ Use the same request body that you used to validate the backup request with a un
400402

401403
#### Responses to configure backup request
402404

403-
The create backup instance request is an [asynchronous operation](../azure-resource-manager/management/async-operations.md). It means this operation creates another operation that needs to be tracked separately.
405+
The create backup instance request is an [asynchronous operation](../azure-resource-manager/management/async-operations.md). This operation creates another operation that needs to be tracked separately.
404406

405-
It returns two responses: 201 (Created) when backup instance is created and the protection is being configured and then 200 (OK) when that configuration completes.
407+
It returns two responses: 201 (Created) when backup instance is created and the protection is being configured; 200 (OK) when that configuration completes.
406408

407409
|Name |Type |Description |
408410
|---------|---------|---------|
@@ -503,9 +505,9 @@ DELETE "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx/resourceGroups/Test
503505

504506
#### Responses for delete protection
505507

506-
*DELETE* protection is an [asynchronous operation](../azure-resource-manager/management/async-operations.md). It means this operation creates another operation that needs to be tracked separately.
508+
*DELETE* protection is an [asynchronous operation](../azure-resource-manager/management/async-operations.md). This operation creates another operation that needs to be tracked separately.
507509

508-
It returns two responses: 202 (Accepted) when another operation is created and then 200 (OK) when that operation completes.
510+
It returns two responses: 202 (Accepted) when another operation is created; 200 (OK) when that operation completes.
509511

510512
|Name |Type |Description |
511513
|---------|---------|---------|

articles/backup/backup-blobs-storage-account-arm-template.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,14 +3,14 @@ title: Quickstart - Back up blobs in a storage account via ARM template using Az
33
description: Learn how to back up blobs in a storage account with an ARM template.
44
ms.topic: quickstart
55
ms.custom: devx-track-arm-template
6-
ms.date: 07/24/2024
6+
ms.date: 02/12/2025
77
author: jyothisuri
88
ms.author: jsuri
99
---
1010

1111
# Quickstart: Back up a storage account with Blob data using an ARM template
1212

13-
This quickstart describes how to back up a storage account with Azure Blob data with a vaulted backup policy using an ARM template.
13+
This quickstart describes how to back up a storage account with Azure Blob data with a vaulted backup policy using an ARM template. You can also [configure backup using REST API](backup-azure-dataprotection-use-rest-api-backup-blobs.md).
1414

1515
[!INCLUDE [blob-vaulted-backup-introduction.md](../../includes/blob-vaulted-backup-introduction.md)]
1616

articles/backup/backup-blobs-storage-account-bicep.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,14 +3,14 @@ title: Quickstart - Back up blobs in a storage account
33
description: Learn how to back up blobs in a storage account with a Bicep template.
44
ms.topic: quickstart
55
ms.custom: devx-track-bicep
6-
ms.date: 07/24/2024
6+
ms.date: 02/12/2025
77
author: jyothisuri
88
ms.author: jsuri
99
---
1010

1111
# Quickstart: Back up a storage account with Blob data using Azure Backup via a Bicep template
1212

13-
This quickstart describes how to back up a storage account with Azure Blob data with a vaulted backup policy using a Bicep template.
13+
This quickstart describes how to back up a storage account with Azure Blob data with a vaulted backup policy using a Bicep template. You can also [configure backup using REST API](backup-azure-dataprotection-use-rest-api-backup-blobs.md).
1414

1515
[!INCLUDE [blob-vaulted-backup-introduction.md](../../includes/blob-vaulted-backup-introduction.md)]
1616

articles/backup/backup-blobs-storage-account-cli.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,14 +3,14 @@ title: Back up Azure Blobs using Azure CLI
33
description: Learn how to back up Azure Blobs using Azure CLI.
44
ms.topic: how-to
55
ms.custom: devx-track-azurecli
6-
ms.date: 11/26/2024
6+
ms.date: 02/12/2025
77
author: jyothisuri
88
ms.author: jsuri
99
---
1010

1111
# Back up Azure Blobs in a storage account using Azure CLI
1212

13-
This article describes how to back up [Azure Blobs](./blob-backup-overview.md) using Azure CLI. You can now perform [operational](blob-backup-overview.md?tabs=operational-backup) and [vaulted](blob-backup-overview.md?tabs=vaulted-backup) backups to protect block blobs in your storage accounts using Azure Backup.
13+
This article describes how to back up [Azure Blobs](./blob-backup-overview.md) using Azure CLI. You can now perform [operational](blob-backup-overview.md?tabs=operational-backup) and [vaulted](blob-backup-overview.md?tabs=vaulted-backup) backups to protect block blobs in your storage accounts using Azure Backup. You can also [configure backup using REST API](backup-azure-dataprotection-use-rest-api-backup-blobs.md).
1414

1515
For information on the Azure Blobs regions availability, supported scenarios, and limitations, see the [support matrix](blob-backup-support-matrix.md).
1616

articles/backup/backup-blobs-storage-account-ps.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,14 +3,14 @@ title: Back up Azure blobs within a storage account using Azure PowerShell
33
description: Learn how to back up all Azure blobs within a storage account using Azure PowerShell.
44
ms.topic: how-to
55
ms.custom: devx-track-azurepowershell
6-
ms.date: 12/27/2024
6+
ms.date: 02/12/2025
77
author: jyothisuri
88
ms.author: jsuri
99
---
1010

1111
# Back up all Azure blobs in a storage account using Azure PowerShell
1212

13-
This article describes how to back up all [Azure blobs](./blob-backup-overview.md) within a storage account using Azure PowerShell. You can now perform [operational](blob-backup-overview.md?tabs=operational-backup) and [vaulted](blob-backup-overview.md?tabs=vaulted-backup) backups to protect block blobs in your storage accounts using Azure Backup.
13+
This article describes how to back up all [Azure blobs](./blob-backup-overview.md) within a storage account using Azure PowerShell. You can now perform [operational](blob-backup-overview.md?tabs=operational-backup) and [vaulted](blob-backup-overview.md?tabs=vaulted-backup) backups to protect block blobs in your storage accounts using Azure Backup. You can also [configure backup using REST API](backup-azure-dataprotection-use-rest-api-backup-blobs.md)
1414

1515
For information on the Azure blob region availability, supported scenarios and limitations, see the [support matrix](blob-backup-support-matrix.md).
1616

articles/backup/blob-backup-configure-manage.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,15 @@
22
title: Configure and manage backup for Azure Blobs using Azure Backup
33
description: Learn how to configure and manage operational and vaulted backups for Azure Blobs.
44
ms.topic: how-to
5-
ms.date: 12/24/2024
5+
ms.date: 02/12/2025
66
ms.service: azure-backup
77
author: jyothisuri
88
ms.author: jsuri
99
---
1010

1111
# Configure and manage backup for Azure Blobs using Azure Backup
1212

13-
Azure Backup allows you to configure operational and vaulted backups to protect block blobs in your storage accounts. This article describes how to configure and manage backups on one or more storage accounts using the Azure portal.
13+
Azure Backup allows you to configure operational and vaulted backups to protect block blobs in your storage accounts. This article describes how to configure and manage backups on one or more storage accounts using the Azure portal. You can also [configure backup using REST API](backup-azure-dataprotection-use-rest-api-backup-blobs.md).
1414

1515
## Before you start
1616

articles/backup/blob-backup-configure-quick.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,15 @@
22
title: Quickstart - Configure vaulted backup for Azure Blobs using Azure Backup
33
description: In this quickstart, learn how to configure vaulted backup for Azure Blobs.
44
ms.topic: quickstart
5-
ms.date: 07/24/2024
5+
ms.date: 02/12/2025
66
ms.service: azure-backup
77
author: jyothisuri
88
ms.author: jsuri
99
---
1010

1111
# Quickstart: Configure vaulted backup for Azure Blobs using Azure Backup
1212

13-
This quickstart describes how to create a backup policy and configure vaulted backup for Azure Blobs from the Azure portal.
13+
This quickstart describes how to create a backup policy and configure vaulted backup for Azure Blobs from the Azure portal. You can also [configure backup using REST API](backup-azure-dataprotection-use-rest-api-backup-blobs.md).
1414

1515
[!INCLUDE [blob-vaulted-backup-introduction.md](../../includes/blob-vaulted-backup-introduction.md)]
1616

articles/backup/blob-backup-configure-tutorial.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,15 @@
22
title: Tutorial - Configure vaulted backup for Azure Blobs using Azure Backup
33
description: In this tutorial, learn how to configure vaulted backup for Azure Blobs.
44
ms.topic: tutorial
5-
ms.date: 07/24/2024
5+
ms.date: 02/12/2025
66
ms.service: azure-backup
77
author: jyothisuri
88
ms.author: jsuri
99
---
1010

1111
# Tutorial: Configure vaulted backup for Azure Blobs using Azure Backup
1212

13-
This tutorial describes how to create a backup policy and configure vaulted backup for Azure Blobs from the Azure portal.
13+
This tutorial describes how to create a backup policy and configure vaulted backup for Azure Blobs from the Azure portal. You can also [configure backup using REST API](backup-azure-dataprotection-use-rest-api-backup-blobs.md).
1414

1515
[!INCLUDE [blob-vaulted-backup-introduction.md](../../includes/blob-vaulted-backup-introduction.md)]
1616

articles/backup/quick-blob-vaulted-backup-cli.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,15 +3,15 @@ title: Quickstart - Configure vaulted backup for Azure Blobs using Azure CLI
33
description: In this Quickstart, learn how to configure vaulted backup for Azure Blobs using Azure CLI.
44
ms.devlang: azurecli
55
ms.topic: quickstart
6-
ms.date: 07/24/2024
6+
ms.date: 02/12/2025
77
ms.custom: mvc, devx-track-azurepowershell, mode-api
88
author: jyothisuri
99
ms.author: jsuri
1010
---
1111

1212
# Quickstart: Configure vaulted backup for Azure Blobs using Azure Backup via Azure CLI
1313

14-
This quickstart describes how to configure vaulted backup for Azure Blobs using Azure CLI.
14+
This quickstart describes how to configure vaulted backup for Azure Blobs using Azure CLI. You can also [configure backup using REST API](backup-azure-dataprotection-use-rest-api-backup-blobs.md).
1515

1616
[!INCLUDE [blob-vaulted-backup-introduction.md](../../includes/blob-vaulted-backup-introduction.md)]
1717

articles/backup/quick-blob-vaulted-backup-powershell.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,15 +3,15 @@ title: Quickstart - Configure vaulted backup for Azure Blobs using Azure PowerSh
33
description: In this Quickstart, learn how to configure vaulted backup for Azure Blobs using Azure PowerShell.
44
ms.devlang: azurecli
55
ms.topic: quickstart
6-
ms.date: 07/24/2024
6+
ms.date: 02/12/2025
77
ms.custom: mvc, devx-track-azurepowershell, mode-api
88
author: jyothisuri
99
ms.author: jsuri
1010
---
1111

1212
# Quickstart: Configure vaulted backup for Azure Blobs using Azure Backup via Azure PowerShell
1313

14-
This quickstart describes how to configure vaulted backup for Azure Blobs using Azure PowerShell.
14+
This quickstart describes how to configure vaulted backup for Azure Blobs using Azure PowerShell. You can also [configure backup using REST API](backup-azure-dataprotection-use-rest-api-backup-blobs.md).
1515

1616
[!INCLUDE [blob-vaulted-backup-introduction.md](../../includes/blob-vaulted-backup-introduction.md)]
1717

0 commit comments

Comments
 (0)