Feedback Bearbeiten

SourceCollection erstellen

  • Artikel
  • 4 Minuten Lesedauer

Namespace: microsoft.graph.ediscovery

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Erstellen Sie ein neues sourceCollection-Objekt.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) eDiscovery.Read.All, eDiscovery.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Anwendung Nicht unterstützt

HTTP-Anforderung

POST /compliance/ediscovery/cases/{caseId}/sourceCollections

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des sourceCollection-Objekts an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie eine SourceCollectionerstellen.

Eigenschaft Typ Beschreibung
dataSourceScopes microsoft.graph.ediscovery.dataSourceScopes Wenn angegeben, erstreckt sich die Auflistung über einen Dienst für eine gesamte Workload. Mögliche Werte sind: none , , , , allTenantMailboxes allTenantSites allCaseCustodians allCaseNoncustodialDataSources . Hinweis: Beim Erstellen einer Quellsammlung ist entweder ein Verwahrer oder die Angabe von dataSourceScope erforderlich.
displayName Zeichenfolge Der Anzeigename der sourceCollection
custodianSources microsoft.graph.ediscovery.dataSource-Sammlung Die Verwahrerquellen, die in diese Suche einbezogen werden sollen. Sie können die URL von verwahrten siteSources, unifiedGroupSourcesoder userSources sowie der ID der Quelle abrufen. Hinweis: Beim Erstellen einer Quellsammlung ist entweder ein Verwahrer oder eine Mandantenquelle erforderlich.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den Antwortcode und ein Objekt des Typ 201 Created "microsoft.graph.ediscovery.sourceCollection" im Antworttext zurück.

Beispiele

Anforderung

POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/sourceCollections
Content-Type: application/json

{
    "displayName": "Quarterly Financials search",
    "contentQuery": "subject:'Quarterly Financials'",
    "custodianSources@odata.bind": [
        "https://graph.microsoft.com/beta/compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/custodians/2192ca408ea2410eba3bec8ae873be6b/userSources/46384443-4137-3032-3437-363939433735"
    ]
}

Antwort

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 201 Created
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#compliance/ediscovery/cases/47746044-fd0b-4a30-acfc-5272b691ba5b/sourceCollections/$entity",
    "description": null,
    "lastModifiedDateTime": "2021-01-12T18:09:03.7378679Z",
    "contentQuery": "subject:'Quarterly Financials'",
    "dataSourceScopes": "none",
    "id": "1a9b4145d8f84e39bc45a7f68c5c5119",
    "displayName": "Quarterly Financials search",
    "createdDateTime": "2021-01-12T18:09:03.417009Z",
    "createdBy": {
        "user": {
            "id": "c1db6f13-332a-4d84-b111-914383ff9fc9",
            "displayName": "EDisco Admin",
            "userPrincipalname": "admin@contoso.com"
        }
    },
    "lastModifiedBy": {
        "user": {
            "id": "c1db6f13-332a-4d84-b111-914383ff9fc9",
            "displayName": "EDisco Admin",
            "userPrincipalname": "admin@contoso.com"
        }
    }
}