Répertorier les ressources

Espace de noms: microsoft.graph

Récupérer une liste d’objets accessPackageResource dans un accessPackageCatalog.

Cette API est disponible dans les déploiements cloud nationaux suivants.

Service global Gouvernement américain L4 Gouvernement américain L5 (DOD) Chine exploitée par 21Vianet
✅ ✅ ✅ ✅

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme étant les moins privilégiées pour cette API. Utilisez une ou plusieurs autorisations privilégiées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, voir Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez la référence des autorisations.

Type d’autorisation Autorisations les moins privilégiées Autorisations à privilèges plus élevés
Déléguée (compte professionnel ou scolaire) EntitlementManagement.Read.All EntitlementManagement.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application EntitlementManagement.Read.All EntitlementManagement.ReadWrite.All

Conseil

Pour l’accès délégué à l’aide de comptes professionnels ou scolaires, l’utilisateur connecté doit disposer d’un rôle d’administrateur avec des autorisations de rôle prises en charge via l’une des options suivantes :

  • Un rôle dans le système de gestion des droits d’utilisation où les rôles les moins privilégiés sont :
    • Lecteur de catalogue. Il s’agit de l’option la moins privilégiée
    • Créateur de catalogue
    • Gestionnaire de package d’accès
  • Rôles Microsoft Entra plus privilégiés pris en charge pour cette opération :
    • Lecteur de sécurité
    • Lecteur général
    • Administrateur de conformité
    • Administrateur de sécurité
    • Administrateur de gouvernance des identités

Dans les scénarios d’application uniquement, l’application appelante peut se voir attribuer l’un des rôles pris en charge précédents au lieu de l’autorisation d’application EntitlementManagement.Read.All . Le rôle de lecteur de catalogue est moins privilégié que l’autorisation de l’application EntitlementManagement.Read.All .

Pour plus d’informations, voir Délégation et rôles dans la gestion des droits d’utilisation et comment déléguer la gouvernance des accès aux gestionnaires de packages d’accès dans la gestion des droits d’utilisation.

Remarque

Les ressources SharePoint Online ne sont renvoyées que lorsque cette API est appelée avec des autorisations déléguées. Ce scénario n’est pas pris en charge avec les autorisations d’application. Pour récupérer des informations de site SharePoint à l’aide des autorisations d’application, utilisez l’API getAllSites de sites , qui renvoie des informations de site équivalentes.

Requête HTTP

GET /identityGovernance/entitlementManagement/catalogs/{id}/resources

Paramètres facultatifs de la requête

Cette méthode prend en charge les paramètres de requête OData pour vous aider à personnaliser la réponse. Par exemple, pour récupérer les étendues et environnements de ressources du package d’accès pour chaque ressource, incluez $expand=scopes,environment dans la requête. Pour récupérer les rôles disponibles d’une ressource et sa portée, incluez $expand=roles,scopes. Pour des informations générales, consultez paramètres de la requête OData.

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et les autorisations.

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

En cas de réussite, cette méthode renvoie un 200 OK code de réponse et une collection d’objets accessPackageResource dans le corps de la réponse.

Exemples

Exemple 1 : répertorier toutes les ressources d’un catalogue

Demande

Voici un exemple de requête, utilisé $expand pour retourner les étendues de ressources de chaque ressource.

GET https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/catalogs/{id}/resources?$expand=scopes

Réponse

L’exemple suivant illustre la réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": [
    {
      "id": "400279ff-8e85-4dcf-b1d6-d3a6be372951",
      "displayName": "Faculty cafeteria ordering",
      "description": "Example application",
      "originId": "2f1099a6-d4fc-4cc9-a0ef-ddd3f1bf0b7e",
      "scopes": [
          {
              "id": "452d78a7-69a5-482d-a82f-859a5169c55e",
              "displayName": "Root",
              "description": "Root Scope",
              "originId": "2f1099a6-d4fc-4cc9-a0ef-ddd3f1bf0b7e",
              "originSystem": "AadApplication",
              "isRootScope": true
          }
      ]
    }
  ]
}

Exemple 2 : Récupérer les rôles et les étendues d’une seule ressource dans un catalogue

Demande

Voici un exemple de demande, utilisant $expand pour retourner les rôles et les étendues d’une seule ressource. La ressource doit déjà être présente dans le catalogue.

GET https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/catalogs/{catalogId}/resources?$expand=roles,scopes&$filter=id eq '{resourceId}'

Réponse

L’exemple suivant illustre la réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": [
    {
      "id": "400279ff-8e85-4dcf-b1d6-d3a6be372951",
      "displayName": "Faculty cafeteria ordering",
      "description": "Example application",
      "originId": "2f1099a6-d4fc-4cc9-a0ef-ddd3f1bf0b7e",
      "roles": [
          {
              "id": "5fc34d75-926c-458e-9967-060691c7f4ae",
              "displayName": "admin",
              "description": "Administrator in the application",
              "originSystem": "AadApplication",
              "originId": "2cab8bf6-3fa2-4cc5-b0a7-a401af9f6197"
           }
      ],
      "scopes": [
          {
              "id": "452d78a7-69a5-482d-a82f-859a5169c55e",
              "displayName": "Root",
              "description": "Root Scope",
              "originId": "2f1099a6-d4fc-4cc9-a0ef-ddd3f1bf0b7e",
              "originSystem": "AadApplication",
              "isRootScope": true
          }
      ]
    }
  ]
}

Exemple 3 : Récupérer les rôles et les étendues d’une seule ressource dans un catalogue par ID d’origine

Demande

Voici un exemple de demande, utilisant $expand pour retourner les rôles et les étendues d’une seule ressource. Le filtre utilise la originId propriété de accessPackageResource pour faire référence à l’identificateur dans le système d’origine. Si la ressource du catalogue est basée sur un groupe, cette valeur serait celle id de ce groupe.

GET https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/catalogs/{catalogId}/resources?$expand=roles,scopes&$filter=originId eq '0282e19d-bf41-435d-92a4-99bab93af305'

Réponse

L’exemple suivant illustre la réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": [
    {
      "id": "b16e0e71-17b4-4ebd-a3cd-8a468542e418",
      "displayName": "example group",
      "description": "a group whose members are to be assigned via an access package",
      "originId": "0282e19d-bf41-435d-92a4-99bab93af305",
      "originSystem": "AadGroup",
      "createdDateTime": "2019-09-13T01:06:14.797Z",
      "roles": [
        {
          "id": "748f8431-c7c6-404d-8564-df67aa8cfc5e",
          "displayName": "Member",
          "originSystem": "AadGroup",
          "originId": "Member_0282e19d-bf41-435d-92a4-99bab93af305"
        }
      ],
      "scopes": [
        {
          "id": "83b3e3e9-c8b3-481b-ad80-53e29d1eda9c",
          "displayName": "Root",
          "description": "Root Scope",
          "originId": "0282e19d-bf41-435d-92a4-99bab93af305",
          "originSystem": "AadGroup",
          "isRootScope": true
        }
      ]
    }
  ]
}
  • Last updated on