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 o processo de adicionar uma coleção dos serviços do Microsoft 365 a um conjunto de revisões. Após a criação da operação, pode obter a status da operação ao obter o parâmetro dos Location cabeçalhos de resposta. A localização fornece um URL que devolve uma operação Adicionar para rever conjunto.
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}/addToReviewSet
| 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 |
| additionalDataOptions |
microsoft.graph.security.additionalDataOptions |
As opções para adicionar itens ao conjunto de revisão. Os valores possíveis são: allVersions, , linkedFilesunknownFutureValue, advancedIndexing, , htmlTranscriptslistAttachments, messageConversationExpansion, , locationsWithoutHits, . allItemsInFolder Utilize o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores desta enumeração evoluível: advancedIndexing, listAttachments, htmlTranscripts, messageConversationExpansion, locationsWithoutHits, . allItemsInFolder Os locationsWithoutHits valores e advancedIndexing só são considerados se itemsToIncude estiver definido como partiallyIndexed. |
| cloudAttachmentVersion |
microsoft.graph.security.cloudAttachmentVersion |
Especifica o número de versões de anexos na cloud a recolher. Os valores possíveis são: latest, recent10, recent100, all, unknownFutureValue. O valor padrão é latest. |
| documentVersion |
microsoft.graph.security.documentVersion |
Especifica o número de versões do documento a recolher. Os valores possíveis são: latest, recent10, recent100, all, unknownFutureValue. O valor padrão é latest. |
| itemsToInclude |
microsoft.graph.security.itemsToInclude |
Os itens a incluir no conjunto de revisão. Os valores possíveis são: searchHits, partiallyIndexed, unknownFutureValue. |
| search |
microsoft.graph.security.ediscoverySearch |
O ID da pesquisa de Deteção de Dados Eletrónicos que pretende adicionar ao conjunto de revisão. |
Resposta
Se tiver êxito, esta ação retornará um código de resposta 202 Accepted.
Exemplos
Exemplo 1: Adicionar pesquisa com ficheiros ligados e a versão mais recente do anexo na nuvem
O exemplo seguinte mostra como adicionar pesquisa ao conjunto de revisão e incluir a versão mais recente dos ficheiros partilhados como ligações.
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/63ef0fd7-0db2-45eb-a9d7-7d75c8239873/addToReviewSet
Content-Type: application/json
{
"search": {
"id": "c17e91d6-6bc0-4ecb-b388-269ea3d4ffb7"
},
"additionalDataOptions": "linkedFiles",
"cloudAttachmentVersion": "latest"
}
// 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.MicrosoftGraphSecurityAddToReviewSet;
using Microsoft.Graph.Beta.Models.Security;
var requestBody = new AddToReviewSetPostRequestBody
{
Search = new EdiscoverySearch
{
Id = "c17e91d6-6bc0-4ecb-b388-269ea3d4ffb7",
},
AdditionalDataOptions = AdditionalDataOptions.LinkedFiles,
CloudAttachmentVersion = CloudAttachmentVersion.Latest,
};
// 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}"].MicrosoftGraphSecurityAddToReviewSet.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.NewAddToReviewSetPostRequestBody()
search := graphmodelssecurity.NewEdiscoverySearch()
id := "c17e91d6-6bc0-4ecb-b388-269ea3d4ffb7"
search.SetId(&id)
requestBody.SetSearch(search)
additionalDataOptions := graphmodels.LINKEDFILES_ADDITIONALDATAOPTIONS
requestBody.SetAdditionalDataOptions(&additionalDataOptions)
cloudAttachmentVersion := graphmodels.LATEST_CLOUDATTACHMENTVERSION
requestBody.SetCloudAttachmentVersion(&cloudAttachmentVersion)
// 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").MicrosoftGraphSecurityAddToReviewSet().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.microsoftgraphsecurityaddtoreviewset.AddToReviewSetPostRequestBody addToReviewSetPostRequestBody = new com.microsoft.graph.beta.security.cases.ediscoverycases.item.reviewsets.item.microsoftgraphsecurityaddtoreviewset.AddToReviewSetPostRequestBody();
com.microsoft.graph.beta.models.security.EdiscoverySearch search = new com.microsoft.graph.beta.models.security.EdiscoverySearch();
search.setId("c17e91d6-6bc0-4ecb-b388-269ea3d4ffb7");
addToReviewSetPostRequestBody.setSearch(search);
addToReviewSetPostRequestBody.setAdditionalDataOptions(EnumSet.of(com.microsoft.graph.beta.models.security.AdditionalDataOptions.LinkedFiles));
addToReviewSetPostRequestBody.setCloudAttachmentVersion(com.microsoft.graph.beta.models.security.CloudAttachmentVersion.Latest);
graphClient.security().cases().ediscoveryCases().byEdiscoveryCaseId("{ediscoveryCase-id}").reviewSets().byEdiscoveryReviewSetId("{ediscoveryReviewSet-id}").microsoftGraphSecurityAddToReviewSet().post(addToReviewSetPostRequestBody);
const options = {
authProvider,
};
const client = Client.init(options);
const addToReviewSet = {
search: {
id: 'c17e91d6-6bc0-4ecb-b388-269ea3d4ffb7'
},
additionalDataOptions: 'linkedFiles',
cloudAttachmentVersion: 'latest'
};
await client.api('/security/cases/ediscoveryCases/58399dff-cebe-478f-b1af-d3227f1fd645/reviewSets/63ef0fd7-0db2-45eb-a9d7-7d75c8239873/addToReviewSet')
.version('beta')
.post(addToReviewSet);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Security\Cases\EdiscoveryCases\Item\ReviewSets\Item\MicrosoftGraphSecurityAddToReviewSet\AddToReviewSetPostRequestBody;
use Microsoft\Graph\Beta\Generated\Models\Security\EdiscoverySearch;
use Microsoft\Graph\Beta\Generated\Models\Security\AdditionalDataOptions;
use Microsoft\Graph\Beta\Generated\Models\Security\CloudAttachmentVersion;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new AddToReviewSetPostRequestBody();
$search = new EdiscoverySearch();
$search->setId('c17e91d6-6bc0-4ecb-b388-269ea3d4ffb7');
$requestBody->setSearch($search);
$requestBody->setAdditionalDataOptions(new AdditionalDataOptions('linkedFiles'));
$requestBody->setCloudAttachmentVersion(new CloudAttachmentVersion('latest'));
$graphServiceClient->security()->cases()->ediscoveryCases()->byEdiscoveryCaseId('ediscoveryCase-id')->reviewSets()->byEdiscoveryReviewSetId('ediscoveryReviewSet-id')->microsoftGraphSecurityAddToReviewSet()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Security
$params = @{
search = @{
id = "c17e91d6-6bc0-4ecb-b388-269ea3d4ffb7"
}
additionalDataOptions = "linkedFiles"
cloudAttachmentVersion = "latest"
}
Add-MgBetaSecurityCaseEdiscoveryCaseReviewSetToReviewSet -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_add_to_review_set.add_to_review_set_post_request_body import AddToReviewSetPostRequestBody
from msgraph_beta.generated.models.security.ediscovery_search import EdiscoverySearch
from msgraph_beta.generated.models.additional_data_options import AdditionalDataOptions
from msgraph_beta.generated.models.cloud_attachment_version import CloudAttachmentVersion
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = AddToReviewSetPostRequestBody(
search = EdiscoverySearch(
id = "c17e91d6-6bc0-4ecb-b388-269ea3d4ffb7",
),
additional_data_options = AdditionalDataOptions.LinkedFiles,
cloud_attachment_version = CloudAttachmentVersion.Latest,
)
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_add_to_review_set.post(request_body)
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 202 Accepted
Exemplo 2: adicionar pesquisa com todas as opções de dados e as versões mais recentes da cloud e do documento
O exemplo seguinte mostra como adicionar pesquisa ao conjunto de revisões com todas as opções selecionadas para additionalDataOptions, as 10 versões mais recentes selecionadas para documentos e a versão mais recente selecionada para anexos na nuvem.
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/63ef0fd7-0db2-45eb-a9d7-7d75c8239873/addToReviewSet
Content-Type: application/json
{
"search": {
"id": "c17e91d6-6bc0-4ecb-b388-269ea3d4ffb7"
},
"additionalDataOptions": "linkedFiles, allVersions, advancedIndexing, listAttachments, htmlTranscripts, messageConversationExpansion, locationsWithoutHits, allItemsInFolder",
"cloudAttachmentVersion": "latest",
"documentVersion": "recent10"
}
// 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.MicrosoftGraphSecurityAddToReviewSet;
using Microsoft.Graph.Beta.Models.Security;
var requestBody = new AddToReviewSetPostRequestBody
{
Search = new EdiscoverySearch
{
Id = "c17e91d6-6bc0-4ecb-b388-269ea3d4ffb7",
},
AdditionalDataOptions = AdditionalDataOptions.LinkedFiles | AdditionalDataOptions.AllVersions | AdditionalDataOptions.AdvancedIndexing | AdditionalDataOptions.ListAttachments | AdditionalDataOptions.HtmlTranscripts | AdditionalDataOptions.MessageConversationExpansion | AdditionalDataOptions.LocationsWithoutHits | AdditionalDataOptions.AllItemsInFolder,
CloudAttachmentVersion = CloudAttachmentVersion.Latest,
DocumentVersion = DocumentVersion.Recent10,
};
// 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}"].MicrosoftGraphSecurityAddToReviewSet.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.NewAddToReviewSetPostRequestBody()
search := graphmodelssecurity.NewEdiscoverySearch()
id := "c17e91d6-6bc0-4ecb-b388-269ea3d4ffb7"
search.SetId(&id)
requestBody.SetSearch(search)
additionalDataOptions := graphmodels.LINKEDFILES, ALLVERSIONS, ADVANCEDINDEXING, LISTATTACHMENTS, HTMLTRANSCRIPTS, MESSAGECONVERSATIONEXPANSION, LOCATIONSWITHOUTHITS, ALLITEMSINFOLDER_ADDITIONALDATAOPTIONS
requestBody.SetAdditionalDataOptions(&additionalDataOptions)
cloudAttachmentVersion := graphmodels.LATEST_CLOUDATTACHMENTVERSION
requestBody.SetCloudAttachmentVersion(&cloudAttachmentVersion)
documentVersion := graphmodels.RECENT10_DOCUMENTVERSION
requestBody.SetDocumentVersion(&documentVersion)
// 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").MicrosoftGraphSecurityAddToReviewSet().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.microsoftgraphsecurityaddtoreviewset.AddToReviewSetPostRequestBody addToReviewSetPostRequestBody = new com.microsoft.graph.beta.security.cases.ediscoverycases.item.reviewsets.item.microsoftgraphsecurityaddtoreviewset.AddToReviewSetPostRequestBody();
com.microsoft.graph.beta.models.security.EdiscoverySearch search = new com.microsoft.graph.beta.models.security.EdiscoverySearch();
search.setId("c17e91d6-6bc0-4ecb-b388-269ea3d4ffb7");
addToReviewSetPostRequestBody.setSearch(search);
addToReviewSetPostRequestBody.setAdditionalDataOptions(EnumSet.of(com.microsoft.graph.beta.models.security.AdditionalDataOptions.LinkedFiles, com.microsoft.graph.beta.models.security.AdditionalDataOptions.AllVersions, com.microsoft.graph.beta.models.security.AdditionalDataOptions.AdvancedIndexing, com.microsoft.graph.beta.models.security.AdditionalDataOptions.ListAttachments, com.microsoft.graph.beta.models.security.AdditionalDataOptions.HtmlTranscripts, com.microsoft.graph.beta.models.security.AdditionalDataOptions.MessageConversationExpansion, com.microsoft.graph.beta.models.security.AdditionalDataOptions.LocationsWithoutHits, com.microsoft.graph.beta.models.security.AdditionalDataOptions.AllItemsInFolder));
addToReviewSetPostRequestBody.setCloudAttachmentVersion(com.microsoft.graph.beta.models.security.CloudAttachmentVersion.Latest);
addToReviewSetPostRequestBody.setDocumentVersion(com.microsoft.graph.beta.models.security.DocumentVersion.Recent10);
graphClient.security().cases().ediscoveryCases().byEdiscoveryCaseId("{ediscoveryCase-id}").reviewSets().byEdiscoveryReviewSetId("{ediscoveryReviewSet-id}").microsoftGraphSecurityAddToReviewSet().post(addToReviewSetPostRequestBody);
const options = {
authProvider,
};
const client = Client.init(options);
const addToReviewSet = {
search: {
id: 'c17e91d6-6bc0-4ecb-b388-269ea3d4ffb7'
},
additionalDataOptions: 'linkedFiles, allVersions, advancedIndexing, listAttachments, htmlTranscripts, messageConversationExpansion, locationsWithoutHits, allItemsInFolder',
cloudAttachmentVersion: 'latest',
documentVersion: 'recent10'
};
await client.api('/security/cases/ediscoveryCases/58399dff-cebe-478f-b1af-d3227f1fd645/reviewSets/63ef0fd7-0db2-45eb-a9d7-7d75c8239873/addToReviewSet')
.version('beta')
.post(addToReviewSet);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Security\Cases\EdiscoveryCases\Item\ReviewSets\Item\MicrosoftGraphSecurityAddToReviewSet\AddToReviewSetPostRequestBody;
use Microsoft\Graph\Beta\Generated\Models\Security\EdiscoverySearch;
use Microsoft\Graph\Beta\Generated\Models\Security\AdditionalDataOptions;
use Microsoft\Graph\Beta\Generated\Models\Security\CloudAttachmentVersion;
use Microsoft\Graph\Beta\Generated\Models\Security\DocumentVersion;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new AddToReviewSetPostRequestBody();
$search = new EdiscoverySearch();
$search->setId('c17e91d6-6bc0-4ecb-b388-269ea3d4ffb7');
$requestBody->setSearch($search);
$requestBody->setAdditionalDataOptions(new AdditionalDataOptions('linkedFiles, allVersions, advancedIndexing, listAttachments, htmlTranscripts, messageConversationExpansion, locationsWithoutHits, allItemsInFolder'));
$requestBody->setCloudAttachmentVersion(new CloudAttachmentVersion('latest'));
$requestBody->setDocumentVersion(new DocumentVersion('recent10'));
$graphServiceClient->security()->cases()->ediscoveryCases()->byEdiscoveryCaseId('ediscoveryCase-id')->reviewSets()->byEdiscoveryReviewSetId('ediscoveryReviewSet-id')->microsoftGraphSecurityAddToReviewSet()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Security
$params = @{
search = @{
id = "c17e91d6-6bc0-4ecb-b388-269ea3d4ffb7"
}
additionalDataOptions = "linkedFiles, allVersions, advancedIndexing, listAttachments, htmlTranscripts, messageConversationExpansion, locationsWithoutHits, allItemsInFolder"
cloudAttachmentVersion = "latest"
documentVersion = "recent10"
}
Add-MgBetaSecurityCaseEdiscoveryCaseReviewSetToReviewSet -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_add_to_review_set.add_to_review_set_post_request_body import AddToReviewSetPostRequestBody
from msgraph_beta.generated.models.security.ediscovery_search import EdiscoverySearch
from msgraph_beta.generated.models.additional_data_options import AdditionalDataOptions
from msgraph_beta.generated.models.cloud_attachment_version import CloudAttachmentVersion
from msgraph_beta.generated.models.document_version import DocumentVersion
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = AddToReviewSetPostRequestBody(
search = EdiscoverySearch(
id = "c17e91d6-6bc0-4ecb-b388-269ea3d4ffb7",
),
additional_data_options = AdditionalDataOptions.LinkedFiles | AdditionalDataOptions.AllVersions | AdditionalDataOptions.AdvancedIndexing | AdditionalDataOptions.ListAttachments | AdditionalDataOptions.HtmlTranscripts | AdditionalDataOptions.MessageConversationExpansion | AdditionalDataOptions.LocationsWithoutHits | AdditionalDataOptions.AllItemsInFolder,
cloud_attachment_version = CloudAttachmentVersion.Latest,
document_version = DocumentVersion.Recent10,
)
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_add_to_review_set.post(request_body)
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 202 Accepted