Compartilhar via


ediscoverySearch: exportResult

Espaço de nomes: 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.

Exportar resultados de uma pesquisa de deteção estimada. Para obter detalhes, veja Gerir uma estimativa de coleção.

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

Solicitação HTTP

POST /security/cases/ediscoveryCases/{ediscoveryCaseId}/searches/{ediscoverySearchId}/exportResult
POST /security/cases/ediscoveryCases('{ediscoveryCaseId}')/searches('{ediscoverySearchId}')/exportResult

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

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

A tabela seguinte lista os parâmetros que pode utilizar com esta ação.

Parâmetro Tipo Descrição
additionalOptions microsoft.graph.security.additionalOptions As opções adicionais para a exportação. Os valores possíveis são none, teamsAndYammerConversations, cloudAttachments, allDocumentVersions, subfolderContents, listAttachments, unknownFutureValue. Obrigatório.
description Cadeia de caracteres A descrição do resultado da exportação.
displayName Cadeia de caracteres O nome a apresentar do resultado da exportação.
exportCriteria microsoft.graph.security.exportCriteria A parte dos resultados da estimativa a exportar. Os valores possíveis são: searchHits, partiallyIndexed, unknownFutureValue. Obrigatório.
exportFormat microsoft.graph.security.exportFormat O formato pretendido dos e-mails exportados. Os valores possíveis são: pst, msg, eml, unknownFutureValue. Obrigatório.
exportLocation microsoft.graph.security.exportLocation Âmbito de localização para itens parcialmente indexados. Pode optar por incluir itens parcialmente indexados apenas em localizações reativas com acessos de pesquisa ou em todas as localizações direcionadas. Os valores possíveis são: responsiveLocations, nonresponsiveLocations, unknownFutureValue.

Resposta

Se a exportação tiver sido iniciada com êxito, esta ação devolve um 202 Accepted código de resposta. A resposta também contém um Location cabeçalho que inclui a localização do microsoft.graph.security.ediscoverySearchExportOperation que foi criado para processar a exportação. Para marcar a status da operação de exportação, faça um pedido GET para o URL de localização.

Exemplos

Exemplo 1: Exportar resultados apenas com resultados de pesquisa, excluindo itens parcialmente indexados, sem opções adicionais, como ficheiros .pst para cada caixa de correio

O exemplo seguinte mostra como exportar resultados apenas com resultados de pesquisa, excluindo itens parcialmente indexados, sem opções adicionais selecionadas, como ficheiros .pst para cada caixa de correio.

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/dbc06feb-a6a5-46a2-8e4e-534353b071e4/searches/6c2ab774-2d2a-46b9-a601-3130f518757b/exportResult
Content-Type: application/json

{
  "displayName": "Export 1 - simple PST",
  "exportCriteria": "searchHits",
  "additionalOptions": "none",
  "exportFormat": "pst"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 202 Accepted
Content-Length: 0
Location: https://graph.microsoft.com/beta/security/cases/ediscoverycases('dbc06feb-a6a5-46a2-8e4e-534353b071e4')/operations('01826ce3-43a3-4235-a121-81d05926efae')

Exemplo 2: exportar resultados com resultados de pesquisa e itens parcialmente indexados em todas as localizações, sem opções adicionais, como ficheiros .pst para cada caixa de correio.

O exemplo seguinte mostra como exportar resultados com resultados de pesquisa e itens parcialmente indexados em todas as localizações, sem opções adicionais selecionadas, como ficheiros .pst para cada caixa de correio.

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/dbc06feb-a6a5-46a2-8e4e-534353b071e4/searches/6c2ab774-2d2a-46b9-a601-3130f518757b/exportResult
Content-Type: application/json

{
  "displayName": "Export 2",
  "exportCriteria": "searchHits, partiallyIndexed",
  "exportLocation": "responsiveLocations, nonresponsiveLocations",
  "additionalOptions": "none",
  "exportFormat": "pst"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 202 Accepted
Content-Length: 0
Location: https://graph.microsoft.com/beta/security/cases/ediscoverycases('dbc06feb-a6a5-46a2-8e4e-534353b071e4')/operations('c74d3039-5c79-4093-8e45-2abb94e32ba9')

Exemplo 3: Exportar resultados com resultados de pesquisa e itens parcialmente indexados em localizações com resultados de pesquisa, sem opções adicionais, uma vez que .msg ficheiros para cada mensagem

O exemplo seguinte mostra como exportar resultados com resultados de pesquisa e itens parcialmente indexados em localizações com resultados de pesquisa, sem opções adicionais selecionadas, uma vez que .msg ficheiros para cada mensagem.

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/dbc06feb-a6a5-46a2-8e4e-534353b071e4/searches/6c2ab774-2d2a-46b9-a601-3130f518757b/exportResult
Content-Type: application/json

{
  "displayName": "Export 3",
  "exportCriteria": "searchHits, partiallyIndexed",
  "exportLocation": "responsiveLocations",
  "additionalOptions": "none",
  "exportFormat": "msg"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 202 Accepted
Content-Length: 0
Location: https://graph.microsoft.com/beta/security/cases/ediscoverycases('dbc06feb-a6a5-46a2-8e4e-534353b071e4')/operations('4bf812e0-44ad-4856-a302-b4ea79725573')

Exemplo 4: Exportar resultados com itens parcialmente indexados em todas as localizações direcionadas, com todas as opções adicionais, como .eml ficheiros para cada mensagem

O exemplo seguinte mostra como exportar resultados com itens parcialmente indexados em todas as localizações de destino, com todas as opções adicionais selecionadas, como .eml ficheiros para cada mensagem.

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/dbc06feb-a6a5-46a2-8e4e-534353b071e4/searches/6c2ab774-2d2a-46b9-a601-3130f518757b/exportResult
Content-Type: application/json

{
  "displayName": "Export 4",
  "exportCriteria": "partiallyIndexed",
  "exportLocation": "responsiveLocations, nonresponsiveLocations",
  "additionalOptions": "teamsAndYammerConversations, cloudAttachments, allDocumentVersions, subfolderContents, listAttachments",
  "exportFormat": "eml"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 202 Accepted
Content-Length: 0
Location: https://graph.microsoft.com/beta/security/cases/ediscoverycases('dbc06feb-a6a5-46a2-8e4e-534353b071e4')/operations('05b5c707-ed0d-4f5c-bbfd-e4941137baf1')

Exemplo 5: Exportar resultados com itens parcialmente indexados em localizações de acesso à pesquisa, com anexos na nuvem, como .eml ficheiros para cada mensagem

O exemplo seguinte mostra como exportar resultados com itens parcialmente indexados em localizações de acesso à pesquisa, com anexos na nuvem, como .eml ficheiros para cada mensagem.

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/dbc06feb-a6a5-46a2-8e4e-534353b071e4/searches/6c2ab774-2d2a-46b9-a601-3130f518757b/exportResult
Content-Type: application/json

{
  "displayName": "Export 5",
  "exportCriteria": "partiallyIndexed",
  "exportLocation": "responsiveLocations",
  "additionalOptions": "cloudAttachments",
  "exportFormat": "eml"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 202 Accepted
Content-Length: 0
Location: https://graph.microsoft.com/beta/security/cases/ediscoverycases('dbc06feb-a6a5-46a2-8e4e-534353b071e4')/operations('d488f23e-f3cb-4a1c-9b9f-88ac4342f534')