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.
Inicie uma exportação a partir de uma ediscoveryReviewSetQuery. Para obter detalhes, veja Exportar documentos de um conjunto de revisões na Deteção de Dados Eletrónicos (Premium).
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 |
Importante
Para acesso delegado através de contas escolares ou profissionais, o utilizador com sessão iniciada tem de ter uma função suportada do Microsoft Purview através de uma das seguintes opções:
-
Gerente de Descoberta Eletrônica. Permite que os membros criem e giram casos de Deteção de Dados Eletrónicos que criam, incluindo a criação de depositários, retenções, pesquisas e outras tarefas de gestão de casos. No entanto, os Gestores de Deteção de Dados Eletrónicos só podem criar e gerir os casos que criam.
Esta é a opção com menos privilégios para gerir os seus próprios casos.
-
Administrador de Descoberta. Fornece todas as permissões do Gestor de Deteção de Dados Eletrónicos, bem como a capacidade de aceder e gerir todos os casos de Deteção de Dados Eletrónicos na organização, configurar as definições de Deteção de Dados Eletrónicos e gerir qualquer caso depois de se adicionar como membro.
Funções adicionais que fornecem acesso de escrita às funcionalidades de Deteção de Dados Eletrónicos:
-
Administrador de Conformidade. Inclui as permissões Gestão de Casos, Pesquisa de Compatibilidade e Suspensão.
-
Gestão da Organização. Inclui as permissões Gestão de Casos, Pesquisa de Compatibilidade, Suspensão e Pesquisa e Remoção.
As funções Gestor de Deteção de Dados Eletrónicos e Administrador de Deteção de Dados Eletrónicos fazem parte dos grupos de funções do Microsoft Purview e fornecem acesso às funcionalidades de Deteção de Dados Eletrónicos através do controlo de acesso baseado em funções (RBAC).
Para obter mais informações sobre permissões e funções de Deteção de Dados Eletrónicos, veja Atribuir permissões na Deteção de Dados Eletrónicos.
Solicitação HTTP
POST /security/cases/ediscoveryCases/{ediscoveryCaseId}/reviewSets/{ediscoveryReviewSetId}/queries/{queryId}/export
| 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 a seguir mostra os parâmetros que podem ser usados com esta ação.
| Parâmetro |
Tipo |
Descrição |
| description |
Cadeia de caracteres |
Descrição da exportação. |
| exportOptions |
microsoft.graph.security.exportOptions |
Opções bit a bit que controlam o formato da exportação. Os valores possíveis são: , , , (preterido), tags, , splitSourceunknownFutureValue, includeFolderAndPath, friendlyName, condensePaths. fileInfopdfReplacementtextoriginalFiles Utilize o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores desta enumeração evoluível: splitSource, includeFolderAndPath, friendlyName, condensePaths. O fileInfo membro foi preterido e deixou de devolver dados. Os ficheiros de resumo e carregamento estão sempre incluídos. Se originalFiles não estiver selecionado, apenas o tags membro é considerado. |
| exportStructure |
microsoft.graph.security.exportFileStructure |
Opções bit a bit que controlam a estrutura de ficheiros e o empacotamento da exportação. Os valores possíveis são: none, directory (preterido), pst, unknownFutureValue, msg. Utilize o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes membros desta enumeração evoluível: msg. O directory membro foi preterido. Permanece em beta para retrocompatibilidade. No futuro, utilize ou pstmsg. |
| outputName |
Cadeia de caracteres |
Nome da exportação. Obrigatório. |
| azureBlobContainer (preterido) |
Cadeia de caracteres |
Quando exporta para a sua própria conta de armazenamento Azure, o valor é o URL do contentor. A propriedade azureBlobContainer foi preterida e deixou de devolver dados. |
| azureBlobToken (preterido) |
Cadeia de caracteres |
Ao exportar para a sua própria conta de armazenamento Azure, o token de SAS para o URL do contentor. A propriedade azureBlobToken foi preterida e deixou de devolver dados. |
Resposta
Se tiver êxito, esta ação retornará um código de resposta 202 Accepted.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/58399dff-cebe-478f-b1af-d3227f1fd645/reviewSets/273f11a1-17aa-419c-981d-ff10d33e420f/queries/fcb86cd1-50e0-427c-840e-ba6f087364e5/export
Content-Type: application/json
{
"outputName": "Export reviewset query via API",
"description": "Export for the Contoso investigation 2",
"exportOptions": "originalFiles,fileInfo,tags",
"exportStructure": "directory"
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Security.Cases.EdiscoveryCases.Item.ReviewSets.Item.Queries.Item.MicrosoftGraphSecurityExport;
using Microsoft.Graph.Beta.Models.Security;
var requestBody = new ExportPostRequestBody
{
OutputName = "Export reviewset query via API",
Description = "Export for the Contoso investigation 2",
ExportOptions = ExportOptions.OriginalFiles | ExportOptions.FileInfo | ExportOptions.Tags,
ExportStructure = ExportFileStructure.Directory,
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Security.Cases.EdiscoveryCases["{ediscoveryCase-id}"].ReviewSets["{ediscoveryReviewSet-id}"].Queries["{ediscoveryReviewSetQuery-id}"].MicrosoftGraphSecurityExport.PostAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphsecurity "github.com/microsoftgraph/msgraph-beta-sdk-go/security"
graphmodelssecurity "github.com/microsoftgraph/msgraph-beta-sdk-go/models/security"
//other-imports
)
requestBody := graphsecurity.NewExportPostRequestBody()
outputName := "Export reviewset query via API"
requestBody.SetOutputName(&outputName)
description := "Export for the Contoso investigation 2"
requestBody.SetDescription(&description)
exportOptions := graphmodels.ORIGINALFILES,FILEINFO,TAGS_EXPORTOPTIONS
requestBody.SetExportOptions(&exportOptions)
exportStructure := graphmodels.DIRECTORY_EXPORTFILESTRUCTURE
requestBody.SetExportStructure(&exportStructure)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Security().Cases().EdiscoveryCases().ByEdiscoveryCaseId("ediscoveryCase-id").ReviewSets().ByEdiscoveryReviewSetId("ediscoveryReviewSet-id").Queries().ByEdiscoveryReviewSetQueryId("ediscoveryReviewSetQuery-id").MicrosoftGraphSecurityExport().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.beta.security.cases.ediscoverycases.item.reviewsets.item.queries.item.microsoftgraphsecurityexport.ExportPostRequestBody exportPostRequestBody = new com.microsoft.graph.beta.security.cases.ediscoverycases.item.reviewsets.item.queries.item.microsoftgraphsecurityexport.ExportPostRequestBody();
exportPostRequestBody.setOutputName("Export reviewset query via API");
exportPostRequestBody.setDescription("Export for the Contoso investigation 2");
exportPostRequestBody.setExportOptions(EnumSet.of(com.microsoft.graph.beta.models.security.ExportOptions.OriginalFiles, com.microsoft.graph.beta.models.security.ExportOptions.FileInfo, com.microsoft.graph.beta.models.security.ExportOptions.Tags));
exportPostRequestBody.setExportStructure(com.microsoft.graph.beta.models.security.ExportFileStructure.Directory);
graphClient.security().cases().ediscoveryCases().byEdiscoveryCaseId("{ediscoveryCase-id}").reviewSets().byEdiscoveryReviewSetId("{ediscoveryReviewSet-id}").queries().byEdiscoveryReviewSetQueryId("{ediscoveryReviewSetQuery-id}").microsoftGraphSecurityExport().post(exportPostRequestBody);
const options = {
authProvider,
};
const client = Client.init(options);
const _export = {
outputName: 'Export reviewset query via API',
description: 'Export for the Contoso investigation 2',
exportOptions: 'originalFiles,fileInfo,tags',
exportStructure: 'directory'
};
await client.api('/security/cases/ediscoveryCases/58399dff-cebe-478f-b1af-d3227f1fd645/reviewSets/273f11a1-17aa-419c-981d-ff10d33e420f/queries/fcb86cd1-50e0-427c-840e-ba6f087364e5/export')
.version('beta')
.post(_export);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Security\Cases\EdiscoveryCases\Item\ReviewSets\Item\Queries\Item\MicrosoftGraphSecurityExport\ExportPostRequestBody;
use Microsoft\Graph\Beta\Generated\Models\Security\ExportOptions;
use Microsoft\Graph\Beta\Generated\Models\Security\ExportFileStructure;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new ExportPostRequestBody();
$requestBody->setOutputName('Export reviewset query via API');
$requestBody->setDescription('Export for the Contoso investigation 2');
$requestBody->setExportOptions(new ExportOptions('originalFiles,fileInfo,tags'));
$requestBody->setExportStructure(new ExportFileStructure('directory'));
$graphServiceClient->security()->cases()->ediscoveryCases()->byEdiscoveryCaseId('ediscoveryCase-id')->reviewSets()->byEdiscoveryReviewSetId('ediscoveryReviewSet-id')->queries()->byEdiscoveryReviewSetQueryId('ediscoveryReviewSetQuery-id')->microsoftGraphSecurityExport()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Security
$params = @{
outputName = "Export reviewset query via API"
description = "Export for the Contoso investigation 2"
exportOptions = "originalFiles,fileInfo,tags"
exportStructure = "directory"
}
Export-MgBetaSecurityCaseEdiscoveryCaseReviewSetQuery -EdiscoveryCaseId $ediscoveryCaseId -EdiscoveryReviewSetId $ediscoveryReviewSetId -EdiscoveryReviewSetQueryId $ediscoveryReviewSetQueryId -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.security.cases.ediscoverycases.item.reviewsets.item.queries.item.microsoft_graph_security_export.export_post_request_body import ExportPostRequestBody
from msgraph_beta.generated.models.export_options import ExportOptions
from msgraph_beta.generated.models.export_file_structure import ExportFileStructure
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ExportPostRequestBody(
output_name = "Export reviewset query via API",
description = "Export for the Contoso investigation 2",
export_options = ExportOptions.OriginalFiles | ExportOptions.FileInfo | ExportOptions.Tags,
export_structure = ExportFileStructure.Directory,
)
await graph_client.security.cases.ediscovery_cases.by_ediscovery_case_id('ediscoveryCase-id').review_sets.by_ediscovery_review_set_id('ediscoveryReviewSet-id').queries.by_ediscovery_review_set_query_id('ediscoveryReviewSetQuery-id').microsoft_graph_security_export.post(request_body)
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 202 Accepted