unifiedRoleDefinition aktualisieren

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Dient zum Aktualisieren der Eigenschaften eines unifiedRoleDefinition-Objekts für einen RBAC-Anbieter.

Die folgenden RBAC-Anbieter werden derzeit unterstützt:

  • Cloud-PC
  • Geräteverwaltung (Intune)
  • Verzeichnis (Azure AD)

Berechtigungen

Wählen Sie in Abhängigkeit vom RBAC-Anbieter und dem erforderlichen Berechtigungstyp (delegiert oder Anwendung) aus den folgenden Tabellen die berechtigung mit den geringsten Rechten aus, die zum Aufrufen dieser API erforderlich ist. Um mehr zu erfahren, einschließlich der Vorsicht vor der Auswahl von privilegierteren Berechtigungen, suchen Sie in der Berechtigungsreferenz nach den folgenden Berechtigungen.

Für einen Cloud-PC-Anbieter

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) RoleManagement.ReadWrite.CloudPC, CloudPC.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Anwendung RoleManagement.ReadWrite.CloudPC, CloudPC.ReadWrite.All

Für einen Geräteverwaltungsanbieter (Intune)

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) DeviceManagementRBAC.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Anwendung DeviceManagementRBAC.ReadWrite.All

Für einen Verzeichnisanbieter (Azure AD)

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) RoleManagement.ReadWrite.Directory, Directory.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Anwendung RoleManagement.ReadWrite.Directory, Directory.ReadWrite.All

HTTP-Anforderung

So aktualisieren Sie eine Rollendefinition für einen Geräteverwaltungsanbieter:

PATCH /roleManagement/deviceManagement/roleDefinitions/{id}

So aktualisieren Sie eine Rollendefinition für einen Verzeichnisanbieter:

PATCH /roleManagement/directory/roleDefinitions/{id}

So aktualisieren Sie eine Rollendefinition für einen Cloud-PC-Anbieter:

PATCH /roleManagement/cloudPc/roleDefinitions/{id}

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}

Anforderungstext

Geben Sie im Anforderungstext die Werte für die relevanten Felder an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet. Geben Sie aus Gründen der Leistung vorhandene Werte, die nicht geändert wurden, nicht an.

Eigenschaft Typ Beschreibung
description Zeichenfolge Die Beschreibung für die Rollendefinition. Schreibgeschützt, wenn "isBuiltIn" auf "true" festgelegt ist.
displayName Zeichenfolge Der Anzeigename für die Rollendefinition. Schreibgeschützt, wenn "isBuiltIn" auf "true" festgelegt ist. Erforderlich.
id Zeichenfolge Der eindeutige Bezeichner für die Rollendefinition. Key, not nullable, Read-only.
isBuiltIn Boolean Flag, das angibt, ob die Rollendefinition Teil des Standardsatzes ist, der im Produkt oder benutzerdefinierten Element enthalten ist. Schreibgeschützt.
isEnabled Boolescher Wert Flag, das angibt, ob die Rolle für die Zuweisung aktiviert ist. Bei "false" ist die Rolle nicht für die Zuordnung verfügbar. Schreibgeschützt, wenn "isBuiltIn" auf "true" festgelegt ist.
resourceScopes String collection Liste der von der Rollendefinition erteilten Bereichsberechtigungen. Derzeit wird nur "/" unterstützt. Schreibgeschützt, wenn "isBuiltIn" auf "true" festgelegt ist. NICHT VERWENDEN. Diese Eigenschaft wird in Kürze veraltet sein. Fügen Sie den Bereich an die Rollenzuweisung an.
rolePermissions unifiedRolePermission-Sammlung Liste der in der Rolle enthaltenen Berechtigungen. Schreibgeschützt, wenn "isBuiltIn" auf "true" festgelegt ist. Erforderlich.
templateId Zeichenfolge Benutzerdefinierte Vorlagen-ID, die festgelegt werden kann, wenn "isBuiltIn" auf "false" festgelegt wird. Dieser Bezeichner wird in der Regel verwendet, wenn ein Bezeichner in verschiedenen Verzeichnissen identisch sein muss. Schreibgeschützt, wenn "isBuiltIn" auf "true" festgelegt ist.
inheritsPermissionsFrom unifiedRoleDefinition-Sammlung Schreibgeschützte Auflistung von Rollendefinitionen, von denen die angegebene Rollendefinition erbt. Dieses Attribut wird nur von Azure AD integrierten Rollen unterstützt.
Version String Gibt die Version der Rollendefinition an. Schreibgeschützt, wenn "isBuiltIn" auf "true" festgelegt ist.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.

Beispiel 1: Aktualisiert eine unifiedRoleDefinition für einen Verzeichnisanbieter

Anforderung

PATCH https://graph.microsoft.com/beta/roleManagement/directory/roleDefinitions/0d55728d-3e24-4309-9b1b-5ac09921475a
Content-type: application/json

{
  "description": "Update basic properties of application registrations",
  "displayName": "Application Registration Support Administrator",
  "rolePermissions":
    [
        {
            "allowedResourceActions": 
            [
                "microsoft.directory/applications/basic/read"
            ]
        }
    ]
}

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 204 No Content
Content-type: application/json

Beispiel 2: Aktualisiert eine unifiedRoleDefinition für einen CloudPC-Anbieter

Anforderung

PATCH https://graph.microsoft.com/beta/roleManagement/cloudPc/roleDefinitions/b7f5ddc1-b7dc-4d37-abce-b9d6fc15ffff
Content-type: application/json

{
  "description": "Update basic properties and permission of application registrations",
  "displayName": "ExampleCustomRole",
  "rolePermissions":
    [
        {
            "allowedResourceActions": 
            [
                "Microsoft.CloudPC/CloudPCs/Read",
                "Microsoft.CloudPC/CloudPCs/Reprovision"
            ]
        }
    ]
}

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 204 No Content
Content-type: application/json