Compartilhar via

tenantDataSecurityAndGovernance: processContentAsync

Namespace: microsoft.graph

Processe um lote de entradas de conteúdo ao nível do inquilino de forma assíncrona em relação às políticas de proteção de dados.

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

Solicitação HTTP

POST /security/dataSecurityAndGovernance/processContentAsync

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.

Corpo da solicitação

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

Parâmetro Tipo Descrição
processContentRequests processContentBatchRequest collection (coleção processContentBatchRequest ) Obrigatório. Uma coleção de pedidos individuais de processamento de conteúdos, cada um com o seu próprio contexto de utilizador, conteúdo e ID de pedido.

O tamanho do texto em cada entrada de conteúdo está limitado a 2 MB. O número máximo de entradas de conteúdo por pedido é 64. Estes podem ser distribuídos por até 64 processContentRequests, cada um com uma entrada de conteúdo ou 2 processoContentRequests, cada um com 32 entradas de conteúdo ou outra combinação que não exceda 64 entradas de conteúdo.

Resposta

Na maioria dos casos, quando for bem-sucedido, este método devolve um 204, Sem Conteúdo. Este método também pode devolver um 200 OK código de resposta e uma coleção de objetos processContentResponses no corpo da resposta. Cada objeto na coleção corresponde a um dos itens de pedido no lote, identificado pelo requestIde contém os resultados (ações de política, erros, estado de âmbito) desse item específico. Dado que se trata de uma API de intenção assíncrona na perspetiva do autor da chamada que submete o lote, o 200 OK indica que o lote foi aceite; os resultados no corpo da resposta refletem o resultado do processamento de cada item pelo serviço.

Exemplo

Solicitação

O exemplo seguinte mostra um pedido em lote com dois itens.

POST https://graph.microsoft.com/v1.0/security/dataSecurityAndGovernance/processContentAsync
Content-type: application/json

{
   "processContentRequests": [
   {
      "requestId": "bca22a4e-245f-4b6f-a242-9bdbc238e413",
      "userId": "47b5e19a-e210-4ed5-a643-dbf5b47e1821",
      "contentToProcess": {
         "contentEntries": [
            {
               "@odata.type": "#microsoft.graph.processConversationMetadata",
               "identifier": "47138e53-c855-47f0-9271-d473681ac310",
               "content": {
                  "@odata.type": "#microsoft.graph.textContent",
                  "data": "1309475745, Is D3m0P@sswd! a secure password?"
               },
               "name": "Chat message",
               "correlationId": "e76bcc34-07ea-43f4-ae64-d383df423b90",
               "sequenceNumber": 0,
               "createdDateTime": "2025-04-21T16:00:00Z",
               "modifiedDateTime": "2025-04-21T16:00:00Z"
            }
         ],
         "activityMetadata": {
            "activity": "uploadText",
         },
         "deviceMetadata": {
            "operatingSystemSpecifications": {
               "operatingSystemPlatform": "Windows",
               "operatingSystemVersion": "10.0.19045"
            },
            "ipAddress": "127.0.0.1"
         },
         "protectedAppMetadata": {
            "name": "PC Purview Workload",
            "version": "0.2",
            "applicationLocation":{
               "@odata.type": "microsoft.graph.policyLocationApplication",
               "value": "be121c8f-ecd8-4026-b699-669e0ce1bcbf"
            }
         },
         "integratedAppMetadata": {
            "name": "PCA Workload Sample - IA",
            "version": "1.0"
         }
      }
   },
   {
      "requestId": "f1df4929-4116-4ee6-b008-0a6a42037aed",
      "userId": "47b5e19a-e210-4ed5-a643-dbf5b47e1821",
      "contentToProcess": {
         "contentEntries": [
            {
               "@odata.type": "#microsoft.graph.processConversationMetadata",
               "identifier": "02be9bc1-335c-4184-ae4c-247449e5e85d",
               "content": {
                  "@odata.type": "#microsoft.graph.textContent",
                  "data": "1309475746, The password D3m0P@sswd! has a mix of uppercase and lowercase letters, numbers, and special characters, which are good practices for creating a strong password. However, its length and the use of common patterns like 'Demo' and 'Password' can make it less secure than it appears."
               },
               "name": "Chat message",
               "correlationId": "e76bcc34-07ea-43f4-ae64-d383df423b90",
               "sequenceNumber": 1,
               "createdDateTime": "2025-04-21T16:00:00Z",
               "modifiedDateTime": "2025-04-21T16:00:00Z"
            }
         ],
         "activityMetadata": {
            "activity": "downloadText",
         },
         "deviceMetadata": {
            "operatingSystemSpecifications": {
               "operatingSystemPlatform": "Windows",
               "operatingSystemVersion": "10.0.19045"
             },
            "ipAddress": "127.0.0.1"
         },
         "protectedAppMetadata": {
            "name": "PC Purview Workload",
            "version": "0.2",
            "applicationLocation":{
               "@odata.type": "microsoft.graph.policyLocationApplication",
               "value": "be19dc8f-ecd8-4026-b699-669e0ce1bcbf"
            }
         },
         "integratedAppMetadata": {
            "name": "PCA Workload Sample - IA",
            "version": "1.0"
         }
      }
     }
   ]
}

Resposta

O exemplo seguinte mostra a resposta 204 Sem Conteúdo.

HTTP/1.1 204 No Content
  • Last updated on