Zuweisen eines appRoleAssignment zu einem BenutzerGrant an appRoleAssignment to a user

• 06.02.2021
• 3 Minuten Lesedauer
• • p
  • o

Namespace: microsoft.graphNamespace: microsoft.graph

Verwenden Sie diese API, um einem Benutzer eine App-Rolle zuzuweisen.Use this API to assign an app role to a user. Um einem Benutzer eine App-Rolle zuzuweisen, benötigen Sie drei Bezeichner:To grant an app role assignment to a user, you need three identifiers:

• principalId: Die id des Benutzers, dem Sie die App-Rolle zuweisen möchten.principalId: The id of the user to whom you are assigning the app role.
• resourceId: Die id der Ressource servicePrincipal, über die die App-Rolle definiert wurde.resourceId: The id of the resource servicePrincipal that has defined the app role.
• appRoleId: Die id der appRole (definiert für den Ressourcendienstprinzipal), die dem Benutzer zugewiesen werden sollen.appRoleId: The id of the appRole (defined on the resource service principal) to assign to the user.

BerechtigungenPermissions

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.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

HTTP-AnforderungHTTP request

POST /users/{id | userPrincipalName}/appRoleAssignments

AnforderungsheaderRequest headers

AnforderungstextRequest body

Geben Sie im Anforderungstext eine JSON-Darstellung eines appRoleAssignment-Objekts an.In the request body, supply a JSON representation of an appRoleAssignment object.

AntwortResponse

Bei erfolgreicher Ausführung gibt die Methode den Antwortcode 201 Created und ein Objekt des Typs appRoleAssignment im Antworttext zurück.If successful, this method returns a 201 Created response code and an appRoleAssignment object in the response body.

BeispieleExamples

AnforderungRequest

Nachfolgend sehen Sie ein Beispiel der Anforderung.Here is an example of the request.

POST https://graph.microsoft.com/beta/users/{id}/appRoleAssignments
Content-Type: application/json
Content-Length: 110

{
  "principalId": "principalId-value",
  "resourceId": "resourceId-value",
  "appRoleId": "appRoleId-value"
}

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var appRoleAssignment = new AppRoleAssignment
{
    PrincipalId = Guid.Parse("principalId-value"),
    ResourceId = Guid.Parse("resourceId-value"),
    AppRoleId = Guid.Parse("appRoleId-value")
};

await graphClient.Users["{id}"].AppRoleAssignments
    .Request()
    .AddAsync(appRoleAssignment);

const options = {
    authProvider,
};

const client = Client.init(options);

const appRoleAssignment = {
  principalId: "principalId-value",
  resourceId: "resourceId-value",
  appRoleId: "appRoleId-value"
};

let res = await client.api('/users/{id}/appRoleAssignments')
    .version('beta')
    .post(appRoleAssignment);

MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/users/{id}/appRoleAssignments"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphAppRoleAssignment *appRoleAssignment = [[MSGraphAppRoleAssignment alloc] init];
[appRoleAssignment setPrincipalId:@"principalId-value"];
[appRoleAssignment setResourceId:@"resourceId-value"];
[appRoleAssignment setAppRoleId:@"appRoleId-value"];

NSError *error;
NSData *appRoleAssignmentData = [appRoleAssignment getSerializedDataWithError:&error];
[urlRequest setHTTPBody:appRoleAssignmentData];

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

        //Request Completed

}];

[meDataTask execute];

IGraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

AppRoleAssignment appRoleAssignment = new AppRoleAssignment();
appRoleAssignment.principalId = UUID.fromString("principalId-value");
appRoleAssignment.resourceId = UUID.fromString("resourceId-value");
appRoleAssignment.appRoleId = UUID.fromString("appRoleId-value");

graphClient.users("{id}").appRoleAssignments()
    .buildRequest()
    .post(appRoleAssignment);

In diesem Beispiel wären {id} und {principalId-value} die id des zugewiesenen Benutzers.In this example, {id} and {principalId-value} would both be the id of the assigned user.

AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort.Here is an example of the response.

Hinweis: Das hier gezeigte Antwortobjekt wurde möglicherweise zur besseren Lesbarkeit gekürzt. Ein tatsächlicher Aufruf gibt alle Eigenschaften zurück.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 253

{
  "id": "id-value",
  "creationTimestamp": "2016-10-19T10:37:00Z",
  "principalType": "principalType-value",
  "principalId": "principalId-value",
  "principalDisplayName": "principalDisplayName-value",
  "resourceId": "resourceId-value",
  "resourceDisplayName": "resourceDisplayName-value"
}