subjectRightsRequest erstellen

Namespace: microsoft.graph

Erstellen sie ein neues subjectRightsRequest-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)	SubjectRightsRequest.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	Nicht unterstützt

HTTP-Anforderung

POST /privacy/subjectRightsRequests

Anforderungsheader

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

Anforderungstext

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

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie ein Objekt des Typ subjectRightsRequesterstellen.

Eigenschaft	Typ	Beschreibung
dataSubject	microsoft.graph.dataSubject	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	String	Beschreibung der Anforderung.
displayName	Zeichenfolge	Name der Anforderung.
internalDueDateTime	DateTimeOffset	Internes Fälligkeitsdatum, das zum Nachverfolgen des Anforderungsabschlusses verwendet wird.
Vorschriften	String-Sammlung	Eine oder mehrere Bestimmungen für die Anforderung.
type	subjectRightsRequestType	Typ der Anforderung. Mögliche Werte: export, delete, access, tagForAction, unknownFutureValue.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein subjectRightsRequest-Objekt im Antworttext zurück.

Beispiele

Anforderung

HTTP

POST https://graph.microsoft.com/v1.0/privacy/subjectRightsRequests
Content-Type: application/json

{
    "type": "microsoft.graph.subjectRightsRequestType",
    "dataSubjectType": "microsoft.graph.dataSubjectType",
    "regulations": ["String"],
    "displayName": "String",
    "description": "String",
    "internalDueDateTime": "String (timestamp)",
    "dataSubject": {
        "firstName": "String",
        "lastName": "String",
        "email": "String",
        "residency": "String",
        "phoneNumber": "String",
        "SSN": "String"
    }
}

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var subjectRightsRequest = new SubjectRightsRequestObject
{
    Type = SubjectRightsRequestType.Export,
    DataSubjectType = DataSubjectType.Customer,
    Regulations = new List<String>()
    {
        "String"
    },
    DisplayName = "String",
    Description = "String",
    InternalDueDateTime = DateTimeOffset.Parse("String (timestamp)"),
    DataSubject = new DataSubject
    {
        FirstName = "String",
        LastName = "String",
        Email = "String",
        Residency = "String",
        AdditionalData = new Dictionary<string, object>()
        {
            {"phoneNumber", "String"},
            {"SSN", "String"}
        }
    }
};

await graphClient.Privacy.SubjectRightsRequests
    .Request()
    .AddAsync(subjectRightsRequest);

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

const subjectRightsRequest = {
    type: 'microsoft.graph.subjectRightsRequestType',
    dataSubjectType: 'microsoft.graph.dataSubjectType',
    regulations: ['String'],
    displayName: 'String',
    description: 'String',
    internalDueDateTime: 'String (timestamp)',
    dataSubject: {
        firstName: 'String',
        lastName: 'String',
        email: 'String',
        residency: 'String',
        phoneNumber: 'String',
        SSN: 'String'
    }
};

await client.api('/privacy/subjectRightsRequests')
    .post(subjectRightsRequest);

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

Objective-C

MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/v1.0/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/privacy/subjectRightsRequests"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphSubjectRightsRequest *subjectRightsRequest = [[MSGraphSubjectRightsRequest alloc] init];
[subjectRightsRequest setType: [MSGraphSubjectRightsRequestType export]];
[subjectRightsRequest setDataSubjectType: [MSGraphDataSubjectType customer]];
NSMutableArray *regulationsList = [[NSMutableArray alloc] init];
[regulationsList addObject: @"String"];
[subjectRightsRequest setRegulations:regulationsList];
[subjectRightsRequest setDisplayName:@"String"];
[subjectRightsRequest setDescription:@"String"];
[subjectRightsRequest setInternalDueDateTime:@"String (timestamp)"];
MSGraphDataSubject *dataSubject = [[MSGraphDataSubject alloc] init];
[dataSubject setFirstName:@"String"];
[dataSubject setLastName:@"String"];
[dataSubject setEmail:@"String"];
[dataSubject setResidency:@"String"];
[dataSubject setPhoneNumber:@"String"];
[dataSubject setSSN:@"String"];
[subjectRightsRequest setDataSubject:dataSubject];

NSError *error;
NSData *subjectRightsRequestData = [subjectRightsRequest getSerializedDataWithError:&error];
[urlRequest setHTTPBody:subjectRightsRequestData];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

Go

//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.NewSubjectRightsRequest()
type := "microsoft.graph.subjectRightsRequestType"
requestBody.SetType(&type)
dataSubjectType := "microsoft.graph.dataSubjectType"
requestBody.SetDataSubjectType(&dataSubjectType)
requestBody.SetRegulations( []String {
    "String",
}
displayName := "String"
requestBody.SetDisplayName(&displayName)
description := "String"
requestBody.SetDescription(&description)
internalDueDateTime, err := time.Parse(time.RFC3339, "String (timestamp)")
requestBody.SetInternalDueDateTime(&internalDueDateTime)
dataSubject := msgraphsdk.NewDataSubject()
requestBody.SetDataSubject(dataSubject)
firstName := "String"
dataSubject.SetFirstName(&firstName)
lastName := "String"
dataSubject.SetLastName(&lastName)
email := "String"
dataSubject.SetEmail(&email)
residency := "String"
dataSubject.SetResidency(&residency)
dataSubject.SetAdditionalData(map[string]interface{}{
    "phoneNumber": "String",
    "SSN": "String",
}
result, err := graphClient.Privacy().SubjectRightsRequests().Post(requestBody)

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

Antwort

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

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

{
    "type": "microsoft.graph.subjectRightsRequestType",
    "dataSubjectType": "microsoft.graph.dataSubjectType",
    "regulations": [
        "String"
    ],
    "displayName": "String",
    "description": "String",
    "status": "active",
    "internalDueDateTime": "String",
    "lastModifiedDateTime": "String",
    "id": "String",
    "createdDateTime": "String",
    "stages": [
        {
            "stage": "contentRetrieval",
            "status": "notStarted",
            "error": 
            {
                "@odata.type": "microsoft.graph.publicError"
            }
        },
        {
            "stage": "contentReview",
            "status": "notStarted",
            "error": 
            {
                "@odata.type": "microsoft.graph.publicError"
            }
        },
        {
            "stage": "generateReport",
            "status": "notStarted",
            "error": 
            {
                "@odata.type": "microsoft.graph.publicError"
            }
        },
        {
            "stage": "caseResolved",
            "status": "notStarted",
            "error": 
            {
                "@odata.type": "microsoft.graph.publicError"
            }
        }
    ],
    "createdBy": {
        "@odata.type": "microsoft.graph.identitySet"
    },
    "lastModifiedBy": {
        "@odata.type": "microsoft.graph.identitySet"
    },
    "dataSubject": {
        "firstName": "String",
        "lastName": "String",
        "email": "String",
        "residency": "String",
        "phoneNumber": "String",
        "SSN": "String"
    },
    "team": {
        "id": "String (identifier)",
        "webUrl": "String"
    }
}