Felhasználói fiók lekérése azonosító alapján

Kérje le egy konkrét felhasználói fiókot egy ügyfél számára.

• Az Partnerközpont hitelesítésileírása szerinti hitelesítő adatok. Ez a forgatókönyv csak app+felhasználói hitelesítő adatokkal támogatja a hitelesítést.

• Ügyfélazonosító (customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, megkeresheti azt a Partnerközpontban a Ügyfelek munkaterület kiválasztásával, majd az ügyfél kiválasztásával az ügyféllistából, és végül a Fiókmegnyitásával. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosítót az Ügyfélfiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id).

GDAP-szerepkörök

A következő GDAP-szerepkörök közül legalább egyre lesz szüksége:

• Címtárolvasó
• Globális olvasó
• Felhasználói rendszergazda

C#

Egy ügyfél felhasználói fiókjának lekéréséhez hívja meg az IAggregatePartner.Customers.ById metódust az ügyfél azonosítójával az ügyfél azonosításához. Ezután hívja meg a Users.ById metódust az adott felhasználó lekéréséhez. Végül hívja meg a Users.Get vagy GetAsync metódust a felhasználói fiók lekéréséhez.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// string selectedCustomerUserId;

// Get customer user detail.
var customerUsers = partnerOperations.Customers.ById(selectedCustomerId).Users.ById(selectedCustomerUserId).Get();

minta: konzol tesztalkalmazás. Projekt: Partnerközpont SDK-minták osztály: GetCustomerUserDetails.cs

REST-kérés

Kérés szintaxisa

Módszer	URI kérése
GET	{baseURL}/v1/customers/{customer-tenant-id}/users/{user-id} HTTP/1.1

URI-paraméter

A megfelelő ügyfél és felhasználó azonosításához használja az alábbi URI-paramétereket.

Név	Típus	Szükséges	Leírás
ügyfél-bérlő azonosító	guid	Y	Az érték egy GUID formátumú ügyfél-bérlőazonosító, amely lehetővé teszi, hogy a viszonteladó szűrje a viszonteladóhoz tartozó adott ügyfél eredményeit.
felhasználói azonosító	guid	Y	Az érték egy guid formátumú felhasználóazonosító, amely egyetlen felhasználói fiókhoz tartozik.

Kérelemfejlécek

További információ: Partnerközpont REST-fejlécei.

Kérelem tartalma

Egyik sem.

Példa kérése

GET https://api.partnercenter.microsoft.com/v1/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users/a9ef48bb-8758-4590-a312-d4a47bfaded4 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c1f673cb-655c-45a7-8a6b-257a0a006f4b
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST-válasz

Ha sikeres, ez a metódus visszaadja az ügyfél felhasználói fiókját.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. A kód, a hibatípus és a további paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát lásd a Partnerközpont REST-hibakódjainál.

Példa válaszra

HTTP/1.1 200 OK
Content-Length: 432
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: c1f673cb-655c-45a7-8a6b-257a0a006f4b
MS-CV: uWM1EGU7+0aI2MvV.0
MS-ServerId: 020021921
Date: Wed, 21 Dec 2016 22:59:10 GMT

{
    "usageLocation": "US",
    "id": "a9ef48bb-8758-4590-a312-d4a47bfaded4",
    "userPrincipalName": "Daniel@dtdemocspcustomer005.onmicrosoft.com",
    "firstName": "Daniel",
    "lastName": "Tsai",
    "displayName": "Daniel Tsai",
    "userDomainType": "none",
    "state": "active",
    "links": {
        "self": {
            "uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users/a9ef48bb-8758-4590-a312-d4a47bfaded4",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "CustomerUser"
    }
}