建立客戶
適用於:合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府適用的 Microsoft Cloud 合作夥伴中心
身為 雲端解決方案提供者 (CSP) 合作夥伴,當您建立客戶時,您可以代表客戶下訂單。 當您建立客戶時,您也會建立:
- 客戶的 Microsoft Entra 租用戶物件
- 轉銷商與客戶之間的關聯性(用於委派的系統管理員許可權)
- 以客戶系統管理員身分登入的使用者名稱和密碼
建立客戶之後,請 儲存客戶標識碼 和 Microsoft Entra ID 詳細數據。
重要
如果您是間接提供者,而且想要為間接轉銷商建立客戶,請參閱 為間接轉銷商建立客戶。
必要條件
- 認證,如合作夥伴中心驗證所述。 此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
重要
若要建立客戶租使用者,您必須在建立程序期間提供有效的實體位址。 您可以遵循驗證位址案例中所述 的步驟來驗證位址 。 如果您在沙箱環境中使用無效的位址建立客戶,您將無法刪除該客戶租使用者。
重要
如果不接受傳遞 userCredentials 密碼。
C#
若要新增客戶:
具現化新的 Customer 物件。 請務必填寫 BillingProfile 和 CompanyProfile。
藉由呼叫 Create 或 CreateAsync,將新客戶新增至 IAggregatePartner.Customers 集合。
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);
C# 範例應用程式
- 主控台測試應用程式。 專案:合作夥伴中心 SDK 範例 類別:CreateCustomer.cs
REST
要求語法
方法 | 要求 URI |
---|---|
POST | {baseURL}/v1/customers HTTP/1.1 |
要求標頭
此 API 是等冪的(如果您多次呼叫,則不會產生不同的結果)。
需要要求標識碼和相互關聯標識碼。
如需詳細資訊,請參閱合作夥伴中心 REST 標頭。
要求本文
下表描述要求本文中的必要屬性。
名稱 | 類型 | 描述 |
---|---|---|
BillingProfile | object | 客戶的帳單配置檔資訊。 |
CompanyProfile | object | 客戶的公司配置文件資訊。 |
帳單設定檔
下表描述建立新客戶所需的 CustomerBillingProfile 資源所需的最小必要字段。
名稱 | 類型 | 描述 |
---|---|---|
電子郵件 | string | 客戶的電子郵件地址。 |
culture | string | 其偏好的通訊和貨幣文化特性,例如 en-US 。 如需支援的文化特性,請參閱 合作夥伴中心支援的語言和地區設定 。 |
language | string | 默認語言。 支援兩個字元的語言代碼(例如 en 或 fr )。 |
companyName | string | 已註冊的公司/組織名稱。 |
defaultAddress | 地址 | 客戶公司/組織的註冊位址。 如需任何長度限制的資訊,請參閱地址資源。 |
公司設定檔
下表描述建立新客戶所需的 CustomerCompanyProfile 資源所需的最小必要字段。
名稱 | 類型 | 描述 |
---|---|---|
網域 | string | 客戶的功能變數名稱,例如 contoso.onmicrosoft.com。 |
organizationRegistrationNumber | String | 客戶的組織註冊號碼(也稱為特定國家/地區的 INN 號碼)。 只有位於下列國家和地區的客戶公司/組織需要:亞美尼亞(AM)、亞塞拜然(AZ)、白俄羅斯(BY)、匈牙利(HU)、哈薩克(KZ)、吉爾吉斯斯坦(KG)、摩爾多瓦(MD)、俄羅斯(RU)、塔吉克(TJ)、烏茲別克(UZ)、烏克蘭(UA)、巴西(BR)、印度、 南非、波蘭、阿拉伯聯合酋長國、沙烏地阿拉伯、圖爾基耶、泰國、越南、緬甸、伊拉克、南蘇丹、委內瑞拉和中國。 對於位於其他國家/地區的客戶公司/組織,這是選擇性欄位。 |
根據預設,GDAP
名稱 | 類型 | 描述 |
---|---|---|
enableGDAPByDefault | bool | 布爾值,指出我們是否要默認啟用 GDAP。 如果為 true,我們預設會建立 GDAP。 如果為 false,我們不會建立 GDAP。 請注意,這隻適用於支援 GDAP 的雲端。 如果沒有支持,預設會建立 DAP。 |
要求範例
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 回應
如果成功,此 API 會 傳回新客戶的客戶 資源。 儲存客戶標識碼和 Microsoft Entra 識別碼詳細數據,以供未來搭配合作夥伴中心 SDK 使用。 例如,您將需要它們與帳戶管理搭配使用。
回應成功和錯誤碼
回應隨附 HTTP 狀態代碼,指出成功或失敗和其他偵錯資訊。 請使用網路追蹤工具來讀取此錯誤碼、錯誤類型和其他參數。 如需完整清單,請參閱合作夥伴中心的 REST 錯誤碼。
回應範例
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
注意
適用於 Java 的合作夥伴中心 SDK 是合作夥伴社群維護的 開放原始碼 專案。
使用下列步驟建立新的客戶。
- 建立 CustomerBillingProfile 和 CustomerCompanyProfile 物件的新實例。 請務必填入必要的欄位。
- 呼叫 IAggregatePartner.getCustomers()create 函式來建立 客戶。
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
注意
適用於 PowerShell 的合作夥伴中心 SDK 是合作夥伴社群維護的 開放原始碼 專案。
若要建立客戶,請 執行 New-PartnerCustomer 命令,如下列範例所示。
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'