Espace de noms : microsoft.graph.security
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Démarrez le processus d’ajout d’une collection à partir des services Microsoft 365 à un jeu de révision. Une fois l’opération créée, vous pouvez obtenir la status de l’opération en récupérant le Location paramètre à partir des en-têtes de réponse. L’emplacement fournit une URL qui retourne une opération Ajouter pour examiner le jeu.
Cette API est disponible dans les déploiements de cloud national suivants.
| Service global |
Gouvernement des États-Unis L4 |
Us Government L5 (DOD) |
Chine gérée par 21Vianet |
| ✅ |
✅ |
✅ |
❌ |
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
| Type d’autorisation |
Autorisations avec privilèges minimum |
Autorisations privilégiées plus élevées |
| Déléguée (compte professionnel ou scolaire) |
eDiscovery.Read.All |
eDiscovery.ReadWrite.All |
| Déléguée (compte Microsoft personnel) |
Non prise en charge. |
Non prise en charge. |
| Application |
eDiscovery.Read.All |
eDiscovery.ReadWrite.All |
Importante
Pour l’accès délégué à l’aide de comptes professionnels ou scolaires, l’utilisateur connecté doit se voir attribuer un rôle Microsoft Purview pris en charge via l’une des options suivantes :
-
Gestionnaire eDiscovery. Permet aux membres d’accéder aux jeux de révision dans les cas eDiscovery dont ils créent et sont membres.
Il s’agit de l’option la moins privilégiée pour accéder aux jeux de révision dans leurs propres cas.
-
L’administrateur eDiscovery. Fournit toutes les autorisations d’eDiscovery Manager, ainsi que la possibilité d’accéder aux jeux de révision dans tous les cas eDiscovery dans le organization.
-
Réviseur. Fournit un accès en lecture seule aux jeux de révision dans les cas eDiscovery où l’utilisateur est membre. Les réviseurs peuvent afficher et étiqueter des documents, mais ils ne peuvent pas effectuer d’autres tâches de gestion de cas.
Le rôle De révision permet aux utilisateurs d’accéder aux jeux de révision dans les cas dont ils sont membres. Les utilisateurs peuvent afficher et étiqueter des documents dans des ensembles de révision, mais ils ne peuvent pas afficher d’aperçu des résultats de recherche ou effectuer d’autres tâches de recherche ou de gestion de cas.
Pour plus d’informations sur les autorisations et les rôles eDiscovery, consultez Attribuer des autorisations dans eDiscovery.
Requête HTTP
POST /security/cases/ediscoveryCases/{eDiscoveryCaseId}/reviewSets/{eDiscoveryReviewSetId}/addToReviewSet
Corps de la demande
Dans le corps de la demande, fournissez une représentation JSON des paramètres.
Le tableau suivant indique les paramètres utilisables avec cette action.
| Paramètre |
Type |
Description |
| additionalDataOptions |
microsoft.graph.security.additionalDataOptions |
Options permettant d’ajouter des éléments au jeu de révision. Les valeurs possibles sont , allVersions, linkedFiles, unknownFutureValueadvancedIndexing, listAttachments, htmlTranscripts, messageConversationExpansion, , locationsWithoutHits, , allItemsInFolder. Utilisez l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes de cette énumération évolutive : advancedIndexing, listAttachments, htmlTranscripts, messageConversationExpansion, locationsWithoutHitsallItemsInFolder. Les locationsWithoutHits valeurs et advancedIndexing ne sont prises en compte que si itemsToIncude a la valeur partiallyIndexed. |
| cloudAttachmentVersion |
microsoft.graph.security.cloudAttachmentVersion |
Spécifie le nombre de versions de pièces jointes cloud à collecter. Les valeurs possibles sont : latest, recent10, recent100, all, unknownFutureValue. La valeur par défaut est latest. |
| documentVersion |
microsoft.graph.security.documentVersion |
Spécifie le nombre de versions de document à collecter. Les valeurs possibles sont : latest, recent10, recent100, all, unknownFutureValue. La valeur par défaut est latest. |
| itemsToInclude |
microsoft.graph.security.itemsToInclude |
Éléments à inclure dans l’ensemble de révision. Les valeurs possibles sont searchHits, partiallyIndexed, unknownFutureValue. |
| recherche |
microsoft.graph.security.ediscoverySearch |
ID de la recherche eDiscovery que vous souhaitez ajouter à l’ensemble de révisions. |
Réponse
Si elle réussit, cette action renvoie un code de réponse 202 Accepted.
Exemples
Exemple 1 : Ajouter une recherche avec des fichiers liés et la dernière version de pièce jointe cloud
L’exemple suivant montre comment ajouter la recherche à l’ensemble de révision et inclure la dernière version des fichiers partagés sous forme de liens.
Demande
L’exemple suivant illustre une demande.
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)
Réponse
L’exemple suivant illustre la réponse.
HTTP/1.1 202 Accepted
Exemple 2 : Ajouter une recherche avec toutes les options de données et les dernières versions cloud et de document
L’exemple suivant montre comment ajouter la recherche à l’ensemble de révisions avec toutes les options sélectionnées pour additionalDataOptions, les 10 versions les plus récentes sélectionnées pour les documents et la dernière version sélectionnée pour les pièces jointes cloud.
Demande
L’exemple suivant illustre une demande.
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)
Réponse
L’exemple suivant illustre la réponse.
HTTP/1.1 202 Accepted