Aracılığıyla paylaş

Müşteri oluşturma

  • Makale

Şunlar için geçerlidir: İş Ortağı Merkezi | 21Vianet tarafından işletilen İş Ortağı Merkezi | ABD Kamu için Microsoft Bulut İş Ortağı Merkezi

Bulut Çözümü Sağlayıcısı (CSP) iş ortağı olarak, müşteri oluşturduğunuzda müşteri adına sipariş verebilirsiniz. Müşteri oluşturduğunuzda şunları da oluşturursunuz:

Müşteri oluşturulduktan sonra müşteri kimliğini ve Microsoft Entra Id ayrıntılarını kaydedin.

Önemli

Dolaylı bir sağlayıcıysanız ve dolaylı kurumsal bayi için müşteri oluşturmak istiyorsanız bkz . Dolaylı kurumsal bayi için müşteri oluşturma.

Önkoşullar

  • İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo hem tek başına Uygulama hem de Uygulama+Kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.

Önemli

Müşteri kiracısı oluşturmak için oluşturma işlemi sırasında geçerli bir fiziksel adres sağlamanız gerekir. Adres doğrulama senaryosunda açıklanan adımlar izlenerek adres doğrulanabilir. Korumalı alan ortamında geçersiz bir adres kullanarak müşteri oluşturursanız, bu müşteri kiracısını silemezsiniz.

Önemli

userCredentials parolası geçirilirken kabul edilemez.

C#

Müşteri eklemek için:

  1. Yeni bir Customer nesnesi örneği oluşturma. BillingProfile ve CompanyProfile bilgilerini doldurduğunuzdan emin olun.

  2. Create veya CreateAsync çağrısı yaparak yeni müşteriyi IAggregatePartner.Customers koleksiyonunuza ekleyin.

C# örneği

// 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# örnek uygulaması

REST

İstek söz dizimi

Yöntem İstek URI'si
POST {baseURL}/v1/customers HTTP/1.1

İstek üst bilgileri

Request body

Bu tablo, istek gövdesindeki gerekli özellikleri açıklar.

Adı Tür Açıklama
BillingProfile nesne Müşterinin faturalama profili bilgileri.
CompanyProfile nesne Müşterinin şirket profili bilgileri.

Faturalama profili

Bu tabloda, yeni bir müşteri oluşturmak için gereken CustomerBillingProfile kaynağından gereken en düşük alanlar açıklanmaktadır.

Adı Tür Açıklama
e-posta Dize Müşterinin e-posta adresi.
kültür Dize İletişim ve para birimi için tercih ettikleri kültür, örneğin en-US. Desteklenen kültürler için bkz . İş Ortağı Merkezi tarafından desteklenen diller ve yerel ayarlar.
dil Dize Varsayılan dil. İki karakterli dil kodu (örneğin en veya fr) desteklenir.
Şirketadı Dize Kayıtlı şirket/kuruluş adı.
defaultAddress Adres Müşterinin şirketinin/kuruluşunun kayıtlı adresi. Uzunluk sınırlamaları hakkında bilgi için Adres kaynağına bakın.

Şirket profili

Bu tabloda, yeni bir müşteri oluşturmak için gereken CustomerCompanyProfile kaynağından gereken en düşük alanlar açıklanmaktadır.

Adı Tür Açıklama
etki alanı Dize Müşterinin etki alanı adı (örneğin, contoso.onmicrosoft.com).
organizationRegistrationNumber String Müşterinin kuruluş kayıt numarası (belirli ülkelerde/bölgelerdeKI INN numarası olarak da adlandırılır). Yalnızca şu ülkelerde/bölgelerde bulunan müşterinin şirketi/kuruluşu için gereklidir: Ermenistan(AM), Azerbaycan(AZ), Belarus(BY), Macaristan(HU), Kazakistan(KZ), Kırgızistan(KG), Moldova(MD), Rusya(RU), Tacikistan(TJ), Özbekistan(UZ), Ukrayna(UA), Brezilya(BR), Hindistan, Güney Afrika, Polonya, Birleşik Arap Emirlikleri, Suudi Arabistan, Türkiye, Tayland, Vietnam, Myanmar, Irak, Güney Sudan, Venezuela ve Çin. Müşterinin başka ülkelerde/bölgelerde bulunan şirketi/kuruluşu için bu, isteğe bağlı bir alandır.

Varsayılan Olarak GDAP

Adı Tür Açıklama
enableGDAPByDefault ikili GDAP'yi varsayılan olarak etkinleştirmek isteyip istemediğinizi belirten Boole değeri. True ise varsayılan olarak GDAP oluştururuz. False ise GDAP oluşturmayacağız. Bu yalnızca GDAP'ı destekleyen bulutlarda kabul edilir. Desteklenmediyse, DAP varsayılan olarak oluşturulur.

İstek örneği

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: ab993325-1605-4cf4-bac4-fb584142a31b
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 yanıtı

Başarılı olursa, bu API yeni müşteri için bir Müşteri kaynağı döndürür. İş Ortağı Merkezi SDK'sı ile daha sonra kullanmak üzere müşteri kimliğini ve Microsoft Entra Id ayrıntılarını kaydedin. Örneğin, hesap yönetimiyle kullanmak için bunlara ihtiyacınız olacaktır.

Yanıt başarısı ve hata kodları

Yanıtlar, başarılı veya başarısız olduğunu belirten bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz . İş Ortağı Merkezi REST hata kodları.

Yanıt örneği

HTTP/1.1 201 Created
Content-Length: 834
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
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": "dfd8cc0a-c592-468c-8461-869a38d24738",
    "commerceId": "0a4ce58a-6f96-4273-8035-d9c7d31b9ba4",
    "companyProfile": {
        "tenantId": "dfd8cc0a-c592-468c-8461-869a38d24738",
        "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

Not

Java için İş Ortağı Merkezi SDK'sı, iş ortağı topluluğu tarafından sürdürülen açık kaynak bir projedir.

Yeni müşteri oluşturmak için aşağıdaki adımları kullanın.

  1. CustomerBillingProfile ve CustomerCompanyProfile nesnelerinin yeni bir örneğini oluşturun. Gerekli alanları doldurmayı unutmayın.
  2. IAggregatePartner.getCustomers().create işlevini çağırarak müşteriyi oluşturun.

Java örneği

// 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

Not

PowerShell için İş Ortağı Merkezi SDK'sı, iş ortağı topluluğu tarafından sürdürülen açık kaynak bir projedir.

Müşteri oluşturmak için, aşağıdaki örnekte olduğu gibi New-PartnerCustomer komutunu yürütür.

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'