Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. 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)
SubjectRightsRequest.ReadWrite.All
Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto)
Nicht unterstützt
Nicht unterstützt
Anwendung
Nicht unterstützt
Nicht unterstützt
HTTP-Anforderung
Achtung
Die ANFORDERUNGS-API für Antragstellerrechte unter dem /privacy Knoten ist veraltet und gibt am 30. März 2025 keine Daten mehr zurück. Verwenden Sie den neuen Pfad unter /security.
POST /security/subjectRightsRequests
POST /privacy/subjectRightsRequests
Sammlung von Benutzern, die an der Anforderung zusammenarbeiten können.
contentQuery
Zeichenfolge
KQL-basierte Inhaltsabfrage, die für die Suche verwendet werden soll. Diese Eigenschaft wird nur für APIs definiert, auf die über den \security Abfragepfad und nicht über den \privacy Abfragepfad zugegriffen wird.
Enthält die Eigenschaften für die betroffene Person für die Anforderung.
dataSubjectType
dataSubjectType
Typ der betroffenen Person. Mögliche Werte: customer, currentEmployee, formerEmployee, prospectiveEmployee, student, teacher, faculty, other, unknownFutureValue.
description
Zeichenfolge
Beschreibung für die Anforderung.
displayName
Zeichenfolge
Der Name der Anforderung.
externalId
Zeichenfolge
Die externe ID für die Anforderung, die nach der Erstellung unveränderlich ist und zum Nachverfolgen der Anforderung für das externe System verwendet wird. Diese Eigenschaft wird nur für APIs definiert, auf die über den \security Abfragepfad und nicht über den \privacy Abfragepfad zugegriffen wird.
includeAllVersions
Boolesch
Schließen Sie alle Versionen der Dokumente ein. Standardmäßig werden die aktuellen Kopien der Dokumente zurückgegeben. Wenn für SharePoint-Websites die Versionsverwaltung aktiviert ist, werden unter Einbeziehung aller Versionen automatisch die verlaufsbezogenen Kopien der Dokumente eingeschlossen. Diese Eigenschaft wird nur für APIs definiert, auf die über den \security Abfragepfad und nicht über den \privacy Abfragepfad zugegriffen wird.
includeAuthoredContent
Boolesch
Fügen Sie Inhalte ein, die von der betroffenen Person erstellt wurden. Diese Eigenschaft wird nur für APIs definiert, auf die über den \security Abfragepfad und nicht über den \privacy Abfragepfad zugegriffen wird.
internalDueDateTime
DateTimeOffset
Internes Fälligkeitsdatum, das zum Nachverfolgen des Anforderungsabschlusses verwendet wird.
Die Postfachspeicherorte, die durchsucht werden sollen. Diese Eigenschaft wird nur für APIs definiert, auf die über den \security Abfragepfad und nicht über den \privacy Abfragepfad zugegriffen wird.
pauseAfterEstimate
Boolesch
Halten Sie die Anforderung an, nachdem die Schätzung abgeschlossen ist. Standardmäßig wird die Datenschätzung ausgeführt und dann angehalten, sodass Sie eine Vorschau der Ergebnisse anzeigen und dann die Option zum Abrufen von Daten in der Benutzeroberfläche auswählen können. Sie können diese Eigenschaft auf false festlegen, wenn sie die Schätzung durchführen und dann automatisch mit dem Abrufen des Inhalts beginnen soll. Diese Eigenschaft wird nur für APIs definiert, auf die über den \security Abfragepfad und nicht über den \privacy Abfragepfad zugegriffen wird.
Vorschriften
String collection
Eine oder mehrere Vorschriften für die Anforderung.
Die SharePoint- und OneDrive-Websitespeicherorte, die durchsucht werden sollten. Diese Eigenschaft wird nur für APIs definiert, auf die über den \security Abfragepfad und nicht über den \privacy Abfragepfad zugegriffen wird.
type
subjectRightsRequestType
Typ der Anforderung. Mögliche Werte: export, access, delete, tagForAction, unknownFutureValue.
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein subjectRightsRequest-Objekt im Antworttext zurück.
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new SubjectRightsRequest
{
Type = SubjectRightsRequestType.Export,
ContentQuery = "((\"Diego Siciliani\" OR \"Diego.Siciliani@contoso.com\") OR (participants:\"Diego.Siciliani@contoso.com\"))",
DataSubjectType = DataSubjectType.Customer,
ExternalId = "F53BF2DA-607D-412A-B568-FAA0F023AC0B",
DisplayName = "Export report for customer Id: 12345",
Description = "This is a export request",
IncludeAllVersions = false,
IncludeAuthoredContent = true,
InternalDueDateTime = DateTimeOffset.Parse("2022-07-20T22:42:28Z"),
DataSubject = new DataSubject
{
FirstName = "Diego",
LastName = "Siciliani",
Email = "Diego.Siciliani@contoso.com",
Residency = "USA",
},
MailboxLocations = null,
PauseAfterEstimate = true,
Regulations = new List<string>
{
"CCPA",
},
SiteLocations = new SubjectRightsRequestAllSiteLocation
{
OdataType = "microsoft.graph.subjectRightsRequestAllSiteLocation",
},
Approvers = new List<User>
{
new User
{
Id = "1B761ED2-AA7E-4D82-9CF5-C09D737B6167",
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Privacy.SubjectRightsRequests.PostAsync(requestBody);
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
SubjectRightsRequest subjectRightsRequest = new SubjectRightsRequest();
subjectRightsRequest.setType(SubjectRightsRequestType.Export);
subjectRightsRequest.setContentQuery("((\"Diego Siciliani\" OR \"Diego.Siciliani@contoso.com\") OR (participants:\"Diego.Siciliani@contoso.com\"))");
subjectRightsRequest.setDataSubjectType(DataSubjectType.Customer);
subjectRightsRequest.setExternalId("F53BF2DA-607D-412A-B568-FAA0F023AC0B");
subjectRightsRequest.setDisplayName("Export report for customer Id: 12345");
subjectRightsRequest.setDescription("This is a export request");
subjectRightsRequest.setIncludeAllVersions(false);
subjectRightsRequest.setIncludeAuthoredContent(true);
OffsetDateTime internalDueDateTime = OffsetDateTime.parse("2022-07-20T22:42:28Z");
subjectRightsRequest.setInternalDueDateTime(internalDueDateTime);
DataSubject dataSubject = new DataSubject();
dataSubject.setFirstName("Diego");
dataSubject.setLastName("Siciliani");
dataSubject.setEmail("Diego.Siciliani@contoso.com");
dataSubject.setResidency("USA");
subjectRightsRequest.setDataSubject(dataSubject);
subjectRightsRequest.setMailboxLocations(null);
subjectRightsRequest.setPauseAfterEstimate(true);
LinkedList<String> regulations = new LinkedList<String>();
regulations.add("CCPA");
subjectRightsRequest.setRegulations(regulations);
SubjectRightsRequestAllSiteLocation siteLocations = new SubjectRightsRequestAllSiteLocation();
siteLocations.setOdataType("microsoft.graph.subjectRightsRequestAllSiteLocation");
subjectRightsRequest.setSiteLocations(siteLocations);
LinkedList<User> approvers = new LinkedList<User>();
User user = new User();
user.setId("1B761ED2-AA7E-4D82-9CF5-C09D737B6167");
approvers.add(user);
subjectRightsRequest.setApprovers(approvers);
SubjectRightsRequest result = graphClient.privacy().subjectRightsRequests().post(subjectRightsRequest);
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\SubjectRightsRequest;
use Microsoft\Graph\Generated\Models\SubjectRightsRequestType;
use Microsoft\Graph\Generated\Models\DataSubjectType;
use Microsoft\Graph\Generated\Models\DataSubject;
use Microsoft\Graph\Generated\Models\SubjectRightsRequestAllSiteLocation;
use Microsoft\Graph\Generated\Models\User;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new SubjectRightsRequest();
$requestBody->setType(new SubjectRightsRequestType('export'));
$requestBody->setContentQuery('((\"Diego Siciliani\" OR \"Diego.Siciliani@contoso.com\") OR (participants:\"Diego.Siciliani@contoso.com\"))');
$requestBody->setDataSubjectType(new DataSubjectType('customer'));
$requestBody->setExternalId('F53BF2DA-607D-412A-B568-FAA0F023AC0B');
$requestBody->setDisplayName('Export report for customer Id: 12345');
$requestBody->setDescription('This is a export request');
$requestBody->setIncludeAllVersions(false);
$requestBody->setIncludeAuthoredContent(true);
$requestBody->setInternalDueDateTime(new \DateTime('2022-07-20T22:42:28Z'));
$dataSubject = new DataSubject();
$dataSubject->setFirstName('Diego');
$dataSubject->setLastName('Siciliani');
$dataSubject->setEmail('Diego.Siciliani@contoso.com');
$dataSubject->setResidency('USA');
$requestBody->setDataSubject($dataSubject);
$requestBody->setMailboxLocations(null);
$requestBody->setPauseAfterEstimate(true);
$requestBody->setRegulations(['CCPA', ]);
$siteLocations = new SubjectRightsRequestAllSiteLocation();
$siteLocations->setOdataType('microsoft.graph.subjectRightsRequestAllSiteLocation');
$requestBody->setSiteLocations($siteLocations);
$approversUser1 = new User();
$approversUser1->setId('1B761ED2-AA7E-4D82-9CF5-C09D737B6167');
$approversArray []= $approversUser1;
$requestBody->setApprovers($approversArray);
$result = $graphServiceClient->privacy()->subjectRightsRequests()->post($requestBody)->wait();