Partager via

ediscoverySearch : exportResult

  • Article

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 .

Exporter les résultats d’une ediscoverySearch estimée. Pour plus d’informations, consultez Gérer une estimation de collection.

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 Non prise en charge. Non prise en charge.

Requête HTTP

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

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Content-Type application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON des paramètres.

Le tableau suivant répertorie les paramètres que vous pouvez utiliser avec cette action.

Paramètre Type Description
additionalOptions microsoft.graph.security.additionalOptions Options supplémentaires pour l’exportation. Les valeurs possibles sont none, teamsAndYammerConversations, cloudAttachments, allDocumentVersions, subfolderContents, listAttachments, unknownFutureValue. Obligatoire.
description Chaîne Description du résultat de l’exportation.
displayName Chaîne Nom complet du résultat de l’exportation.
exportCriteria microsoft.graph.security.exportCriteria Partie des résultats de l’estimation à exporter. Les valeurs possibles sont searchHits, partiallyIndexed, unknownFutureValue. Obligatoire.
exportFormat microsoft.graph.security.exportFormat Format souhaité des e-mails exportés. Les valeurs possibles sont : pst, msg, eml, unknownFutureValue. Obligatoire.
exportLocation microsoft.graph.security.exportLocation Étendue d’emplacement pour les éléments partiellement indexés. Vous pouvez choisir d’inclure des éléments partiellement indexés uniquement dans des emplacements réactifs avec des résultats de recherche ou dans tous les emplacements ciblés. Les valeurs possibles sont responsiveLocations, nonresponsiveLocations, unknownFutureValue.

Réponse

Si l’exportation a démarré avec succès, cette action retourne un 202 Accepted code de réponse. La réponse contient également un Location en-tête qui inclut l’emplacement de microsoft.graph.security.ediscoverySearchExportOperation qui a été créé pour gérer l’exportation. Pour case activée le status de l’opération d’exportation, effectuez une requête GET à l’URL d’emplacement.

Exemples

Exemple 1 : Exporter les résultats avec des résultats de recherche uniquement, à l’exclusion des éléments partiellement indexés, sans option supplémentaire, sous forme de fichiers .pst pour chaque boîte aux lettres

L’exemple suivant montre comment exporter les résultats avec des résultats de recherche uniquement, à l’exception des éléments partiellement indexés, sans aucune option supplémentaire sélectionnée, sous forme de fichiers .pst pour chaque boîte aux lettres.

Demande

L’exemple suivant illustre une demande.

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"
}

Réponse

L’exemple suivant illustre la réponse.

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')

Exemple 2 : Exporter les résultats avec des résultats de recherche et des éléments partiellement indexés dans tous les emplacements, sans options supplémentaires, sous forme de fichiers .pst pour chaque boîte aux lettres.

L’exemple suivant montre comment exporter des résultats avec des résultats de recherche et des éléments partiellement indexés dans tous les emplacements, sans aucune option supplémentaire sélectionnée, sous forme de fichiers .pst pour chaque boîte aux lettres.

Demande

L’exemple suivant illustre une demande.

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"
}

Réponse

L’exemple suivant illustre la réponse.

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')

Exemple 3 : Exporter les résultats avec des résultats de recherche et des éléments partiellement indexés dans des emplacements avec des correspondances de recherche, sans options supplémentaires, en tant que fichiers .msg pour chaque message

L’exemple suivant montre comment exporter des résultats avec des résultats de recherche et des éléments partiellement indexés dans des emplacements avec des résultats de recherche, sans aucune option supplémentaire sélectionnée, comme .msg des fichiers pour chaque message.

Demande

L’exemple suivant illustre une demande.

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"
}

Réponse

L’exemple suivant illustre la réponse.

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')

Exemple 4 : Exporter des résultats avec des éléments partiellement indexés dans tous les emplacements ciblés, avec toutes les options supplémentaires, en tant que fichiers .eml pour chaque message

L’exemple suivant montre comment exporter des résultats avec des éléments partiellement indexés dans tous les emplacements ciblés, avec toutes les options supplémentaires sélectionnées, en tant que fichiers .eml pour chaque message.

Demande

L’exemple suivant illustre une demande.

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"
}

Réponse

L’exemple suivant illustre la réponse.

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')

Exemple 5 : Exporter des résultats avec des éléments partiellement indexés dans des emplacements d’accès de recherche, avec des pièces jointes cloud, en tant que fichiers .eml pour chaque message

L’exemple suivant montre comment exporter des résultats avec des éléments partiellement indexés dans des emplacements d’accès de recherche, avec des pièces jointes cloud, en tant que fichiers .eml pour chaque message.

Demande

L’exemple suivant illustre une demande.

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"
}

Réponse

L’exemple suivant illustre la réponse.

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')