Skip to content

Commit 63601b6

Browse files
committed
Consistency edits, remove Service Admin error
1 parent 81c509c commit 63601b6

File tree

1 file changed

+24
-30
lines changed

1 file changed

+24
-30
lines changed

articles/role-based-access-control/classic-administrators.md

Lines changed: 24 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Azure classic subscription administrators
3-
description: Describes the retirement of the Co-Administrator and Service Administrator roles and how to replace or remove these role assignments.
3+
description: Describes the retirement of the Co-Administrator and Service Administrator roles and how to convert these role assignments.
44
author: rolyon
55
manager: amycolannino
66

@@ -14,17 +14,17 @@ ms.reviewer: bagovind
1414
# Azure classic subscription administrators
1515

1616
> [!IMPORTANT]
17-
> Classic resources and classic administrators are [retired as of August 31, 2024](https://azure.microsoft.com/updates/cloud-services-retirement-announcement/). Replace or remove classic administrators and use Azure RBAC instead for fine-grained access control.
17+
> As of **August 31, 2024**, Azure classic administrator roles (along with Azure classic resources and Azure Service Manager) are retired and no longer supported.
1818
1919
Microsoft recommends that you manage access to Azure resources using Azure role-based access control (Azure RBAC). If you're still using the classic deployment model, you'll need to migrate your resources from classic deployment to Resource Manager deployment. For more information, see [Azure Resource Manager vs. classic deployment](../azure-resource-manager/management/deployment-models.md).
2020

21-
If you still have classic administrators, you should replace or remove these role assignments. This article describes the retirement of the Co-Administrator and Service Administrator roles and how to replace or remove these role assignments.
21+
If you still have active Co-Administrator or Service Administrator role assignments, convert these roles to Azure RBAC immediately. This article describes the retirement of the Co-Administrator and Service Administrator roles and how to convert these role assignments.
2222

2323
## Frequently asked questions
2424

25-
Do Co-Administrators and Service Administrator lose access after August 31, 2024?
25+
What happens to classic administrator role assignments after August 31, 2024?
2626

27-
- Starting on August 31, 2024, Microsoft will start the process to remove access for Co-Administrators and Service Administrator.
27+
- Co-Administrator and Service Administrator roles are retired and no longer supported. You should convert these roles to Azure RBAC immediately.
2828

2929
How do I know what subscriptions have classic administrators?
3030

@@ -40,11 +40,11 @@ What is the equivalent Azure role I should assign for Service Administrator?
4040

4141
Why do I need to migrate to Azure RBAC?
4242

43-
- Classic administrators are retired. Azure RBAC offers fine grained access control, compatibility with Microsoft Entra Privileged Identity Management (PIM), and full audit logs support. All future investments will be in Azure RBAC.
43+
- Azure RBAC offers fine grained access control, compatibility with Microsoft Entra Privileged Identity Management (PIM), and full audit logs support. All future investments will be in Azure RBAC.
4444

4545
What about the Account Administrator role?
4646

47-
- The Account Administrator is the primary user for your billing account. Account Administrator isn't being deprecated and you don't need to replace this role assignment. Account Administrator and Service Administrator might be the same user. However, you only need to replace or remove the Service Administrator role assignment.
47+
- The Account Administrator is the primary user for your billing account. Account Administrator isn't being deprecated and you don't need to convert this role assignment. Account Administrator and Service Administrator might be the same user. However, you only need to convert the Service Administrator role assignment.
4848

4949
What should I do if I lose access to a subscription?
5050

@@ -112,7 +112,7 @@ Follow these steps to list the number of Service Administrator and Co-Administra
112112
113113
## Co-Administrators retirement
114114
115-
If you still have classic administrators, use the following steps to help you replace or remove Co-Administrator role assignments.
115+
If you still have classic administrators, use the following steps to help you convert Co-Administrator role assignments.
116116
117117
### Step 1: Review your current Co-Administrators
118118
@@ -134,7 +134,7 @@ If you still have classic administrators, use the following steps to help you re
134134
135135
1. After reviewing activity of user, if user is no longer active, [remove Co-Administrator](#how-to-remove-a-co-administrator).
136136
137-
### Step 3: Replace Co-Administrators with job function roles
137+
### Step 3: Convert Co-Administrators to job function roles
138138
139139
Most users don't need the same permissions as a Co-Administrator. Consider a job function role instead.
140140
@@ -146,25 +146,25 @@ Most users don't need the same permissions as a Co-Administrator. Consider a job
146146
147147
1. [Remove Co-Administrator](#how-to-remove-a-co-administrator).
148148
149-
### Step 4: Replace Co-Administrators with Owner role and constraints
149+
### Step 4: Convert Co-Administrators to Owner role with conditions
150150
151151
Some users might need more access than what a job function role can provide. If you must assign the [Owner](built-in-roles.md#owner) role, consider adding a condition or using Microsoft Entra Privileged Identity Management (PIM) to constrain the role assignment.
152152
153-
1. Assign the Owner role with constraints.
153+
1. Assign the Owner role with conditions.
154154
155155
For example, assign the [Owner role at subscription scope with conditions](role-assignments-portal-subscription-admin.yml). If you have PIM, make the user [eligible for Owner role assignment](/entra/id-governance/privileged-identity-management/pim-resource-roles-assign-roles).
156156
157157
1. [Remove Co-Administrator](#how-to-remove-a-co-administrator).
158158
159-
### Step 5: Replace Co-Administrators with Owner role
159+
### Step 5: Convert Co-Administrators to Owner role
160160
161161
If a user must be an administrator for a subscription, assign the [Owner](built-in-roles.md#owner) role at subscription scope.
162162
163-
- Follow the steps in [Replace a Co-Administrator with Owner role](#replace-a-co-administrator-with-owner-role).
163+
- Follow the steps in [How to convert a Co-Administrator with Owner role](#how-to-convert-a-co-administrator-to-owner-role).
164164
165-
### How to replace a Co-Administrator with Owner role
165+
### How to convert a Co-Administrator to Owner role
166166
167-
The easiest way to replace a Co-Administrator role assignment with the [Owner](built-in-roles.md#owner) role at subscription scope is to use the **Remediate** steps.
167+
The easiest way to covert a Co-Administrator role assignment to the [Owner](built-in-roles.md#owner) role at subscription scope is to use the **Remediate** steps.
168168
169169
1. Sign in to the [Azure portal](https://portal.azure.com) as an [Owner](built-in-roles.md#owner) of a subscription.
170170
@@ -174,13 +174,13 @@ The easiest way to replace a Co-Administrator role assignment with the [Owner](b
174174
175175
1. Select the **Classic administrators** tab to view a list of the Co-Administrators.
176176
177-
1. For the Co-Administrator you want to replace with the Owner role, under the **Remediate** column, select the **Assign RBAC role** link.
177+
1. For the Co-Administrator you want to convert to the Owner role, under the **Remediate** column, select the **Assign RBAC role** link.
178178
179179
1. In the **Add role assignment** pane, review the role assignment.
180180
181181
:::image type="content" source="./media/classic-administrators/remediate-assign-role.png" alt-text="Screenshot of Add role assignment pane after selecting Assign RBAC role link." lightbox="./media/classic-administrators/remediate-assign-role.png":::
182182
183-
1. Select **Review + assign** to remove the Co-Administrator role assignment and assign the Owner role.
183+
1. Select **Review + assign** to assign the Owner role and remove the Co-Administrator role assignment.
184184
185185
### How to remove a Co-Administrator
186186
@@ -204,7 +204,7 @@ Follow these steps to remove a Co-Administrator.
204204
205205
## Service Administrator retirement
206206
207-
If you still have classic administrators, use the following steps to help you replace or remove Service Administrator role assignment. Before you remove the Service Administrator, you must have at least one user who is assigned the Owner role at subscription scope without conditions to avoid orphaning the subscription. A subscription Owner has the same access as the Service Administrator.
207+
If you still have classic administrators, use the following steps to help you convert the Service Administrator role assignment. Before you remove the Service Administrator, you must have at least one user who is assigned the Owner role at subscription scope without conditions to avoid orphaning the subscription. A subscription Owner has the same access as the Service Administrator.
208208
209209
### Step 1: Review your current Service Administrator
210210
@@ -222,19 +222,19 @@ The user that is assigned the Service Administrator role might also be the same
222222
223223
1. Review your list of Billing account owners. If necessary, [update or add another Billing account owner](../cost-management-billing/manage/understand-mca-roles.md#manage-billing-roles-in-the-azure-portal).
224224
225-
### Step 3: Replace Service Administrator with Owner role
225+
### Step 3: Convert Service Administrator to Owner role
226226
227227
Your Service Administrator might be a Microsoft account or a Microsoft Entra account. A Microsoft account is a personal account such as Outlook, OneDrive, Xbox LIVE, or Microsoft 365. A Microsoft Entra account is an identity created through Microsoft Entra ID.
228228
229-
1. If Service Administrator user is a Microsoft account and you want this user to keep the same permissions, [replace the Service Administrator with Owner role](#replace-the-service-administrator-with-owner-role).
229+
1. If Service Administrator user is a Microsoft account and you want this user to keep the same permissions, [convert the Service Administrator to Owner role](#how-to-convert-the-service-administrator-to-owner-role).
230230
231-
1. If Service Administrator user is a Microsoft Entra account and you want this user to keep the same permissions, [replace the Service Administrator with Owner role](#replace-the-service-administrator-with-owner-role).
231+
1. If Service Administrator user is a Microsoft Entra account and you want this user to keep the same permissions, [convert the Service Administrator to Owner role](#how-to-convert-the-service-administrator-to-owner-role).
232232
233233
1. If you want to change the Service Administrator user to a different user, [assign the Owner role](role-assignments-portal.yml) to this new user at subscription scope without conditions. Then, [remove the Service Administrator](#how-to-remove-the-service-administrator).
234234
235-
### How to replace the Service Administrator with Owner role
235+
### How to convert the Service Administrator to Owner role
236236
237-
The easiest way to replace the Service Administrator role assignment with the [Owner](built-in-roles.md#owner) role at subscription scope is to use the **Remediate** steps.
237+
The easiest way to convert the Service Administrator role assignment to the [Owner](built-in-roles.md#owner) role at subscription scope is to use the **Remediate** steps.
238238
239239
1. Sign in to the [Azure portal](https://portal.azure.com) as an [Owner](built-in-roles.md#owner) of a subscription.
240240
@@ -250,7 +250,7 @@ The easiest way to replace the Service Administrator role assignment with the [O
250250
251251
:::image type="content" source="./media/classic-administrators/remediate-assign-role.png" alt-text="Screenshot of Add role assignment pane after selecting Assign RBAC role link." lightbox="./media/classic-administrators/remediate-assign-role.png":::
252252
253-
1. Select **Review + assign** to remove the Service Administrator role assignment and assign the Owner role.
253+
1. Select **Review + assign** to assign the Owner role and remove the Service Administrator role assignment.
254254
255255
### How to remove the Service Administrator
256256
@@ -273,12 +273,6 @@ The easiest way to replace the Service Administrator role assignment with the [O
273273
274274
:::image type="content" source="./media/classic-administrators/service-admin-remove.png" alt-text="Screenshot of remove classic administrator message when removing a Service Administrator." lightbox="./media/classic-administrators/service-admin-remove.png":::
275275
276-
If the Service Administrator user is not in the directory, you might get the following error when you try to remove the Service Administrator:
277-
278-
`Call GSM to delete service admin on subscription <subscriptionId> failed. Exception: Cannot delete user <principalId> since they are not the service administrator. Please retry with the right service administrator user PUID.`
279-
280-
If the Service Administrator user is not in the directory, try to change the Service Administrator to an existing user and then try to remove the Service Administrator.
281-
282276
## Next steps
283277
284278
- [Understand the different roles](../role-based-access-control/rbac-and-directory-admin-roles.md)

0 commit comments

Comments
 (0)