Benutzer abrufenGet a user

• 13.01.2020
• 2 Minuten Lesedauer
• • 
  • 

Dient zum Abrufen der Eigenschaften und der Beziehungen des Benutzerobjekts.Retrieve the properties and relationships of user object.

Dieser Vorgang gibt standardmäßig nur eine Teilmenge der häufiger verwendeten Eigenschaften für jeden Benutzer zurück.This operation returns by default only a subset of the more commonly used properties for each group. Diese Standardeigenschaften werden im Abschnitt Eigenschaften aufgeführt.These default properties are noted in the Properties section. Um Eigenschaften abzurufen, die nicht standardmäßig zurückgegeben werden, führen Sie eine GET-Operation für den Benutzer aus, und geben Sie die Eigenschaften in einer $select OData-Abfrageoption an.To get properties that are not returned by default, do a GET operation for the group and specify the properties in a $select OData query option. Da die user-Ressource Erweiterungen unterstützt, können Sie über den GET-Vorgang auch benutzerdefinierte Eigenschaften und Erweiterungsdaten aus user-Instanzen abrufen.Since the user resource supports extensions, you can also use the GET operation to get custom properties and extension data in a user instance.

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

GET /users/{id | userPrincipalName}

Optionale AbfrageparameterOptional query parameters

Diese Methode unterstützt die OData-Abfrageparameter zur Anpassung der Antwort.This method supports the OData Query Parameters to help customize the response.

AnforderungsheaderRequest headers

AnforderungstextRequest body

Geben Sie für diese Methode keinen Anforderungstext an.Do not supply a request body for this method.

AntwortResponse

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und ein user-Objekt im Antworttext zurückgegeben.If successful, this method returns a 200 OK response code and user object in the response body.

Diese Methode wird 202 Accepted zurückgeben, wenn die Anforderung erfolgreich verarbeitet wurde, aber der Server mehr Zeit dazu benötigt, verbundene Hintergrundvorgänge abzuschließen.This method returns 202 Accepted when the request has been processed successfully but the server requires more time to complete related background operations.

BeispielExample

Beispiel 1: Abrufen der Eigenschaften des angemeldeten BenutzersExample 1: Get the properties of the signed-in user

AnforderungRequest

GET https://graph.microsoft.com/beta/me

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var user = await graphClient.Me
    .Request()
    .GetAsync();

const options = {
    authProvider,
};

const client = Client.init(options);

let res = await client.api('/me')
    .version('beta')
    .get();

MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/me"]]];
[urlRequest setHTTPMethod:@"GET"];

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

        MSGraphUser *user = [[MSGraphUser alloc] initWithData:data error:&nserror];

}];

[meDataTask execute];

AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort.Here is an example of the response. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten.Note: The response object shown here may be truncated for brevity.

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

{
   "displayName": "displayName-value",
   "givenName": "givenName-value",
   "jobTitle": "jobTitle-value",
   "mail": "mail-value",
   "mobilePhone": "mobilePhone-value",
   "officeLocation": "officeLocation-value",
   "preferredLanguage": "preferredLanguage-value",
   "surname": "surname-value",
   "userPrincipalName": "userPrincipalName-value",
   "id": "id-value"
}

Beispiel 2: Abrufen der Eigenschaften des angegebenen BenutzersExample 2: Get the properties of the specified user

AnforderungRequest

Das folgende Beispiel zeigt eine Anfrage.The following example shows a request.

GET https://graph.microsoft.com/beta/users/{id}

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var user = await graphClient.Users["{id}"]
    .Request()
    .GetAsync();

const options = {
    authProvider,
};

const client = Client.init(options);

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

MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/users/{id}"]]];
[urlRequest setHTTPMethod:@"GET"];

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

        MSGraphUser *user = [[MSGraphUser alloc] initWithData:data error:&nserror];

}];

[meDataTask execute];

AntwortResponse

Das folgende Beispiel zeigt die Antwort.The following example shows the response.

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

{
      "displayName": "displayName-value",
      "givenName": "givenName-value",
      "jobTitle": "jobTitle-value",
      "mail": "mail-value",
      "mobilePhone": "mobilePhone-value",
      "officeLocation": "officeLocation-value",
      "preferredLanguage": "preferredLanguage-value",
      "surname": "surname-value",
      "userPrincipalName": "userPrincipalName-value",
      "id": "id-value"
}

Siehe auchSee also

• Hinzufügen von benutzerdefinierten Daten zu Ressourcen mithilfe von ErweiterungenAdd custom data to resources using extensions
• Hinzufügen von benutzerdefinierten Daten zu Benutzern mithilfe offener Erweiterungen (Preview)Add custom data to users using open extensions (preview)
• Hinzufügen von benutzerdefinierten Daten zu Gruppen mithilfe von Schemaerweiterungen (Preview)Add custom data to groups using schema extensions (preview)