userUpn でユーザーを取得する

2022-04-26

API の説明

userUpn によって特定のユーザーを取得します。

前提条件

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可
委任	`MWaaSDevice.Read`
アプリケーション	`MmdSupport.ReadWrite`

HTTP 要求

GET https://mmdls.microsoft.com/support/odata/v1/tenants/{tenantId}/users/{userUpn}

要求ヘッダー

ヘッダー	値
Authorization	ベアラー {token} (必須)
承諾	application/json

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは応答本文に 200 OK 応答コードとユーザーの詳細を返します。

例

要求の例

HTTP 要求の例を次に示します。

GET https://mmdls.microsoft.com/support/odata/v1/tenants/{tenantId}/devices/jdoe@contoso.onmicrosoft.com

応答の例

JSON 応答の例を次に示します。

{ 
    "@odata.context": "https://mmd-support-prod-nam.trafficmanager.net/odata/v1/$metadata#Users", 
    "value": [ 
        { 
            "name": "John Doe", 
            "upn": "jdoe@contoso.onmicrosoft.com", 
            "email": "jdoe@contoso.onmicrosoft.com", 
            "groups": [ 
                { 
                    "id": "00000000-0000-0000-0000-000000000000", 
                    "displayName": "Group display name", 
                    "description": "Group description", 
                    "countMembers": null 
                } 
                ... 
            ], 
            "devices": [ 
                { 
                    "serialNumber": "Serial number value", 
                    "name": "Device Name value", 
                    "model": "Virtual Machine", 
                    "ring": "First", 
                    "lastIntuneSyncTime": "2021-03-16T11:10:04Z" 
                } 
                ... 
            ] 
        } 
    ] 
}