sensitivityLabel: extractContentLabel

Namespace: microsoft.graph.security

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.

Use os metadados existentes em uma informação já rotulada para resolver os metadados para um rótulo de confidencialidade específico. A entrada contentInfo é resolvida como informationProtectionContentLabel.

Observação

O recurso contentLabel representa um rótulo de confidencialidade que foi aplicado a uma informação. sensitivityLabels são os rótulos abstratos que fazem parte da política de rotulagem organizacional e podem ser aplicados às informações.

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) InformationProtectionPolicy. Read Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application InformationProtectionPolicy.Read.All Indisponível.

Solicitação HTTP

Para extrair o rótulo de conteúdo como o usuário conectado (permissão delegada) ou um usuário especificado (permissão de aplicativo):

POST /users/{usersId}/security/informationProtection/sensitivityLabels/extractContentLabel
POST /me/security/informationProtection/sensitivityLabels/extractContentLabel

Para extrair o rótulo de conteúdo como uma entidade de serviço (permissão de aplicativo):

POST /users/security/informationProtection/sensitivityLabels/extractContentLabel

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 Tipo de conteúdo: application/json. Obrigatório.
User-Agent Descreve o nome e a versão do aplicativo de chamada. Os detalhes serão exibidos no Azure Proteção de Informações Analytics. O formato sugerido é ApplicationName/Version. Opcional.

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON dos parâmetros.

A tabela a seguir mostra o parâmetro que pode ser usado com essa ação.

Parâmetro Tipo Descrição
contentInfo contentInfo Fornece detalhes sobre o formato do conteúdo, o estado do conteúdo e os metadados existentes como pares de chave-valor.

Resposta

Se for bem-sucedida, essa ação retornará um código de 200 OK resposta e um objeto contentLabel no corpo da resposta.

Exemplos

Resposta

O exemplo a seguir mostra a resposta.

POST https://graph.microsoft.com/beta/users/bob@contoso.com/security/informationProtection/sensitivityLabels/extractContentLabel
Content-type: application/json
User-agent: ContosoLOBApp/1.0

{
    "contentInfo": {
        "format": "default",
        "identifier": "MyDoc.docx",
        "state": "rest",
        "metadata": [
            {
                "name": "MSIP_Label_0ed12617-d0ef-4053-b8e4-ecf5bcf2ffb3_Enabled",
                "value": "True"
            },
            {
                "name": "MSIP_Label_0ed12617-d0ef-4053-b8e4-ecf5bcf2ffb3_Method",
                "value": "Standard"
            },
            {
                "name": "MSIP_Label_0ed12617-d0ef-4053-b8e4-ecf5bcf2ffb3_SetDate",
                "value": "1/1/0001 12:00:00 AM"
            },
            {
                "name": "MSIP_Label_0ed12617-d0ef-4053-b8e4-ecf5bcf2ffb3_SiteId",
                "value": "cfa4cf1d-a337-4481-aa99-19d8f3d63f7c"
            },
            {
                "name": "MSIP_Label_0ed12617-d0ef-4053-b8e4-ecf5bcf2ffb3_Name",
                "value": "LabelScopedToBob_Tests"
            },
            {
                "name": "MSIP_Label_0ed12617-d0ef-4053-b8e4-ecf5bcf2ffb3_ContentBits",
                "value": "0"
            },
            {
                "name": "MSIP_Label_0ed12617-d0ef-4053-b8e4-ecf5bcf2ffb3_ActionId",
                "value": "00000000-0000-0000-0000-000000000000"
            }
        ]
    }
}

Resposta

O exemplo a seguir mostra a resposta.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.security.contentLabel",
    "createdDateTime": "2001-01-01T12:00:00Z",
    "assignmentMethod": "standard",
    "sensitivityLabelId": "0ed12617-d0ef-4053-b8e4-ecf5bcf2ffb3"
}