Type de ressource accessPackage
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 .
Dans Gestion des droits d’utilisation Microsoft Entra, un package d’accès définit les collections de rôles de ressources et les stratégies permettant d’accéder à ces ressources par un ou plusieurs utilisateurs.
Chaque package d’accès est référencé par un catalogue de packages d’accès unique et possède des liens vers les ressources de ce catalogue via les étendues de rôle spécifiques à la ressource qui définissent l’accès fourni par le package. Un package d’accès est également lié aux stratégies d’attribution de package d’accès, chacune définissant qui peut demander ou se voir attribuer une attribution de package d’accès.
Pour affecter un utilisateur à un package d’accès, créez un accessPackageAssignmentRequest qui fait référence au package d’accès et à la stratégie d’attribution du package d’accès.
Méthodes
| Méthode | Type renvoyé | Description |
|---|---|---|
| List | collection accessPackage | Récupérer une liste d’objets accesspackage . |
| Create | accessPackage | Créez un objet accesspackage . |
| Obtenir | accessPackage | Lit les propriétés et les relations d’un objet accesspackage . |
| Mettre à jour | Aucun | Mettez à jour les propriétés d’un objet accesspackage . |
| Supprimer | Aucune | Supprimer un accesspackage. |
| Filtrer par utilisateur actuel | collection accessPackage | Récupérez la liste des objets accessPackage filtrés sur l’utilisateur connecté. |
| Obtenir les exigences de stratégie applicables | collection accessPackageAssignmentRequestRequirements | Récupérez une liste d’objets accessPackageAssignmentRequestRequirement avec les exigences de requête. |
| Déplacer vers le catalogue | Aucune | Déplacer un package d’accès vers un autre catalogue. |
| Packages d’accès incompatibles | ||
| List | collection accessPackage | Récupérez la liste des objets accesspackage incompatibles pour ce package d’accès. |
| Ajouter | Aucune | Ajoutez un lien pour indiquer qu’un autre accesspackage est incompatible avec un package d’accès spécifié. |
| Supprimer de | Aucune | Supprimez un lien qui indiquait qu’un accesspackage était incompatible. |
| Liste incompatible avec | collection accessPackage | Récupérez une liste des objets accesspackage qui répertorient ce package d’accès comme incompatible. |
| Groupes incompatibles | ||
| List | collection group | Récupérez la liste des objets de groupe incompatibles pour ce package d’accès. |
| Ajouter un groupe à | Aucune | Ajoutez un lien pour indiquer que l’appartenance à un groupe est incompatible avec un package d’accès spécifié. |
| Supprimer le groupe de | Aucune | Supprimez un lien qui indiquait qu’une appartenance à un groupe était incompatible. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| catalogId | Chaîne | Identificateur du catalogue de packages d’accès référençant ce package d’accès. En lecture seule. |
| createdBy | String | UserPrincipalName de l’utilisateur ou de l’identité du sujet qui a créé cette ressource. En lecture seule. |
| createdDateTime | DateTimeOffset | Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. En lecture seule. |
| description | Chaîne | Description du package d’accès. |
| displayName | Chaîne | Nom complet du package d’accès. Prend en charge $filter (eq, contains). |
| id | Chaîne | En lecture seule. |
| isHidden | Booléen | Indique si le package d’accès est masqué au demandeur. |
| isRoleScopesVisible | Valeur booléenne | Indique si les étendues de rôle sont visibles. |
| modifiedBy | Chaîne | UserPrincipalName de l’utilisateur qui a modifié cette ressource pour la dernière fois. En lecture seule. |
| modifiedDateTime | DateTimeOffset | Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. En lecture seule. |
Relations
| Relation | Type | Description |
|---|---|---|
| accessPackageAssignmentPolicies | collection accessPackageAssignmentPolicy | En lecture seule. Pouvant accepter la valeur Null. Prend en charge $expand. |
| accessPackageCatalog | accessPackageCatalog | En lecture seule. Pouvant accepter la valeur Null. |
| accessPackageResourceRoleScopes | collection accessPackageResourceRoleScope | Pouvant accepter la valeur Null. |
| incompatibleAccessPackages | collection accessPackage | Packages d’accès dont les utilisateurs attribués ne sont pas éligibles à ce package d’accès. |
| accessPackagesIncompatibleWith | collection accessPackage | Packages d’accès incompatibles avec ce package. En lecture seule. |
| incompatibleGroups | collection group | Groupes dont les membres ne peuvent pas être affectés à ce package d’accès. |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"id":"360fa7de-90be-48dc-a2ce-fc40094a93dd",
"description":"Sample access package",
"displayName":"Access package for testing",
"isHidden":false,
"catalogId":"662d99e7-6ceb-4c21-9cb4-9b0bbfdefccc",
"isRoleScopesVisible":false,
"createdDateTime":"2019-01-27T18:19:50.74Z",
"modifiedDateTime":"2019-01-27T18:19:50.74Z",
"createdBy":"TestGA@example.com",
"modifiedBy":"TestGA@example.com"
}