sensitivityLabel: computeInheritance

Namespace: microsoft.graph

Calcule o rótulo de confidencialidade que deve ser herdado por um artefato de saída, dado um conjunto de rótulos de confidencialidade de artefatos de entrada ou referenciados.

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) SensitivityLabel.Evaluate SensitivityLabel.Evaluate.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application SensitivityLabel.Evaluate SensitivityLabel.Evaluate.All

Solicitação HTTP

GET /security/dataSecurityAndGovernance/sensitivityLabels/computeInheritance

Parâmetros de filtro

Parâmetro Tipo Descrição
applicableTo String Opcional. Uma cadeia de caracteres separada por vírgula de formatos de conteúdo (por exemplo, file, email). Filtra os rótulos retornados para apenas aqueles aplicáveis a pelo menos um dos formatos especificados. Os valores possíveis são email, file, schematizedData, site, teamwork, unifiedGroup.
localidade Cadeia de caracteres Opcional. Especifica a localidade dos campos localizáveis.
labelIds Coleção de cadeias de caracteres Opcional. Uma coleção de cadeias de caracteres separadas por vírgula de GUIDs de rótulos de confidencialidade. Filtra os rótulos retornados para apenas aqueles que correspondem às IDs especificadas.

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.
client-request-id Opcional. Um GUID gerado pelo cliente para rastrear a solicitação. Recomendado para solução de problemas.

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se for bem-sucedido, esse método retornará um código de 200 OK resposta e um único objeto sensitivityLabel no corpo da resposta, representando o rótulo herdado calculado.

Se nenhum rótulo aplicável for encontrado com base na entrada e nos filtros, ou se ocorrer um erro (por exemplo, ID de rótulo inválida fornecida), a API poderá retornar uma resposta de erro (por exemplo, 400 Bad Request ou 404 Not Found) com detalhes em um objeto de erro.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação para calcular o rótulo herdado do rótulo de entrada, considerando apenas os rótulos aplicáveis ao formato de File conteúdo.

GET https://graph.microsoft.com/v1.0/security/dataSecurityAndGovernance/sensitivityLabels/computeInheritance(labelIds=["4e4234dd-377b-42a3-935b-0e42f138fa23"],locale='en-US',contentFormats=["File"])
Authorization: Bearer {token}
Content-Type: application/json
Client-Request-Id: c5e4d3b2-a1f0-e9d8-c7b6-a5e4d3b2a1f0

"4e4234dd-377b-42a3-935b-0e42f138fa23"  // General (Sensitivity 10, File/Email)

Resposta

O exemplo a seguir mostra a resposta. O rótulo confidencial é retornado porque é o rótulo mais confidencial entre as entradas que dá suporte ao formato de File conteúdo.

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

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.security.sensitivityLabel",
  "id": "a7a21bba-8197-491f-a5d6-0d0f955397cf",
  "name": "Confidential",
  "description": "Confidential data.",
  "color": "#ff0000",
  "priority": 0,
  "toolTip": "Data that requires protection.",
  "isEnabled": true,
  "isEndpointProtectionEnabled": true,
  "autoTooltip": "",
  "actionSource": "manual",
  "applicableTo": "email,teamwork,file",
  "sublabels": []
}
  • Last updated on