tenantProtectionScopeContainer: Compute

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Berechnen Sie mandantenweite Datenschutzrichtlinien und -aktionen, einschließlich Benutzer-, Gruppen- oder Agent-Richtlinienbereiche.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ✅ ✅ ❌

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) ProtectionScopes.Compute.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application ProtectionScopes.Compute.All Nicht verfügbar.

HTTP-Anforderung

POST /security/dataSecurityAndGovernance/protectionScopes/compute

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.
client-request-id Zeichenfolge (GUID empfohlen). Optional. Eindeutiger Bezeichner für diese Anforderung, der für die Ablaufverfolgung und das Debuggen in Protokollen und Supportinteraktionen verwendet wird. Wenn keine ID angegeben wird, kann automatisch eine generiert werden. Wir empfehlen, die ID anzugeben, um Ablaufverfolgung und Debugging zu vereinfachen. Die gleiche ID, die in der Anforderung gesendet wurde, wird in der Antwort zurückgegeben.

Anforderungstext

Geben Sie im Anforderungstext JSON-Objekt die folgenden Parameter an.

Parameter Typ Beschreibung
Aktivitäten microsoft.graph.security.userActivityTypes Optional. Gibt die Benutzeraktivitäten an, die die aufrufende Anwendung unterstützt oder an denen sie interessiert ist. Bei dieser markierten Aufzählung können mehrere Mitglieder gleichzeitig ausgewählt werden. Mögliche Werte sind: none, uploadText, uploadFile, downloadText, downloadFile, unknownFutureValue. Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Werte aus dieser evolvierbaren Aufzählung zu erhalten: copyToClipboard, pasteFromClipboard, print, accessDebugTools, contentFiltering. Der contentFiltering Wert gibt an, wie Anwendungsinhalte anhand von Richtlinien zum Schutz vor Datenverlust ausgewertet werden.
deviceMetadata deviceMetadata Optional. Informationen über den Gerätekontext (Typ, Betriebssystem), der für die kontextbezogene Richtlinienauswertung verwendet wird.
evaluationScope evaluationScope Optional. Gibt den Auswertungskontext für die Anforderung an. Legen Sie für Agent-zu-Tool-Szenarien (A2T) den Typ auf agent fest, um Agent-Richtlinieninformationen im Mandantenbereich abzurufen. Wenn diese Angabe weggelassen wird, wird die Anforderung mit dem standardmäßigen Mandantenkontext ausgewertet.
integratedAppMetadata integratedApplicationMetadata Optional. Informationen zur aufrufenden Anwendung (Name, Version), die in Microsoft Purview integriert ist.
locations policyLocation-Sammlung Optional. Liste der spezifischen Speicherorte, an denen die Anwendung interessiert ist. Falls angegeben, werden die Ergebnisse auf Richtlinien gekürzt, die diese Standorte abdecken. Verwenden Sie policyLocationAgent für Agent-Standorte, die Richtlinienstandortanwendung für Anwendungsstandorte, die Richtlinienstandortdomäne für Domänenstandorte oder die Richtlinienstandort-URL für URL-Standorte. Sie müssen die @odata.type Eigenschaft angeben, um den Typ von policyLocation zu deklarieren.
pivotOn microsoft.graph.security.policyPivotProperty Optional. Gibt an, wie die Ergebnisse aggregiert werden sollen. Wenn diese Angabe weggelassen wird oder none, sind die Ergebnisse möglicherweise weniger aggregiert. Mögliche Werte sind: activity, location und none.

Antwort

Bei erfolgreicher Aktion werden ein 200 OK Antwortcode und eine Auflistung von policyTenantScope-Objekten im Antworttext zurückgegeben. Jedes Objekt stellt eine Reihe von Speicherorten und Aktivitäten dar, die von einem gemeinsamen Satz von Richtlinienaktionen und einem Ausführungsmodus sowie von den Benutzer-/Gruppenbindungen für die jeweilige Richtlinienkonfiguration bestimmt werden.

Beispiele

Beispiel 1: Anwendungsschutzbereich

Anforderung

Im folgenden Beispiel wird der mandantenweite Schutzbereich für Textuploads berechnet, die an einer bestimmten Domäne interessiert sind, wobei die Ergebnisse nach Standort pivotiert werden.

POST https://graph.microsoft.com/beta/security/dataSecurityAndGovernance/protectionScopes/compute
Content-type: application/json

{
    "activities": "uploadText,downloadText",
    "locations": [
        {
            "@odata.type": "microsoft.graph.policyLocationApplication",
            "value": "be121c8f-ecd8-4026-b699-669e0ce1bcbf"
        }
    ]
}

Antwort

Das folgende Beispiel zeigt die Antwort. Sie enthält die effektive Konfiguration "standardmäßig sicher", die angibt, dass unvollständige Richtlinienauswertungen überwacht und blockiert werden.

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

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.policyTenantScope)",
    "value": [
        {
            "activities": "uploadText,downloadText",
            "executionMode": "evaluateOffline",
            "policyScope": {
                "inclusions": [
                    {
                        "identity": "All"
                    }
                ],
                "exclusions": [
                ]
            },
            "locations": [
                {
                    "value": "be121c8f-ecd8-4026-b699-669e0ce1bcbf"
                }
            ],
            "policyActions": [
            ],
            "policyConfiguration": {
                "errorSettings": {
                    "errorAction": "audit,block",
                    "isEnabled": true
                },
                "lastModifiedDateTime": "2026-09-22T12:00:00Z"
            }
        }
    ]
}

Beispiel 2: Umfang des Agent-Schutzes

Anforderung

Im folgenden Beispiel werden mandantenbezogene Agent-Richtlinien angefordert, die nach einem bestimmten Agent-Standort gefiltert werden.

POST https://graph.microsoft.com/beta/security/dataSecurityAndGovernance/protectionScopes/compute
Authorization: Bearer {token}
Content-Type: application/json
If-None-Match: "09834098340983409834"

{
  "activities": "uploadText,uploadFile,downloadText,downloadFile",
  "locations": [
    {
      "@odata.type": "microsoft.graph.policyLocationAgent",
      "value": "33333333-3333-3333-3333-333333333333",
      "agentMetadata": {
        "agentAdministrativeUnitId": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
        "agentBlueprintId": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
        "agentCategory": "Agents.Copilot.Studio",
        "agentOwner": "owner@contoso.com",
        "agentPublisher": "Contoso",
        "altAgentIds": [
          "mcs-agent-33333333"
        ],
        "isEntraAgentId": true
      }
    }
  ],
  "pivotOn": "activity",
  "integratedAppMetadata": {
    "name": "Agent365.MCS",
    "version": "2026.8.5.1"
  },
  "evaluationScope": {
    "type": "agent"
  }
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 200 OK
Content-Type: application/json
ETag: "8936456543210"

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.policyTenantScope)",
  "value": [
    {
      "@odata.type": "#microsoft.graph.policyTenantScope",
      "locations": [
        {
          "@odata.type": "#microsoft.graph.policyLocationAgent",
          "value": "33333333-3333-3333-3333-333333333333",
          "agentMetadata": {
            "agentAdministrativeUnitId": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
            "agentBlueprintId": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
            "agentCategory": "Agents.Copilot.Studio",
            "agentOwner": "owner@contoso.com",
            "agentPublisher": "Contoso",
            "altAgentIds": [
              "mcs-agent-33333333"
            ],
            "isEntraAgentId": true
          }
        }
      ],
      "locationExclusions": [],
      "activities": "uploadText,downloadText",
      "executionMode": "evaluateInline",
      "policyActions": [],
      "policyConfiguration": {
        "errorSettings": {
          "errorAction": "audit,block",
          "isEnabled": true
        },
        "lastModifiedDateTime": "2026-09-22T12:00:00Z"
      },
      "policyScope": {
        "inclusions": [
          {
            "@odata.type": "#microsoft.graph.tenantScope",
            "identity": "00000000-0000-0000-0000-000000000001"
          }
        ],
        "exclusions": []
      }
    }
  ]
}
  • Zuletzt aktualisiert um