Skip to content

Commit 1921662

Browse files
authored
Merge pull request #57795 from daveba/update-perms-howto-guides
[Azure AD MI]Update perms howto guides
2 parents 34e2738 + 02f6b54 commit 1921662

File tree

1 file changed

+9
-11
lines changed

1 file changed

+9
-11
lines changed

articles/active-directory/managed-identities-azure-resources/qs-configure-rest-vm.md

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -32,14 +32,6 @@ In this article, using CURL to make calls to the Azure Resource Manager REST end
3232

3333
- If you're unfamiliar with managed identities for Azure resources, check out the [overview section](overview.md). **Be sure to review the [difference between a system-assigned and user-assigned managed identity](overview.md#how-does-it-work)**.
3434
- If you don't already have an Azure account, [sign up for a free account](https://azure.microsoft.com/free/) before continuing.
35-
- To perform the management operations in this article, your account needs the following Azure role based access control assignments:
36-
37-
> [!NOTE]
38-
> No additional Azure AD directory role assignments required.
39-
40-
- [Virtual Machine Contributor](/azure/role-based-access-control/built-in-roles#virtual-machine-contributor) to create a VM and enable and remove system and/or user-assigned managed identity from an Azure VM.
41-
- [Managed Identity Contributor](/azure/role-based-access-control/built-in-roles#managed-identity-contributor) role to create a user-assigned identity.
42-
- [Managed Identity Operator](/azure/role-based-access-control/built-in-roles#managed-identity-operator) role to assign and remove a user-assigned managed identity from and to a VM.
4335
- If you are using Windows, install the [Windows Subsystem for Linux](https://msdn.microsoft.com/commandline/wsl/about) or use the [Azure Cloud Shell](../../cloud-shell/overview.md) in the Azure portal.
4436
- [Install the Azure CLI local console](/cli/azure/install-azure-cli), if you use the [Windows Subsystem for Linux](https://msdn.microsoft.com/commandline/wsl/about) or a [Linux distribution OS](/cli/azure/install-azure-cli-apt?view=azure-cli-latest).
4537
- If you are using Azure CLI local console, sign in to Azure using `az login` with an account that is associated with the Azure subscription you would like to manage system or user-assigned managed identities.
@@ -52,7 +44,7 @@ In this section, you learn how to enable and disable system-assigned managed ide
5244

5345
### Enable system-assigned managed identity during creation of an Azure VM
5446

55-
To create an Azure VM with system-assigned managed identity enabled, you need create a VM and retrieve an access token to use CURL to call the Resource Manager endpoint with the system-assigned managed identity type value.
47+
To create an Azure VM with the system-assigned managed identity enabled,your account needs the [Virtual Machine Contributor](/azure/role-based-access-control/built-in-roles#virtual-machine-contributor) role assignment. No additional Azure AD directory role assignments are required.
5648

5749
1. Create a [resource group](../../azure-resource-manager/resource-group-overview.md#terminology) for containment and deployment of your VM and its related resources, using [az group create](/cli/azure/group/#az-group-create). You can skip this step if you already have resource group you would like to use instead:
5850

@@ -80,7 +72,7 @@ To create an Azure VM with system-assigned managed identity enabled, you need cr
8072

8173
### Enable system-assigned identity on an existing Azure VM
8274

83-
To enable system-assigned identity on an existing VM, you need to acquire an access token and then use CURL to call the Resource Manager REST endpoint to update the identity type.
75+
To enable system-assigned managed identity on a VM that was originally provisioned without it, your account needs the [Virtual Machine Contributor](/azure/role-based-access-control/built-in-roles#virtual-machine-contributor) role assignment. No additional Azure AD directory role assignments are required.
8476

8577
1. Retrieve a Bearer access token, which you will use in the next step in the Authorization header to create your VM with a system-assigned managed identity.
8678

@@ -117,7 +109,7 @@ To enable system-assigned identity on an existing VM, you need to acquire an acc
117109
118110
### Disable system-assigned managed identity from an Azure VM
119111
120-
To disable a system-assigned managed identity on an existing VM, you need to acquire an access token and then use CURL to call the Resource Manager REST endpoint to update the identity type to `None`.
112+
To disable system-assigned managed identity on a VM, your account needs the [Virtual Machine Contributor](/azure/role-based-access-control/built-in-roles#virtual-machine-contributor) role assignment. No additional Azure AD directory role assignments are required.
121113
122114
1. Retrieve a Bearer access token, which you will use in the next step in the Authorization header to create your VM with a system-assigned managed identity.
123115
@@ -142,6 +134,8 @@ In this section, you learn how to add and remove user-assigned managed identity
142134
143135
### Assign a user-assigned managed identity during the creation of an Azure VM
144136
137+
To assign a user-assigned identity to a VM, your account needs the [Virtual Machine Contributor](/azure/role-based-access-control/built-in-roles#virtual-machine-contributor) and [Managed Identity Operator](/azure/role-based-access-control/built-in-roles#managed-identity-operator) role assignments. No additional Azure AD directory role assignments are required.
138+
145139
1. Retrieve a Bearer access token, which you will use in the next step in the Authorization header to create your VM with a system-assigned managed identity.
146140
147141
```azurecli-interactive
@@ -179,6 +173,8 @@ In this section, you learn how to add and remove user-assigned managed identity
179173
180174
### Assign a user-assigned managed identity to an existing Azure VM
181175
176+
To assign a user-assigned identity to a VM, your account needs the [Virtual Machine Contributor](/azure/role-based-access-control/built-in-roles#virtual-machine-contributor) and [Managed Identity Operator](/azure/role-based-access-control/built-in-roles#managed-identity-operator) role assignments. No additional Azure AD directory role assignments are required.
177+
182178
1. Retrieve a Bearer access token, which you will use in the next step in the Authorization header to create your VM with a system-assigned managed identity.
183179
184180
```azurecli-interactive
@@ -235,6 +231,8 @@ In this section, you learn how to add and remove user-assigned managed identity
235231
236232
### Remove a user-assigned managed identity from an Azure VM
237233
234+
To remove a user-assigned identity to a VM, your account needs the [Virtual Machine Contributor](/azure/role-based-access-control/built-in-roles#virtual-machine-contributor) role assignment.
235+
238236
1. Retrieve a Bearer access token, which you will use in the next step in the Authorization header to create your VM with a system-assigned managed identity.
239237
240238
```azurecli-interactive

0 commit comments

Comments
 (0)