Partager via

ediscoverySearch : exportReport

  • 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 un rapport d’élément à partir 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}/exportReport
POST /security/cases/ediscoveryCases('{ediscoveryCaseId}')/searches('{ediscoverySearchId}')/exportReport

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 rapport d’exportation.
displayName Chaîne Nom complet du rapport d’exportation.
exportCriteria microsoft.graph.security.exportCriteria Partie du rapport d’estimation à exporter. Les valeurs possibles sont searchHits, partiallyIndexed, 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 un rapport d’éléments avec des résultats de recherche uniquement, à l’exclusion des éléments partiellement indexés, sans options supplémentaires

L’exemple suivant montre comment exporter un rapport d’éléments avec des résultats de recherche uniquement, à l’exception des éléments partiellement indexés, sans aucune option supplémentaire sélectionnée.

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'/exportReport
Content-Type: application/json

{
  "displayName": "Export 1",
  "exportCriteria": "searchHits",
  "additionalOptions": "none"
}

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('f57fc79d-bea8-42ac-b0be-217302d5683c')

Exemple 2 : Exporter un rapport d’éléments avec des résultats de recherche et des éléments partiellement indexés dans tous les emplacements ciblés, sans options supplémentaires

Les exemples suivants montrent comment exporter un rapport d’éléments avec des résultats de recherche et des éléments partiellement indexés dans tous les emplacements ciblés, sans aucune option supplémentaire sélectionnée.

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'/exportReport
Content-Type: application/json

{
  "displayName": "Export 2",
  "exportCriteria": "searchHits, partiallyIndexed",
  "exportLocation": "responsiveLocations, nonresponsiveLocations",
  "additionalOptions": "none"
}

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('cbcb4807-e76e-4ef0-bd5b-e2177c13f07e')

Exemple 3 : Exporter un rapport d’éléments avec des résultats de recherche et des éléments partiellement indexés dans des emplacements avec des résultats de recherche, sans options supplémentaires

L’exemple suivant montre comment exporter un rapport d’éléments 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.

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'/exportReport
Content-Type: application/json

{
  "displayName": "Export 3",
  "exportCriteria": "searchHits, partiallyIndexed",
  "exportLocation": "responsiveLocations",
  "additionalOptions": "none"
}

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('c56f66de-b780-4efc-aa0c-4ef3271ad6b4')

Exemple 4 : Exporter un rapport d’éléments partiellement indexés dans tous les emplacements ciblés avec toutes les options supplémentaires sélectionnées

L’exemple suivant montre comment exporter un rapport d’éléments partiellement indexés dans tous les emplacements ciblés avec toutes les options supplémentaires sélectionnées.

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'/exportReport
Content-Type: application/json

{
  "displayName": "Export 4",
  "exportCriteria": "partiallyIndexed",
  "exportLocation": "responsiveLocations, nonresponsiveLocations",
  "additionalOptions": "teamsAndYammerConversations, cloudAttachments, allDocumentVersions, subfolderContents, listAttachments"
}

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('572d44e2-5e77-4443-a2ed-cd036bdc0304')

Exemple 5 : Exporter un rapport d’éléments partiellement indexés dans des emplacements avec des résultats de recherche et des pièces jointes cloud

L’exemple suivant montre comment exporter un rapport d’éléments partiellement indexés dans des emplacements avec des correspondances de recherche et des pièces jointes cloud.

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'/exportReport
Content-Type: application/json

{
  "displayName": "Export 5",
  "exportCriteria": "partiallyIndexed",
  "exportLocation": "responsiveLocations",
  "additionalOptions": "cloudAttachments"
}

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('788159f9-f860-43f2-8fc5-0fc17df0e696')