Skapa en kund
Gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government
Som Molnlösningsleverantör partner (CSP) kan du göra beställningar åt kunden när du skapar en kund. När du skapar en kund skapar du även:
- Ett Microsoft Entra-klientobjekt för kunden
- En relation mellan återförsäljaren och kunden (används för delegerade administratörsbehörigheter)
- Ett användarnamn och lösenord för att logga in som administratör för kunden
När kunden har skapats sparar du kund-ID :t och Microsoft Entra-ID:t.
Viktigt!
Om du är en indirekt leverantör och vill skapa en kund för en indirekt återförsäljare kan du läsa Skapa en kund för en indirekt återförsäljare.
Förutsättningar
- Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående app- och App+User-autentiseringsuppgifter.
Viktigt!
Om du vill skapa en kundklient måste du ange en giltig fysisk adress under skapandeprocessen. En adress kan verifieras genom att följa stegen som beskrivs i scenariot Verifiera en adress . Om du skapar en kund med en ogiltig adress i sandbox-miljön kan du inte ta bort den kundklientorganisationen.
Viktigt!
Om det inte godkänns att skicka userCredentials-lösenord.
C#
Så här lägger du till en kund:
Instansiera ett nytt kundobjekt. Se till att fylla i BillingProfile och CompanyProfile.
Lägg till den nya kunden i din IAggregatePartner.Customers-samling genom att anropa Skapa eller SkapaAsync.
C#-exempel
// 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);
C#-exempelapp
- Konsoltestapp. Projekt: SDK-exempelklass för Partnercenter: CreateCustomer.cs
REST
Syntax för begäran
Metod | URI för förfrågan |
---|---|
POST | {baseURL}/v1/customers HTTP/1.1 |
Begärandehuvuden
Det här API:et är idempotent (det ger inte ett annat resultat om du anropar det flera gånger).
Ett begärande-ID och korrelations-ID krävs.
Mer information finns i REST-huvuden för Partnercenter.
Begärandetext
I den här tabellen beskrivs de nödvändiga egenskaperna i begärandetexten.
Namn | Type | Beskrivning |
---|---|---|
BillingProfile | objekt | Kundens faktureringsprofilinformation. |
CompanyProfile | objekt | Kundens företagsprofilinformation. |
Faktureringsprofil
I den här tabellen beskrivs de minsta obligatoriska fälten från den CustomerBillingProfile-resurs som behövs för att skapa en ny kund.
Namn | Type | Beskrivning |
---|---|---|
E-post | sträng | Kundens e-postadress. |
Kultur | sträng | Deras föredragna kultur för kommunikation och valuta, till exempel en-US . Se Språk och nationella inställningar som stöds i Partnercenter för de kulturer som stöds. |
språk | string | Standardspråket. Två teckenspråkkoder (till exempel en ) fr stöds. |
companyName | sträng | Det registrerade företags-/organisationsnamnet. |
defaultAddress | Address | Den registrerade adressen för kundens företag/organisation. Se Adressresursen för information om eventuella längdbegränsningar. |
Företagsprofil
Den här tabellen beskriver de minsta obligatoriska fälten från customercompanyProfile-resursen som behövs för att skapa en ny kund.
Namn | Type | Beskrivning |
---|---|---|
domain | sträng | Kundens domännamn, till exempel contoso.onmicrosoft.com. |
organizationRegistrationNumber | String | Kundens organisationsregistreringsnummer (kallas även INN-nummer i vissa länder/regioner). Krävs endast för kundens företag/organisation i följande länder/regioner: Armenien(AM), Azerbajdzjan(AZ), Vitryssland(BY), Ungern(HU), Kazakstan(KZ), Kirgizistan(KG), Moldavien(MD), Ryssland(RU), Tadzjikistan(TJ), Uzbekistan(UZ), Ukraina(UA), Brasilien(BR), Indien, Sydafrika, Polen, Förenade Arabemiraten, Saudiarabien, Türkiye, Thailand, Vietnam, Myanmar, Irak, Sydsudan, Venezuela och Kina. För kundens företag/organisation som finns i andra länder/regioner är detta ett valfritt fält. |
GDAP som standard
Namn | Type | Beskrivning |
---|---|---|
enableGDAPByDefault | bool | Booleskt värde för att ange om vi vill aktivera GDAP som standard eller inte. Om sant skapar vi GDAP som standard. Om det är falskt skapar vi inte GDAP. Observera att detta endast respekteras i moln som stöder GDAP. Om inget stöds skapas DAP som standard. |
Exempel på begäran
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"
}
}
}
REST-svar
Om det lyckas returnerar det här API:et en kundresurs för den nya kunden. Spara kund-ID och Microsoft Entra ID-information för framtida användning med PartnerCenter SDK. Du behöver dem till exempel för användning med kontohantering.
Svarsframgång och felkoder
Svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Rest-felkoder för Partnercenter.
Svarsexempel
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
Kommentar
PartnerCenter SDK för Java är ett öppen källkod projekt som underhålls av partnercommunityn.
Använd följande steg för att skapa en ny kund.
- Skapa en ny instans av CustomerBillingProfile- och CustomerCompanyProfile-objekten. Se till att fylla i de obligatoriska fälten.
- Skapa kunden genom att anropa funktionen IAggregatePartner.getCustomers().create .
Java-exempel
// 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
Kommentar
PartnerCenter SDK för PowerShell är ett öppen källkod projekt som underhålls av partnercommunityn.
Om du vill skapa en kund kör du kommandot New-PartnerCustomer som i följande exempel.
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'