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 um reviewSet. Para obter mais informações, 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 |
Solicitação HTTP
POST /security/cases/ediscoveryCases/{ediscoveryCaseId}/reviewSets/{ediscoveryReviewSetId}/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 originalFiles, text, pdfReplacement, fileInfo, tags, unknownFutureValue, splitSource, includeFolderAndPath, friendlyName, condensePaths. 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 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 contém a localização da operação Exportar que foi criada para processar a exportação.
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/export
Content-Type: application/json
{
"outputName": "Export via API",
"description": "Export for the Contoso investigation",
"exportOptions": "originalFiles, tags, splitSource, includeFolderAndPath, friendlyName, condensePaths",
"exportStructure": "msg"
}
// 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.MicrosoftGraphSecurityExport;
using Microsoft.Graph.Beta.Models.Security;
var requestBody = new ExportPostRequestBody
{
OutputName = "Export via API",
Description = "Export for the Contoso investigation",
ExportOptions = ExportOptions.OriginalFiles | ExportOptions.Tags | ExportOptions.SplitSource | ExportOptions.IncludeFolderAndPath | ExportOptions.FriendlyName | ExportOptions.CondensePaths,
ExportStructure = ExportFileStructure.Msg,
};
// 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}"].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 via API"
requestBody.SetOutputName(&outputName)
description := "Export for the Contoso investigation"
requestBody.SetDescription(&description)
exportOptions := graphmodels.ORIGINALFILES, TAGS, SPLITSOURCE, INCLUDEFOLDERANDPATH, FRIENDLYNAME, CONDENSEPATHS_EXPORTOPTIONS
requestBody.SetExportOptions(&exportOptions)
exportStructure := graphmodels.MSG_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").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.microsoftgraphsecurityexport.ExportPostRequestBody exportPostRequestBody = new com.microsoft.graph.beta.security.cases.ediscoverycases.item.reviewsets.item.microsoftgraphsecurityexport.ExportPostRequestBody();
exportPostRequestBody.setOutputName("Export via API");
exportPostRequestBody.setDescription("Export for the Contoso investigation");
exportPostRequestBody.setExportOptions(EnumSet.of(com.microsoft.graph.beta.models.security.ExportOptions.OriginalFiles, com.microsoft.graph.beta.models.security.ExportOptions.Tags, com.microsoft.graph.beta.models.security.ExportOptions.SplitSource, com.microsoft.graph.beta.models.security.ExportOptions.IncludeFolderAndPath, com.microsoft.graph.beta.models.security.ExportOptions.FriendlyName, com.microsoft.graph.beta.models.security.ExportOptions.CondensePaths));
exportPostRequestBody.setExportStructure(com.microsoft.graph.beta.models.security.ExportFileStructure.Msg);
graphClient.security().cases().ediscoveryCases().byEdiscoveryCaseId("{ediscoveryCase-id}").reviewSets().byEdiscoveryReviewSetId("{ediscoveryReviewSet-id}").microsoftGraphSecurityExport().post(exportPostRequestBody);
const options = {
authProvider,
};
const client = Client.init(options);
const _export = {
outputName: 'Export via API',
description: 'Export for the Contoso investigation',
exportOptions: 'originalFiles, tags, splitSource, includeFolderAndPath, friendlyName, condensePaths',
exportStructure: 'msg'
};
await client.api('/security/cases/ediscoveryCases/58399dff-cebe-478f-b1af-d3227f1fd645/reviewSets/273f11a1-17aa-419c-981d-ff10d33e420f/export')
.version('beta')
.post(_export);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Security\Cases\EdiscoveryCases\Item\ReviewSets\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 via API');
$requestBody->setDescription('Export for the Contoso investigation');
$requestBody->setExportOptions(new ExportOptions('originalFiles, tags, splitSource, includeFolderAndPath, friendlyName, condensePaths'));
$requestBody->setExportStructure(new ExportFileStructure('msg'));
$graphServiceClient->security()->cases()->ediscoveryCases()->byEdiscoveryCaseId('ediscoveryCase-id')->reviewSets()->byEdiscoveryReviewSetId('ediscoveryReviewSet-id')->microsoftGraphSecurityExport()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Security
$params = @{
outputName = "Export via API"
description = "Export for the Contoso investigation"
exportOptions = "originalFiles, tags, splitSource, includeFolderAndPath, friendlyName, condensePaths"
exportStructure = "msg"
}
Export-MgBetaSecurityCaseEdiscoveryCaseReviewSet -EdiscoveryCaseId $ediscoveryCaseId -EdiscoveryReviewSetId $ediscoveryReviewSetId -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.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 via API",
description = "Export for the Contoso investigation",
export_options = ExportOptions.OriginalFiles | ExportOptions.Tags | ExportOptions.SplitSource | ExportOptions.IncludeFolderAndPath | ExportOptions.FriendlyName | ExportOptions.CondensePaths,
export_structure = ExportFileStructure.Msg,
)
await graph_client.security.cases.ediscovery_cases.by_ediscovery_case_id('ediscoveryCase-id').review_sets.by_ediscovery_review_set_id('ediscoveryReviewSet-id').microsoft_graph_security_export.post(request_body)
Resposta
O exemplo seguinte mostra uma resposta.
HTTP/1.1 202 Accepted