Tworzenie kont użytkowników dla klienta

Artykuł
09/11/2024

Utwórz nowe konto użytkownika dla klienta.

Wymagania wstępne

Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. 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 go wyszukać w Centrum partnerskim. Wybierz obszar roboczy Klienci na stronie głównej Centrum partnerskiego. Wybierz klienta z listy Klient, a następnie wybierz pozycję Konto. Na stronie Konto klienta poszukaj identyfikatora Microsoft w sekcji Szczegóły konta klienta. Identyfikator Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id).
Domena użytkownika nie może być domeną federacyjną.

Role GDAP

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

Administrator użytkowników
Autorzy katalogów

C#

Aby uzyskać nowe konto użytkownika dla klienta:

Utwórz nowy obiekt CustomerUser z odpowiednimi informacjami o użytkowniku.
Użyj kolekcji IAggregatePartner.Customers i wywołaj metodę ById().
Wywołaj właściwość Users , a następnie metodę Create .

// string selectedCustomerId;
// IAggregatePartner partnerOperations;
// var SelectedCustomer;

var userToCreate = new CustomerUser()
{
    PasswordProfile = new PasswordProfile() { ForceChangePassword = true, Password = "Password!1" },
    DisplayName = "TestDisplayName",
    FirstName = "TestFirstName",
    LastName = "TestLastName",
    UsageLocation = "US",
    UserPrincipalName = Guid.NewGuid().ToString("N") + "@" + selectedCustomer.CompanyProfile.Domain.ToString()
};

User createdUser = partnerOperations.Customers.ById(selectedCustomerId).Users.Create(userToCreate);

Przykład: aplikacja testowa konsoli. Projekt: PartnerSDK.FeatureSamples , klasa: CustomerUserCreate.cs

Żądanie REST

Składnia żądania

Metoda	Identyfikator URI żądania
POST	{baseURL}/v1/customers/{customer-tenant-id}/users HTTP/1.1

Parametry identyfikatora URI

Użyj następujących parametrów zapytania, aby zidentyfikować właściwego klienta.

Nazwisko	Type	Wymagania	opis
identyfikator dzierżawy klienta	Identyfikator guid	Y	Wartość jest identyfikatorem GUID sformatowanym identyfikatorem customer-tenant-id. Umożliwia odsprzedawcy filtrowanie wyników dla danego klienta należącego do odsprzedawcy.
identyfikator użytkownika	Identyfikator guid	N	Wartość jest identyfikatorem GUID sformatowanym przez użytkownika , który należy do jednego konta użytkownika.

Nagłówki żądań

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

Treść żądania

Brak.

Przykład żądania

POST https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/users HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: b1317092-f087-471e-a637-f66523b2b94c
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
      "usageLocation": "country/region code",
      "userPrincipalName": "userid@domain.onmicrosoft.com",
      "firstName": "First",
      "lastName": "Last",
      "displayName": "User name",
      "immutableId": "Some unique ID",
      "passwordProfile":{
                 password: "abCD123*",
                 forceChangePassword: true
      },
      "attributes": {
        "objectType": "CustomerUser"
      }
}

Odpowiedź REST

W przypadku powodzenia ta metoda zwraca konto użytkownika, w tym identyfikator GUID.

Kody powodzenia 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.

Przykład odpowiedzi

HTTP/1.1 200 OK
Content-Length: 31942
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: b1317092-f087-471e-a637-f66523b2b94c
Date: June 24 2016 22:00:25 PST

{
  "usageLocation": "country/region code",
  "id": "4b10bf41-ab11-40e3-8c53-cd67849b50de",
  "userPrincipalName": "userid@domain.onmicrosoft.com",
  "firstName": "First",
  "lastName": "Last",
  "displayName": "User name",
  "immutableId": "Some unique ID",
  "passwordProfile": {
    "forceChangePassword": true,
    "password": "abCD123*"
  },
  "lastDirectorySyncTime": null,
  "userDomainType": "none",
  "state": "active",
  "softDeletionTime": null,
  "attributes": {
    "objectType": "CustomerUser"
  }
}

Udostępnij za pośrednictwem