sensitivityLabel: computeInheritance

Namespace: microsoft.graph

Calcule a etiqueta de confidencialidade que deve ser herdada por um artefacto de saída, dado um conjunto de etiquetas de confidencialidade de artefactos de entrada ou referenciados.

Esta API está disponível nas seguintes implementações de cloud nacionais.

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

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
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

Filtrar parâmetros

Parâmetro Tipo Descrição
applicableTo String Opcional. Uma cadeia separada por vírgulas de formatos de conteúdo (por exemplo, file, email). Filtra as etiquetas devolvidas apenas para as 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 região para campos localizáveis.
labelIds Coleção de Cadeias Opcional. Uma coleção de GUIDs de etiquetas de confidencialidade separados por vírgulas. Filtra as etiquetas devolvidas apenas para as que correspondem aos IDs especificados.

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 o pedido. Recomendado para resoluçã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, este método devolve um 200 OK código de resposta e um único objeto sensitivityLabel no corpo da resposta, representando a etiqueta herdada calculada.

Se não for encontrada nenhuma etiqueta aplicável com base na entrada e nos filtros ou se ocorrer um erro (por exemplo, ID de etiqueta inválido fornecido), a API poderá devolver uma resposta de erro (por exemplo, 400 Bad Request ou 404 Not Found) com detalhes num objeto de erro.

Exemplos

Solicitação

O exemplo seguinte mostra um pedido para calcular a etiqueta herdada da etiqueta de entrada, considerando apenas as etiquetas 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. A etiqueta confidencial é devolvida porque é a etiqueta mais confidencial entre as entradas que suportam o 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