Namespace: microsoft.graph.ediscovery
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Erstellen Sie ein neues NoncustodialDataSource-Objekt .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service |
US Government L4 |
US Government L5 (DOD) |
China, betrieben von 21Vianet |
| ✅ |
❌ |
❌ |
❌ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
| Berechtigungstyp |
Berechtigungen mit den geringsten Berechtigungen |
Berechtigungen mit höheren Berechtigungen |
| Delegiert (Geschäfts-, Schul- oder Unikonto) |
eDiscovery.Read.All |
eDiscovery.ReadWrite.All |
| Delegiert (persönliches Microsoft-Konto) |
Nicht unterstützt |
Nicht unterstützt |
| Application |
eDiscovery.Read.All |
eDiscovery.ReadWrite.All |
HTTP-Anforderung
POST /compliance/ediscovery/cases/{caseId}/noncustodialDataSources
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung des NoncustodialDataSource-Objekts an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen der NonCustodialDataSource erforderlich sind.
| Eigenschaft |
Typ |
Beschreibung |
| applyHoldToSource |
Boolean |
Gibt an, ob eine nicht verwahrte Datenquelle (z. B. ein Postfach oder eine Website) gesperrt ist. |
| datasource |
microsoft.graph.ediscovery.dataSource |
Entweder eine userSource oder siteSource. Verwenden Sie für userSource "dataSource": { "@odata.type": "microsoft.graph.ediscovery.userSource", "email": "SMTP address"}. Verwenden Sie für die Websitequelle "dataSource": { "@odata.type": "microsoft.graph.ediscovery.siteSource", "site@odata.bind" : "siteId" }, wobei siteId aus der Website-URL abgeleitet werden kann, https://contoso.sharepoint.com/sites/HumanResourcesz. B. wäre https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/HumanResourcesdie Microsoft Graph-Anforderung . Die ID ist die erste GUID, die im Feld "ID" aufgeführt ist. |
Antwort
Bei erfolgreicher Ausführung gibt diese Methode einen 201 Created Antwortcode und ein NoncustodialDataSource-Objekt im Antworttext zurück.
Beispiele
Beispiel 1: Hinzufügen eines nicht verwahrten Datenquellenbenutzer- oder Gruppenpostfachs mit einer E-Mail
Anforderung
POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/5b840b94-f821-4c4a-8cad-3a90062bf51a/noncustodialDataSources
Content-Type: application/json
{
"applyHoldToSource" : true,
"dataSource" : {
"@odata.type" : "microsoft.graph.ediscovery.userSource",
"email" : "adelev@contoso.com"
}
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models.Ediscovery;
var requestBody = new NoncustodialDataSource
{
ApplyHoldToSource = true,
DataSource = new UserSource
{
OdataType = "microsoft.graph.ediscovery.userSource",
Email = "adelev@contoso.com",
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Compliance.Ediscovery.Cases["{case-id}"].NoncustodialDataSources.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"
graphmodelsediscovery "github.com/microsoftgraph/msgraph-beta-sdk-go/models/ediscovery"
//other-imports
)
requestBody := graphmodelsediscovery.NewNoncustodialDataSource()
applyHoldToSource := true
requestBody.SetApplyHoldToSource(&applyHoldToSource)
dataSource := graphmodelsediscovery.NewUserSource()
email := "adelev@contoso.com"
dataSource.SetEmail(&email)
requestBody.SetDataSource(dataSource)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
noncustodialDataSources, err := graphClient.Compliance().Ediscovery().Cases().ByCaseId("case-id").NoncustodialDataSources().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.models.ediscovery.NoncustodialDataSource noncustodialDataSource = new com.microsoft.graph.beta.models.ediscovery.NoncustodialDataSource();
noncustodialDataSource.setApplyHoldToSource(true);
com.microsoft.graph.beta.models.ediscovery.UserSource dataSource = new com.microsoft.graph.beta.models.ediscovery.UserSource();
dataSource.setOdataType("microsoft.graph.ediscovery.userSource");
dataSource.setEmail("adelev@contoso.com");
noncustodialDataSource.setDataSource(dataSource);
com.microsoft.graph.models.ediscovery.NoncustodialDataSource result = graphClient.compliance().ediscovery().cases().byCaseId("{case-id}").noncustodialDataSources().post(noncustodialDataSource);
const options = {
authProvider,
};
const client = Client.init(options);
const noncustodialDataSource = {
applyHoldToSource: true,
dataSource: {
'@odata.type': 'microsoft.graph.ediscovery.userSource',
email: 'adelev@contoso.com'
}
};
await client.api('/compliance/ediscovery/cases/5b840b94-f821-4c4a-8cad-3a90062bf51a/noncustodialDataSources')
.version('beta')
.post(noncustodialDataSource);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\Ediscovery\NoncustodialDataSource;
use Microsoft\Graph\Beta\Generated\Models\Ediscovery\UserSource;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new NoncustodialDataSource();
$requestBody->setApplyHoldToSource(true);
$dataSource = new UserSource();
$dataSource->setOdataType('microsoft.graph.ediscovery.userSource');
$dataSource->setEmail('adelev@contoso.com');
$requestBody->setDataSource($dataSource);
$result = $graphServiceClient->compliance()->ediscovery()->cases()->byCaseId('case-id')->noncustodialDataSources()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Compliance
$params = @{
applyHoldToSource = $true
dataSource = @{
"@odata.type" = "microsoft.graph.ediscovery.userSource"
email = "adelev@contoso.com"
}
}
New-MgBetaComplianceEdiscoveryCaseNoncustodialDataSource -CaseId $caseId -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.models.ediscovery.noncustodial_data_source import NoncustodialDataSource
from msgraph_beta.generated.models.ediscovery.user_source import UserSource
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = NoncustodialDataSource(
apply_hold_to_source = True,
data_source = UserSource(
odata_type = "microsoft.graph.ediscovery.userSource",
email = "adelev@contoso.com",
),
)
result = await graph_client.compliance.ediscovery.cases.by_case_id('case-id').noncustodial_data_sources.post(request_body)
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('5b840b94-f821-4c4a-8cad-3a90062bf51a')/noncustodialDataSources/$entity",
"status": "0",
"lastModifiedDateTime": "2021-02-19T07:02:45.7732516Z",
"releasedDateTime": "0001-01-01T00:00:00Z",
"id": "39374346363831303741353341373443",
"displayName": null,
"createdDateTime": "2021-02-19T07:02:45.4863718Z",
"applyHoldToSource": true
}
Beispiel 2: Hinzufügen einer nicht verwahrten Datenquellenwebsite mit einer URL
Anforderung
POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/15d80234-8320-4f10-96d0-d98d53ffdfc9/noncustodialdatasources
Content-Type: application/json
{
"applyHoldToSource": false,
"dataSource": {
"@odata.type": "microsoft.graph.ediscovery.siteSource",
"site": {
"webUrl": "https://contoso.sharepoint.com/sites/SecretSite"
}
}
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models.Ediscovery;
using Microsoft.Graph.Beta.Models;
var requestBody = new NoncustodialDataSource
{
ApplyHoldToSource = false,
DataSource = new SiteSource
{
OdataType = "microsoft.graph.ediscovery.siteSource",
Site = new Site
{
WebUrl = "https://contoso.sharepoint.com/sites/SecretSite",
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Compliance.Ediscovery.Cases["{case-id}"].NoncustodialDataSources.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"
graphmodelsediscovery "github.com/microsoftgraph/msgraph-beta-sdk-go/models/ediscovery"
graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
//other-imports
)
requestBody := graphmodelsediscovery.NewNoncustodialDataSource()
applyHoldToSource := false
requestBody.SetApplyHoldToSource(&applyHoldToSource)
dataSource := graphmodelsediscovery.NewSiteSource()
site := graphmodels.NewSite()
webUrl := "https://contoso.sharepoint.com/sites/SecretSite"
site.SetWebUrl(&webUrl)
dataSource.SetSite(site)
requestBody.SetDataSource(dataSource)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
noncustodialDataSources, err := graphClient.Compliance().Ediscovery().Cases().ByCaseId("case-id").NoncustodialDataSources().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.models.ediscovery.NoncustodialDataSource noncustodialDataSource = new com.microsoft.graph.beta.models.ediscovery.NoncustodialDataSource();
noncustodialDataSource.setApplyHoldToSource(false);
com.microsoft.graph.beta.models.ediscovery.SiteSource dataSource = new com.microsoft.graph.beta.models.ediscovery.SiteSource();
dataSource.setOdataType("microsoft.graph.ediscovery.siteSource");
Site site = new Site();
site.setWebUrl("https://contoso.sharepoint.com/sites/SecretSite");
dataSource.setSite(site);
noncustodialDataSource.setDataSource(dataSource);
com.microsoft.graph.models.ediscovery.NoncustodialDataSource result = graphClient.compliance().ediscovery().cases().byCaseId("{case-id}").noncustodialDataSources().post(noncustodialDataSource);
const options = {
authProvider,
};
const client = Client.init(options);
const noncustodialDataSource = {
applyHoldToSource: false,
dataSource: {
'@odata.type': 'microsoft.graph.ediscovery.siteSource',
site: {
webUrl: 'https://contoso.sharepoint.com/sites/SecretSite'
}
}
};
await client.api('/compliance/ediscovery/cases/15d80234-8320-4f10-96d0-d98d53ffdfc9/noncustodialdatasources')
.version('beta')
.post(noncustodialDataSource);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\Ediscovery\NoncustodialDataSource;
use Microsoft\Graph\Beta\Generated\Models\Ediscovery\SiteSource;
use Microsoft\Graph\Beta\Generated\Models\Site;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new NoncustodialDataSource();
$requestBody->setApplyHoldToSource(false);
$dataSource = new SiteSource();
$dataSource->setOdataType('microsoft.graph.ediscovery.siteSource');
$dataSourceSite = new Site();
$dataSourceSite->setWebUrl('https://contoso.sharepoint.com/sites/SecretSite');
$dataSource->setSite($dataSourceSite);
$requestBody->setDataSource($dataSource);
$result = $graphServiceClient->compliance()->ediscovery()->cases()->byCaseId('case-id')->noncustodialDataSources()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Compliance
$params = @{
applyHoldToSource = $false
dataSource = @{
"@odata.type" = "microsoft.graph.ediscovery.siteSource"
site = @{
webUrl = "https://contoso.sharepoint.com/sites/SecretSite"
}
}
}
New-MgBetaComplianceEdiscoveryCaseNoncustodialDataSource -CaseId $caseId -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.models.ediscovery.noncustodial_data_source import NoncustodialDataSource
from msgraph_beta.generated.models.ediscovery.site_source import SiteSource
from msgraph_beta.generated.models.site import Site
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = NoncustodialDataSource(
apply_hold_to_source = False,
data_source = SiteSource(
odata_type = "microsoft.graph.ediscovery.siteSource",
site = Site(
web_url = "https://contoso.sharepoint.com/sites/SecretSite",
),
),
)
result = await graph_client.compliance.ediscovery.cases.by_case_id('case-id').noncustodial_data_sources.post(request_body)
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('15d80234-8320-4f10-96d0-d98d53ffdfc9')/noncustodialDataSources/$entity",
"status": "Active",
"lastModifiedDateTime": "2021-08-11T22:43:45.1079425Z",
"releasedDateTime": "0001-01-01T00:00:00Z",
"id": "35393843394546413031353146334134",
"displayName": "Secret Site",
"createdDateTime": "2021-08-11T22:43:45.0189955Z",
"applyHoldToSource": false
}