unifiedRoleAssignmentMultiple, type de ressource

  • Article

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Un unifiedRoleAssignmentMultiple est utilisé pour accorder l’accès aux ressources, dans le cadre du contrôle d’accès en fonction du rôle (RBAC) Microsoft 365. Il représente une définition de rôle affectée à un tableau de principaux (généralement des utilisateurs) sur un tableau d’étendues.

Vous pouvez créer une attribution de rôle avec plusieurs principaux et plusieurs étendues.

Vous devez fournir directoryScopeIds ou appScopeIds.

Les fournisseurs RBAC suivants sont actuellement pris en charge :

  • PC cloud
  • Microsoft Intune

Méthodes

Méthode Type renvoyé Description
List collection unifiedRoleAssignmentMultiple Lisez la liste des objets unifiedRoleAssignmentMultiple et leurs propriétés.
Create unifiedRoleAssignmentMultiple Créez un unifiedRoleAssignmentMultiple en publiant dans la collection roleAssignment .
Obtenir unifiedRoleAssignmentMultiple Lit les propriétés et les relations de l’objet unifiedRoleAssignmentMultiple .
Mettre à jour unifiedRoleAssignmentMultiple Mettez à jour un objet unifiedRoleAssignmentMultiple existant.
Supprimer Aucun Supprimez l’objet unifiedRoleAssignmentMultiple .

Propriétés

Propriété Type Description
appScopeIds String collection ID des étendues spécifiques à l’application lorsque les étendues d’affectation sont spécifiques à l’application. Les étendues d’une affectation déterminent l’ensemble des ressources auxquelles le principal a accès. Les étendues de répertoire sont des étendues partagées stockées dans le répertoire et comprises par plusieurs applications. Utilisez / pour l’étendue à l’échelle du locataire. Les étendues d’application sont des étendues définies et comprises par cette application uniquement.
description Chaîne Description de l’attribution de rôle.
directoryScopeIds String collection ID des objets d’annuaire qui représentent les étendues de l’affectation. Les étendues d’une affectation déterminent l’ensemble des ressources pour lesquelles l’accès a été accordé aux principaux. Les étendues de répertoire sont des étendues partagées stockées dans le répertoire et comprises par plusieurs applications. Les étendues d’application sont des étendues définies et comprises par cette application uniquement.
displayName Chaîne Nom de l’attribution de rôle. Obligatoire.
id Chaîne Identificateur unique de l’objet unifiedRoleAssignmentMultiple . Clé non nullable, en lecture seule.
principalIds Collection de chaînes Identificateurs des principaux auxquels l’attribution est accordée. Prend en charge $filter (any opérateur uniquement).
roleDefinitionId Chaîne Identificateur du unifiedRoleDefinition pour lequel l’affectation est destinée.

Relations

Relation Type Description
appScopes collection appScope Collection en lecture seule avec les détails des étendues spécifiques à l’application lorsque les étendues d’affectation sont spécifiques à l’application. Entité d’endiguement. En lecture seule.
directoryScopes collection directoryObject Collection en lecture seule qui fait référence aux objets d’annuaire qui sont l’étendue de l’affectation. Fourni pour que les appelants puissent obtenir les objets d’annuaire en utilisant $expand en même temps que l’attribution de rôle. En lecture seule. Prend en charge $expand.
Directeurs collection directoryObject Collection en lecture seule qui fait référence aux principaux attribués. Fourni pour que les appelants puissent obtenir les principaux en utilisant $expand en même temps que l’attribution de rôle. En lecture seule. Prend en charge $expand.
roleDefinition unifiedRoleDefinition Spécifie la valeur roleDefinition pour laquelle l’affectation est destinée. Fourni pour que les appelants puissent obtenir la définition de rôle en utilisant $expand en même temps que l’attribution de rôle. Prend en charge $filter (eq opérateur sur id, isBuiltIn et displayName, et startsWith opérateur sur displayName) et $expand.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "appScopeIds": ["string"],
  "appScopes": [{"@odata.type": "microsoft.graph.appScope"}],
  "description": "String",
  "directoryScopeIds": ["String"],
  "directoryScopes": [{"@odata.type": "microsoft.graph.directoryObject"}],
  "displayName": "String",
  "id": "String (identifier)",
  "principalIds": ["String"],
  "principals": [{"@odata.type": "microsoft.graph.directoryObject"}],
  "roleDefinition": {"@odata.type": "microsoft.graph.unifiedRoleDefinition"},
  "roleDefinitionId": "String"
}