userProtectionScopeContainer : compute

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 .

Calculer les stratégies et actions de protection des données applicables à un utilisateur spécifique en fonction de son contexte.

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) ProtectionScopes.Compute.User ProtectionScopes.Compute.All
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application ProtectionScopes.Compute.User ProtectionScopes.Compute.All

Requête HTTP

POST /me/dataSecurityAndGovernance/protectionScopes/compute

Remarque

L’appel du point de terminaison /me nécessite un utilisateur connecté et par conséquent une autorisation déléguée. Les autorisations d’application ne sont pas prises en charge lors de l’utilisation du point de /me terminaison.

POST /users/{usersId}/dataSecurityAndGovernance/protectionScopes/compute

Remarque

Si vous n’avez que le nom principal de l’utilisateur, utilisez l’URL suivante pour récupérer son ID d’objet.

GET https://graph.microsoft.com/v1.0/users/{userPrincipalName}?$select=id

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et les autorisations.
Content-Type application/json. Obligatoire.
If-None-Match Facultatif. Cette valeur est utilisée par l’API pour déterminer si l’état de la stratégie a changé depuis le dernier appel à l’API.
client-request-id Chaîne (GUID recommandé). Facultatif. Identificateur unique de cette requête, qui est utilisé pour le suivi et le débogage dans les journaux et les interactions de support. Si aucun ID n’est fourni, il se peut qu’il soit généré automatiquement. Nous vous recommandons de spécifier l’ID pour faciliter le suivi et le débogage. Le même ID que celui envoyé dans la demande est renvoyé dans la réponse.

Corps de la demande

Dans le corps de la demande, indiquez un objet JSON avec les paramètres suivants.

Paramètre Type Description
activités microsoft.graph.security.userActivityTypes Facultatif. Spécifie les activités de l’utilisateur que l’application appelante prend en charge ou qui l’intéressent. Cette énumération avec indicateur permet de sélectionner plusieurs membres simultanément. Les valeurs possibles sont none, uploadText, uploadFile, downloadText, downloadFile, unknownFutureValue. Utilisez l’en-tête de Prefer: include-unknown-enum-members requête pour obtenir les valeurs suivantes à partir de cette énumération évolutive : copyToClipboard, pasteFromClipboard, , printaccessDebugTools, contentFiltering, . La contentFiltering valeur représente l’évaluation du contenu de l’application par rapport aux stratégies de protection contre la perte de données.
deviceMetadata deviceMetadata Facultatif. Informations sur l’appareil de l’utilisateur (type, système d’exploitation) utilisées pour l’évaluation de la stratégie contextuelle.
integratedAppMetadata integratedApplicationMetadata Facultatif. Informations sur l’intégration de l’application appelante (nom, version) à Microsoft Purview.
emplacements collection policyLocation Facultatif. Liste des emplacements spécifiques qui intéressent l’application. Le cas échéant, les résultats sont tronqués en fonction des politiques applicables à ces emplacements. Utilisez l’application Emplacement de stratégie pour les emplacements d’application, le domaine Emplacement de stratégie pour les emplacements de domaine ou l’URL d’emplacement de stratégie pour les emplacements d’URL. Vous devez spécifier la @odata.type propriété pour déclarer le type de policyLocation. Par exemple : "@odata.type": "microsoft.graph.policyLocationApplication".
pivotOn Microsoft.Graph.PolicyPivotProperty Facultatif. Spécifie la façon dont les résultats doivent être agrégés. Si cette option est omise, les nonerésultats peuvent être moins agrégés. Les valeurs possibles sont activity,location, none.

En-têtes de réponse

Nom Description
ETag Indicateur si l’état de la stratégie configurée par l’administrateur a changé. Si l’Etag correspond à la valeur If-None-Match et que vous avez mis en cache les résultats de l’analyse des résultats précédents à partir de cette API, il n’est pas nécessaire d’analyser la réponse et de mettre en cache les résultats analysés. Mettez en cache cette valeur pour les appels afin de traiter le contenu.

Réponse

En cas de succès, cette action retourne un 200 OK code de réponse et une collection d’objets policyUserScope dans le corps de la réponse. Chaque objet représente un ensemble d’emplacements et d’activités régis par un ensemble commun d’actions de stratégie et de mode d’exécution pour l’utilisateur spécifié.

Exemples

Demande

L’exemple suivant calcule l’étendue de protection pour un utilisateur effectuant des chargements de texte, intéressé par un domaine spécifique, en faisant pivoter les résultats par activité.

POST https://graph.microsoft.com/beta/users/7c1f8f10-cba8-4a8d-9449-db4b876d1ef70/dataSecurityAndGovernance/protectionScopes/compute
Content-type: application/json
Client-Request-Id: 50dc805c-3af4-42d9-ad16-a746235cc736

{
   "activities": "uploadText,downloadText",
   "locations": [
      {
         "@odata.type": "microsoft.graph.policyLocationApplication",
         "value": "83ef208a-0396-4893-9d4f-d36efbffc8bd"
      }
   ]
}

Réponse

L’exemple suivant illustre la réponse. Il inclut la configuration Secure by Default effective, qui indique que les évaluations de stratégie incomplètes sont auditées et bloquées.

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
Client-Request-Id: 50dc805c-3af4-42d9-ad16-a746235cc736

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.policyUserScope)",
  "value": [
    {
      "activities": "uploadText,downloadText",
      "executionMode": "evaluateOffline",
      "locations": [
        {
          "value": "83ef208a-0396-4893-9d4f-d36efbffc8bd"
        }
      ],
      "policyActions": [],
      "policyConfiguration": {
        "errorSettings": {
          "errorAction": "audit,block",
          "isEnabled": true
        },
        "lastModifiedDateTime": "2026-09-22T12:00:00Z"
      }
    },
    {
      "activities": "uploadText",
      "executionMode": "evaluateInline",
      "locations": [
        {
          "value": "83ef208a-0396-4893-9d4f-d36efbffc8bd"
        }
      ],
      "policyActions": []
    }
  ]
}
  • Dernière mise à jour :