Tworzenie klienta
Dotyczy: Centrum partnerskie | Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA
Jako partner Dostawca rozwiązań w chmurze (CSP) podczas tworzenia klienta możesz składać zamówienia w imieniu klienta. Podczas tworzenia klienta utworzysz również następujące elementy:
- Obiekt dzierżawy entra firmy Microsoft dla klienta
- Relacja między odsprzedawcą a klientem (używana do delegowania uprawnień administratora)
- Nazwa użytkownika i hasło do logowania się jako administrator klienta
Po utworzeniu klienta zapisz identyfikator klienta i szczegóły identyfikatora entra firmy Microsoft.
Ważne
Jeśli jesteś dostawcą pośrednim i chcesz utworzyć klienta dla odsprzedawcy pośredniego, zobacz Tworzenie klienta dla odsprzedawcy pośredniego.
Wymagania wstępne
- Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i aplikacji i użytkownika.
Ważne
Aby utworzyć dzierżawę klienta, należy podać prawidłowy adres fizyczny podczas procesu tworzenia. Adres można zweryfikować, wykonując kroki opisane w scenariuszu Weryfikowanie adresu . Jeśli utworzysz klienta przy użyciu nieprawidłowego adresu w środowisku piaskownicy, nie będzie można usunąć tej dzierżawy klienta.
Ważne
Jeśli przekazywanie hasła użytkownikaCredentials nie jest akceptowane.
C#
Aby dodać klienta:
Utwórz wystąpienie nowego obiektu Klient. Pamiętaj, aby wypełnić pola BillingProfile i CompanyProfile.
Dodaj nowego klienta do kolekcji IAggregatePartner.Customers, wywołując polecenie Create lub CreateAsync.
Przykład w języku C#
// IAggregatePartner partnerOperations;
var partnerOperations = this.Context.UserPartnerOperations;
var customerToCreate = new Customer()
{
CompanyProfile = new CustomerCompanyProfile()
{
Domain = string.Format(CultureInfo.InvariantCulture,
"SampleApplication{0}.{1}",
new Random().Next(),
this.Context.Configuration.Scenario.CustomerDomainSuffix),
//// OrganizationRegistrationNumber = "123456" // Please add if in specific country/region that requires
},
BillingProfile = new CustomerBillingProfile()
{
Culture = "EN-US",
Email = "gena@wingtiptoys.com",
Language = "En",
CompanyName = "Wingtip Toys"
DefaultAddress = new Address()
{
FirstName = "Gena",
MiddleName = "Coralie",
LastName = "Soto",
AddressLine1 = "One Microsoft Way",
City = "Redmond",
State = "WA",
Country = "US",
PostalCode = "98052",
PhoneNumber = ""
}
}
};
var newCustomer = partnerOperations.Customers.Create(customerToCreate);
Przykładowa aplikacja w języku C#
- Aplikacja testowa konsoli. Projekt: Klasa przykładów zestawu SDK Centrum partnerskiego: CreateCustomer.cs
REST
Składnia żądania
| Method | Identyfikator URI żądania |
|---|---|
| POST | {baseURL}/v1/customers HTTP/1.1 |
Nagłówki żądań
Ten interfejs API jest idempotentny (nie zwróci innego wyniku, jeśli wywołasz go wiele razy).
Wymagany jest identyfikator żądania i identyfikator korelacji.
Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.
Treść żądania
W tej tabeli opisano wymagane właściwości w treści żądania.
| Nazwisko | Pisz | Opis |
|---|---|---|
| BillingProfile | obiekt | Informacje o profilu rozliczeniowym klienta. |
| CompanyProfile | obiekt | Informacje o profilu firmy klienta. |
Profil rozliczeniowy
W tej tabeli opisano minimalne wymagane pola z zasobu CustomerBillingProfile potrzebnego do utworzenia nowego klienta.
| Nazwisko | Pisz | Opis |
|---|---|---|
| adres e-mail | string | Adres e-mail klienta. |
| kultura | string | Preferowana kultura komunikacji i waluty, na przykład en-US. Zobacz Obsługiwane języki i ustawienia regionalne Centrum partnerskiego dla obsługiwanych kultur. |
| język | string | Język domyślny. Obsługiwane są dwa kody języków znaków (na przykład en lub fr). |
| Companyname | string | Zarejestrowana nazwa firmy/organizacji. |
| defaultAddress | Address | Zarejestrowany adres firmy/organizacji klienta. Aby uzyskać informacje na temat ograniczeń długości, zobacz zasób Adres. |
Profil firmy
W tej tabeli opisano minimalne wymagane pola z zasobu CustomerCompanyProfile potrzebnego do utworzenia nowego klienta.
| Nazwisko | Pisz | Opis |
|---|---|---|
| domena | string | Nazwa domeny klienta, taka jak contoso.onmicrosoft.com. |
| organizationRegistrationNumber | String | Numer rejestracji organizacji klienta (nazywany również numerem INN w niektórych krajach/regionach). Wymagane tylko dla firmy/organizacji klienta znajdującej się w następujących krajach/regionach: Armenia(AM), Azerbejdżan (AZ), Białoruś(BY), Węgry(HU), Kazachstan(KZ), Kirgistan(KG), Mołdawia(MD), Rosja(RU), Tadżykistan(TJ), Uzbekistan(UZ), Ukraina(UA), Brazylia(BR), Indie, Republika Południowej Afryki, Polska, Zjednoczone Emiraty Arabskie, Arabia Saudyjska, Türkiye, Tajlandia, Wietnam, Birma, Irak, Sudan Południowy, Wenezuela i Chiny. W przypadku firmy/organizacji klienta znajdującej się w innych krajach/regionach jest to pole opcjonalne. |
Domyślnie GDAP
| Nazwisko | Pisz | Opis |
|---|---|---|
| enableGDAPByDefault | bool | Wartość logiczna wskazująca, czy chcesz włączyć GDAP domyślnie, czy nie. Jeśli wartość true, utworzymy domyślnie GDAP. Jeśli wartość false, nie utworzymy GDAP. Należy pamiętać, że jest to honorowane tylko w chmurach, które obsługują GDAP. Jeśli język DAP nie jest obsługiwany, zostanie utworzony domyślnie. |
Przykład żądania
POST https://api.partnercenter.microsoft.com/v1/customers HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 789
Expect: 100-continue
Connection: Keep-Alive
{
"enableGDAPByDefault": false,
"CompanyProfile": {
"Domain": "xyz.onmicrosoft.com"
},
"BillingProfile": {
"Culture": "EN-US",
"Email": "gena@wingtiptoys.com",
"Language": "en",
"CompanyName": "Wingtip Toys",
"DefaultAddress": {
"FirstName": "Gena",
"LastName": "Soto",
"AddressLine1": "One Microsoft Way",
"City": "Redmond",
"State": "WA",
"PostalCode": "98052",
"Country": "US"
}
}
}
Odpowiedź REST
W przypadku powodzenia ten interfejs API zwraca zasób klienta dla nowego klienta. Zapisz identyfikator klienta i szczegóły identyfikatora entra firmy Microsoft do użycia w przyszłości z zestawem SDK Centrum partnerskiego. Będą one potrzebne do użycia z zarządzaniem kontami, na przykład.
Kody powodzenia i błędów odpowiedzi
Odpowiedzi są dostarczane z kodem 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 partnerskiego.
Przykład odpowiedzi
HTTP/1.1 201 Created
Content-Length: 834
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CV: ObwhuhD2tUKJoM+Z.0
MS-ServerId: 202010223
Date: Tue, 14 Feb 2017 20:06:02 GMT
{
"id": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"commerceId": "0a4ce58a-6f96-4273-8035-d9c7d31b9ba4",
"companyProfile": {
"tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"domain": "xyz.onmicrosoft.com",
"attributes": {
"objectType": "CustomerCompanyProfile"
}
},
"billingProfile": {
"id": "d17c0275-da92-5c33-9032-782ef1d0b69b",
"email": "gena@wingtiptoys.com",
"culture": "en-US",
"language": "en",
"companyName": "Wingtip Toys",
"defaultAddress": {
"country": "US",
"city": "Redmond",
"state": "WA",
"addressLine1": "One Microsoft Way",
"postalCode": "98052",
"firstName": "Gena",
"lastName": "Soto",
"phoneNumber": ""
},
"attributes": {
"etag": "5920358838484612121",
"objectType": "CustomerBillingProfile"
}
},
"enableGDAPByDefault": false,
"relationshipToPartner": "none",
"userCredentials": {
"userName": "admin",
"password": "=;;n.=s9Z"
},
"attributes": {
"objectType": "Customer"
}
}
Java
Uwaga
Zestaw SDK Centrum partnerskiego dla języka Java to projekt typu open source obsługiwany przez społeczność partnerów.
Aby utworzyć nowego klienta, wykonaj następujące kroki.
- Utwórz nowe wystąpienie obiektów CustomerBillingProfile i CustomerCompanyProfile . Pamiętaj, aby wypełnić wymagane pola.
- Utwórz klienta, wywołując funkcję IAggregatePartner.getCustomers().create .
Przykład języka Java
// IAggregatePartner partnerOperations;
Address address = new Address();
address.setFirstName( "Gena" );
address.setLastName( "Soto" );
address.setAddressLine1( "One Microsoft Way" );
address.setCity( "Redmond" );
address.setState( "WA" );
address.setCountry( "US" );
address.setPostalCode( "98052" );
address.setPhoneNumber( "4255550101" );
CustomerBillingProfile billingProfile = new CustomerBillingProfile();
billingProfile.setCulture( "en-US" );
billingProfile.setEmail( "gena@wingtiptoys.com" );
billingProfile.setLanguage( "en" );
billingProfile.setCompanyName( "Wingtip Toys" );
billingProfile.setDefaultAddress( address );
CustomerCompanyProfile companyProfile = new CustomerCompanyProfile();
companyProfile.setDomain( "WingtipToys" + Math.abs( new Random().nextInt() ) + ".onmicrosoft.com" );
Customer customerToCreate = new Customer();
customerToCreate.setBillingProfile( billingProfile );
customerToCreate.setCompanyProfile( companyProfile );
Customer newCustomer = partnerOperations.getCustomers().create( customerToCreate );
PowerShell
Uwaga
Zestaw SDK Centrum partnerskiego dla programu PowerShell to projekt typu open source obsługiwany przez społeczność partnerów.
Aby utworzyć klienta, wykonaj polecenie New-PartnerCustomer , jak w poniższym przykładzie.
New-PartnerCustomer -BillingAddressLine1 '1 Microsoft Way' -BillingAddressCity 'Redmond' -BillingAddressCountry 'US' -BillingAddressPostalCode '98052' -BillingAddressState 'WA' -ContactEmail 'gena@wingtiptoys.com' -ContactFirstName 'Gena' -ContactLastName 'Soto' -Culture 'en-US' -Domain 'newcustomer.onmicrosoft.com' -Language 'en' -Name 'New Customer'