Merge pull request #97536 from rolyon/rolyon-rbac-role-assignments-refactor

[Azure RBAC] Role assignments refactor

Author: ktoliver

articles/role-based-access-control/TOC.yml

@@ -28,15 +28,31 @@
     href: tutorial-custom-role-cli.md
 - name: Concepts
   items:
-  - name: Understand role definitions
-    href: role-definitions.md
   - name: PIM for Azure resources
     href: pim-azure-resource.md
   - name: Conditional Access for Azure management
     href: conditional-access-azure-management.md
 - name: How-to guides
   items:
-  - name: Manage access
+  - name: List role definitions
+    items:
+    - name: Overview
+      href: role-definitions.md
+    - name: List role definitions
+      href: role-definitions-list.md
+    - name: Built-in roles
+      href: built-in-roles.md
+  - name: List role assignments
+    items:
+    - name: Portal
+      href: role-assignments-list-portal.md
+    - name: PowerShell
+      href: role-assignments-list-powershell.md
+    - name: CLI
+      href: role-assignments-list-cli.md
+    - name: REST API
+      href: role-assignments-list-rest.md
+  - name: Add or remove role assignments
     items:
     - name: Portal
       href: role-assignments-portal.md
@@ -50,17 +66,17 @@
       href: role-assignments-rest.md
     - name: Template
       href: role-assignments-template.md
-  - name: Deny access
+  - name: List deny assignments
     items:
-    - name: Deny assignments
+    - name: Overview
       href: deny-assignments.md
     - name: Portal
       href: deny-assignments-portal.md
     - name: PowerShell
       href: deny-assignments-powershell.md
     - name: REST API
       href: deny-assignments-rest.md
-  - name: Custom roles
+  - name: Create custom roles
     items:
     - name: Overview
       href: custom-roles.md
@@ -72,16 +88,14 @@
       href: custom-roles-rest.md
   - name: View activity logs
     href: change-history-report.md
-  - name: Elevate access to manage all subscriptions
+  - name: Elevate access
     href: elevate-access-global-admin.md
   - name: Classic administrators
     href: classic-administrators.md
   - name: Troubleshoot
     href: troubleshooting.md
 - name: Reference
   items:
-  - name: Built-in roles
-    href: built-in-roles.md
   - name: Resource provider operations
     href: resource-provider-operations.md
   - name: RBAC limits

articles/role-based-access-control/custom-roles-cli.md

@@ -1,6 +1,6 @@
 ---
-title: Create custom roles for Azure resources using Azure CLI | Microsoft Docs
-description: Learn how to create custom roles with role-based access control (RBAC) for Azure resources using Azure CLI. This includes how to list, create, update, and delete custom roles.
+title: Create or update custom roles for Azure resources using Azure CLI | Microsoft Docs
+description: Learn how to list, create, update, or delete custom roles with role-based access control (RBAC) for Azure resources using Azure CLI.
 services: active-directory
 documentationcenter: ''
 author: rolyon
@@ -16,9 +16,9 @@ ms.date: 02/20/2019
 ms.author: rolyon
 ms.reviewer: bagovind
 ---
-# Create custom roles for Azure resources using Azure CLI
+# Create or update custom roles for Azure resources using Azure CLI
 
-If the [built-in roles for Azure resources](built-in-roles.md) don't meet the specific needs of your organization, you can create your own custom roles. This article describes how to create and manage custom roles using Azure CLI.
+If the [built-in roles for Azure resources](built-in-roles.md) don't meet the specific needs of your organization, you can create your own custom roles. This article describes how to list, create, update, or delete custom roles using Azure CLI.
 
 For a step-by-step tutorial on how to create a custom role, see [Tutorial: Create a custom role for Azure resources using Azure CLI](tutorial-custom-role-cli.md).
 

articles/role-based-access-control/custom-roles-powershell.md

@@ -1,6 +1,6 @@
 ---
-title: Create custom roles for Azure resources using Azure PowerShell | Microsoft Docs
-description: Learn how to create custom roles with role-based access control (RBAC) for Azure resources using Azure PowerShell. This includes how to list, create, update, and delete custom roles.
+title: Create or update custom roles for Azure resources using Azure PowerShell | Microsoft Docs
+description: Learn how to list, create, update, or delete custom roles with role-based access control (RBAC) for Azure resources using Azure PowerShell.
 services: active-directory
 documentationcenter: ''
 author: rolyon
@@ -16,9 +16,9 @@ ms.date: 02/20/2019
 ms.author: rolyon
 ms.reviewer: bagovind
 ---
-# Create custom roles for Azure resources using Azure PowerShell
+# Create or update custom roles for Azure resources using Azure PowerShell
 
-If the [built-in roles for Azure resources](built-in-roles.md) don't meet the specific needs of your organization, you can create your own custom roles. This article describes how to create and manage custom roles using Azure PowerShell.
+If the [built-in roles for Azure resources](built-in-roles.md) don't meet the specific needs of your organization, you can create your own custom roles. This article describes how to list, create, update, or delete custom roles using Azure PowerShell.
 
 For a step-by-step tutorial on how to create a custom role, see [Tutorial: Create a custom role for Azure resources using Azure PowerShell](tutorial-custom-role-powershell.md).
 

articles/role-based-access-control/custom-roles-rest.md

@@ -1,6 +1,6 @@
 ---
-title: Create custom roles for Azure resources using the REST API - Azure | Microsoft Docs
-description: Learn how to create custom roles with role-based access control (RBAC) for Azure resources using the REST API. This includes how to list, create, update, and delete custom roles.
+title: Create custom or update roles for Azure resources using the REST API - Azure | Microsoft Docs
+description: Learn how to list, create, update, or delete custom roles with role-based access control (RBAC) for Azure resources using the REST API.
 services: active-directory
 documentationcenter: na
 author: rolyon
@@ -18,9 +18,9 @@ ms.author: rolyon
 ms.reviewer: bagovind
 
 ---
-# Create custom roles for Azure resources using the REST API
+# Create or update custom roles for Azure resources using the REST API
 
-If the [built-in roles for Azure resources](built-in-roles.md) don't meet the specific needs of your organization, you can create your own custom roles. This article describes how to create and manage custom roles using the REST API.
+If the [built-in roles for Azure resources](built-in-roles.md) don't meet the specific needs of your organization, you can create your own custom roles. This article describes how to list, create, update, or delete custom roles using the REST API.
 
 ## List custom roles