Udostępnij za pośrednictwem


Uzyskaj konto użytkownika po ID

Pobierz określone konto użytkownika dla klienta.

  • Poświadczenia zgodnie z opisem w uwierzytelnianiu Centrum Partnerskiego . Ten scenariusz obsługuje uwierzytelnianie tylko przy użyciu poświadczeń aplikacji i użytkownika.

  • Identyfikator klienta (customer-tenant-id). Jeśli nie znasz identyfikatora klienta, możesz wyszukać go w centrum partnerskim , wybierając obszar roboczy Klienci, a następnie klient z listy klientów, a następnie konto. Na stronie Konto klienta poszukaj identyfikatora Microsoft w sekcji Informacje o koncie klienta. Identyfikator Firmy Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id).

Role GDAP

Będziesz potrzebować co najmniej jednej z następujących ról GDAP:

  • Czytelnik katalogów
  • Czytelnik globalny
  • Administrator użytkowników

C#

Aby pobrać konto użytkownika dla klienta, wywołaj metodęIAggregatePartner.Customers.ById za pomocą identyfikatora klienta, aby zidentyfikować klienta. Następnie wywołaj metodę Users.ById, aby pobrać określonego użytkownika. Na koniec wywołaj metodę Users.Get lub GetAsync, aby pobrać konto użytkownika.

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

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

Przykład: testowa aplikacja konsolowa. project: Partner Center SDK Samples Class: GetCustomerUserDetails.cs

Żądanie REST

Składnia żądania

Metoda Żądanie URI
GET {baseURL}/v1/customers/{customer-tenant-id}/users/{user-id} HTTP/1.1

Parametr identyfikatora URI

Użyj następujących parametrów identyfikatora URI, aby zidentyfikować właściwego klienta i użytkownika.

Nazwa Typ Wymagane Opis
identyfikator-najemcy-klienta guid Y Wartość to identyfikator GUID sformatowany customer-tenant-id, który umożliwia odsprzedawcy filtrowanie wyników dla danego klienta należącego do odsprzedawcy.
identyfikator użytkownika guid Y Wartość jest identyfikatorem GUID w formacie identyfikatora użytkownika, który należy do pojedynczego konta użytkownika.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

Żaden.

Przykład żądania

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

Odpowiedź REST

W przypadku powodzenia ta metoda zwraca konto użytkownika dla klienta.

Kody sukcesu i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz kody błędów REST Centrum Partnerów .

Przykład odpowiedzi

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"
    }
}