userProtectionScopeContainer: computação

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Calcule as políticas e ações de proteção de dados aplicáveis a um usuário específico com base em seu contexto.

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet
✅ ✅ ✅ ❌

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) ProtectionScopes.Compute.User ProtectionScopes.Compute.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application ProtectionScopes.Compute.User ProtectionScopes.Compute.All

Solicitação HTTP

POST /me/dataSecurityAndGovernance/protectionScopes/compute

Observação

Chamar o ponto de extremidade /me exige um usuário conectado e, portanto, uma permissão delegada. Não há suporte para permissões de aplicativo ao usar o /me ponto de extremidade.

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

Observação

Se você tiver apenas o userPrincipalName do usuário, use a URL a seguir para recuperar sua ID de objeto.

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

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.
If-None-Match Opcional. Esse valor é usado pela API para determinar se o estado da política foi alterado desde a última chamada à API.
client-request-id Cadeia de caracteres (GUID recomendado). Opcional. Identificador exclusivo para esta solicitação, que é usado para rastreamento e depuração em logs e interações de suporte. Se uma ID não for fornecida, uma poderá ser gerada automaticamente. Recomendamos que você especifique a ID para facilitar o rastreamento e a depuração. A mesma ID enviada na solicitação é retornada na resposta.

Corpo da solicitação

Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.

Parâmetro Tipo Descrição
activities microsoft.graph.security.userActivityTypes Opcional. Especifica as atividades do usuário que o aplicativo de chamada dá suporte ou nas quais está interessado. Essa enumeração sinalizada permite que vários membros sejam selecionados simultaneamente. Os valores possíveis são: none, uploadText, uploadFile, downloadText, downloadFile, unknownFutureValue. Use o Prefer: include-unknown-enum-members cabeçalho da solicitação para obter os seguintes valores dessa enumeração evolutiva: copyToClipboard, pasteFromClipboard, print, accessDebugTools, contentFiltering, . O valor representa a contentFiltering avaliação do conteúdo do aplicativo em relação às políticas de prevenção contra perda de dados.
deviceMetadata deviceMetadata Opcional. Informações sobre o dispositivo do usuário (tipo, SO) usado para avaliação de política contextual.
integratedAppMetadata integratedApplicationMetadata Opcional. Informações sobre o aplicativo de chamada (nome, versão) integrando-se ao Microsoft Purview.
locations Coleção policyLocation Opcional. Lista de locais específicos nos quais o aplicativo está interessado. Se fornecido, os resultados serão cortados de acordo com as políticas que abrangem esses locais. Use o aplicativo de local de política para locais de aplicativos, domínio de local de política para locais de domínio ou URL de local de política para locais de URL. Você deve especificar a @odata.type propriedade para declarar o tipo de policyLocation. Por exemplo, "@odata.type": "microsoft.graph.policyLocationApplication".
pivotOn microsoft.graph.policyPivotProperty Opcional. Especifica como os resultados devem ser agregados. Se omitido ou none, os resultados podem ser menos agregados. Os valores possíveis são activity,location, none.

Cabeçalhos de resposta

Nome Descrição
ETag Um indicador se o estado da política configurada pelo administrador foi alterado. Se a Etag corresponder ao valor If-None-Match e você tiver armazenado em cache os resultados da análise de resultados anteriores dessa API, não será necessário analisar a resposta e armazenar em cache os resultados analisados. Armazene em cache esse valor para chamadas para processar conteúdo.

Resposta

Se for bem-sucedida, essa ação retornará um 200 OK código de resposta e uma coleção de objetos policyUserScope no corpo da resposta. Cada objeto representa um conjunto de locais e atividades regidos por um conjunto comum de ações de política e modo de execução para o usuário especificado.

Exemplos

Solicitação

O exemplo a seguir calcula o escopo de proteção para um usuário que executa carregamentos de texto, interessado em um domínio específico, dinamizando os resultados por atividade.

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"
      }
   ]
}

Resposta

O exemplo a seguir mostra a resposta. Ela inclui a configuração efetiva Secure by Default, que indica que avaliações de política incompletas são auditadas e bloqueadas.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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": []
    }
  ]
}
  • Última atualização a