Compartilhar via

driveItem: extractSensitivityLabels

Namespace: microsoft.graph

Extraia uma ou mais etiquetas de confidencialidade atribuídas a um item de unidade e atualize os metadados de um item de unidade com os detalhes mais recentes da etiqueta atribuída. Se ocorrer uma falha ao extrair as etiquetas de confidencialidade de um ficheiro, é gerado um erro de extração com o código de erro e a mensagem aplicáveis.

Para obter mais informações sobre etiquetas de confidencialidade da perspetiva de um administrador, consulte Ativar etiquetas de confidencialidade para ficheiros do Office no SharePoint e no OneDrive.

Observação

Esta API é aplicável apenas a extensões de ficheiro suportadas. Quando é chamada, esta API obtém primeiro os metadados da etiqueta de confidencialidade do ficheiro a partir da base de dados e, em seguida, verifica se os detalhes da etiqueta de confidencialidade são os mais recentes em termos de conteúdo de ficheiro. Se sim, os valores obtidos da base de dados são devolvidos. Se não, as etiquetas de confidencialidade são extraídas do fluxo de conteúdo do ficheiro, os metadados correspondentes são atualizados na base de dados e os valores extraídos recentemente são devolvidos.

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) Files.Read.All Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application Files.Read.All Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Observação

O SharePoint Embedded requer a FileStorageContainer.Selected permissão para aceder ao conteúdo do contentor. Esta permissão é diferente das mencionadas anteriormente. Além das permissões do Microsoft Graph, a sua aplicação tem de ter as permissões de tipo de contentor necessárias para chamar esta API. Para obter mais informações, veja Autorização e autenticação do SharePoint Embedded.

Solicitação HTTP

POST /drives/{drive-id}/items/{item-id}/extractSensitivityLabels
POST /drives/{drive-id}/root:/{item-path}:/extractSensitivityLabels
POST /groups/{group-id}/drive/items/{item-id}/extractSensitivityLabels
POST /groups/{group-id}/drive/root:/{item-path}:/extractSensitivityLabels
POST /me/drive/items/{item-id}/extractSensitivityLabels
POST /me/drive/root:/{item-path}:/extractSensitivityLabels
POST /sites/{site-id}/drive/items/{item-id}/extractSensitivityLabels
POST /sites/{site-id}/drive/root:/{item-path}:/extractSensitivityLabels
POST /users/{user-id}/drive/items/{item-id}/extractSensitivityLabels
POST /users/{user-id}/drive/root:/{item-path}:/extractSensitivityLabels

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.

Corpo da solicitação

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

Resposta

Se for bem-sucedida, esta ação devolve um 200 OK código de resposta e um objeto extractSensitivityLabelsResult no corpo da resposta.

Além dos erros gerais que se aplicam ao Microsoft Graph, esta API devolve o 423 Locked código de resposta, o que indica que o ficheiro que está a ser acedido está bloqueado. Nestes casos, a propriedade de código do objeto de resposta indica o tipo de erro que bloqueia a extração de etiquetas de confidencialidade. Seguem-se os valores possíveis para os tipos de erro.

Valor Descrição
fileDoubleKeyEncrypted Indica que o ficheiro está protegido através da encriptação de chave dupla; portanto, não pode ser aberto para a extração das etiquetas de confidencialidade.
fileDecryptionNotSupported Indica que o ficheiro encriptado tem propriedades específicas que não permitem que estes ficheiros sejam abertos pelo SharePoint para extrair etiquetas de confidencialidade.
fileDecryptionDeferred Indica que o ficheiro está a ser processado para desencriptação; portanto, não pode ser aberto para a extração das etiquetas de confidencialidade.
unknownFutureValue Valor da sentinela de enumeração evoluível. Não usar.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/v1.0/drive/root/items/016GVDAP3RCQS5VBQHORFIVU2ZMOSBL25U/extractSensitivityLabels

Resposta

O exemplo a seguir mostra a resposta.

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

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

{
  "value": {
    "@odata.type": "microsoft.graph.extractSensitivityLabelsResult",
    "labels": [
      {
        "sensitivityLabelId": "5feba255-812e-446a-ac59-a7044ef827b5",
        "assignmentMethod": "standard",
        "tenantId": "fed495cb-8c27-41ea-8749-00b0a084bc3d"
      },
      {
        "sensitivityLabelId": "fa781fdf-68c8-43ec-ae08-c4813deb2144",
        "assignmentMethod": "standard",
        "tenantId": "277601b1-6094-456c-a358-95bfc99539d7"
      },
      {
        "sensitivityLabelId": "3937098d-df0c-4c8d-8f66-5876b57b75ba",
        "assignmentMethod": "standard",
        "tenantId": "f2477f30-c8a2-422d-8995-6f056b494655"
      }
    ]
  }
}
  • Last updated on