Skip to content

Commit 38e3424

Browse files
Merge pull request #233007 from kanshiG/patch-129
Update continuous-backup-restore-permissions.md
2 parents 79334c0 + f7e63b5 commit 38e3424

File tree

1 file changed

+11
-8
lines changed

1 file changed

+11
-8
lines changed

articles/cosmos-db/continuous-backup-restore-permissions.md

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to isolate and restrict the restore permissions for conti
44
author: kanshiG
55
ms.service: cosmos-db
66
ms.topic: how-to
7-
ms.date: 02/17/2023
7+
ms.date: 03/31/2023
88
ms.author: govindk
99
ms.reviewer: mjbrown
1010
ms.custom: subject-rbac-steps, ignite-2022, devx-track-azurecli
@@ -13,15 +13,15 @@ ms.custom: subject-rbac-steps, ignite-2022, devx-track-azurecli
1313
# Manage permissions to restore an Azure Cosmos DB account
1414
[!INCLUDE[NoSQL, MongoDB, Gremlin, Table](includes/appliesto-nosql-mongodb-gremlin-table.md)]
1515

16-
Azure Cosmos DB allows you to isolate and restrict the restore permissions for continuous backup account to a specific role or a principal. The owner of the account can trigger a restore and assign a role to other principals to perform the restore operation. These permissions can be applied at the subscription scope or more granularly at the source account scope as shown in the following image:
16+
Azure Cosmos DB allows you to isolate and restrict the restore permissions for continuous backup account to a specific role or a principal. These permissions can be applied at the subscription scope or more granularly at the source account scope as shown in the following image:
1717

1818
:::image type="content" source="./media/continuous-backup-restore-permissions/restore-roles-permissions.svg" alt-text="List of roles required to perform restore operation." border="false":::
1919

2020
Scope is a set of resources that have access, to learn more on scopes, see the [Azure RBAC](../role-based-access-control/scope-overview.md) documentation. In Azure Cosmos DB, applicable scopes are the source subscription and database account for most of the use cases. The principal performing the restore actions should have write permissions to the destination resource group.
2121

2222
## Assign roles for restore using the Azure portal
2323

24-
To perform a restore, a user or a principal need the permission to restore (that is *restore/action* permission), and permission to provision a new account (that is *write* permission). To grant these permissions, the owner can assign the `CosmosRestoreOperator` and `Cosmos DB Operator` built in roles to a principal.
24+
To perform a restore, a user or a principal need the permission to restore (that is *restore/action* permission), and permission to provision a new account (that is *write* permission). To grant these permissions, the owner of the subscription can assign the `CosmosRestoreOperator` and `Cosmos DB Operator` built in roles to a principal.
2525

2626
1. Sign into the [Azure portal](https://portal.azure.com/) and navigate to your subscription. The `CosmosRestoreOperator` role is available at subscription level.
2727

@@ -83,17 +83,20 @@ Following permissions are required to perform the different activities pertainin
8383
Roles with permission can be assigned to different scopes to achieve granular control on who can perform the restore operation within a subscription or a given account.
8484

8585
### Assign capability to restore from any restorable account in a subscription
86-
- Assign a user write action on the specific resource group. This action is required to create a new account in the resource group.
87-
- Assign the `CosmosRestoreOperator` built in role to the specific restorable database account that needs to be restored. In the following command, the scope for the `RestorableDatabaseAccount` is extracted from the `ID` property of result of execution of `az cosmosdb restorable-database-account list`(if using CLI) or `Get-AzCosmosDBRestorableDatabaseAccount`(if using the PowerShell)
8886

89-
Assign the `CosmosRestoreOperator` built-in role at subscription level
87+
- Assign the `CosmosRestoreOperator` built in role to the specific subscription level
9088

9189
```azurecli-interactive
9290
az role assignment create --role "CosmosRestoreOperator" --assignee <email> --scope /subscriptions/<subscriptionId>
9391
```
9492

95-
### Assign capability to restore from a specific account
96-
This operation is currently not supported.
93+
### Assign capability to restore from a specific account
94+
- Assign a user write action on the specific resource group. This action is required to create a new account in the resource group.
95+
- Assign the `CosmosRestoreOperator` built in role to the specific restorable database account that needs to be restored. In the following command, the scope for the `RestorableDatabaseAccount` is extracted from the `ID` property of result of execution of `az cosmosdb restorable-database-account list`(if using CLI) or `Get-AzCosmosDBRestorableDatabaseAccount`(if using the PowerShell)
96+
97+
```azurecli-interactive
98+
az role assignment create --role "CosmosRestoreOperator" --assignee <email> --scope <RestorableDatabaseAccount>
99+
```
97100

98101
### Assign capability to restore from any source account in a resource group.
99102
This operation is currently not supported.

0 commit comments

Comments
 (0)