Müşteri için ürün yükseltme varlığı oluşturma

ProductUpgradeRequest kaynağını kullanarak bir müşteriyi belirli bir ürün ailesine (örneğin Azure planı) yükseltmek için bir ürün yükseltme varlığı oluşturabilirsiniz.

Önkoşullar

  • Kimlik bilgileri, İş Ortağı Merkezi kimlik doğrulaması'nde açıklandığı gibi. Bu senaryo, App+User kimlik bilgileriyle kimlik doğrulamayı destekler. İş Ortağı Merkezi API'leriyle App+User kimlik doğrulaması kullanırken güvenli uygulama modeli izleyin.

  • Bir müşteri kimliği (customer-tenant-id). Müşteri kimliğini bilmiyorsanız, İş Ortağı Merkezi'nde Müşteriler çalışma alanını seçip, müşteri listesinden müşteriyi ve ardından Hesap'i seçerek arayabilirsiniz. Müşterinin Hesap sayfasında, Müşteri Hesabı Bilgileri bölümünde Microsoft Hesap Kimliği'ni bulun. Microsoft kimliği, müşteri kimliğiyle (customer-tenant-id) aynıdır.

  • Müşteriyi yükseltmek istediğiniz ürün ailesi.

C# (programlama dili)

Bir müşteriyi Azure planına yükseltmek için:

  1. bir ProductUpgradesRequest nesnesi oluşturun ve ürün ailesi olarak müşteri tanımlayıcısını ve "Azure"ı belirtin.

  2. IAggregatePartner.ProductUpgrades koleksiyonunu kullanın.

  3. Create yöntemini çağırın ve ProductUpgradesRequest nesnesini geçirin; bu nesne dize bir konum üst bilgisi döndürür.

  4. yükseltme durumunu sorgulamakiçin kullanılabilecek konum üst bilgi dizesinden upgrade-id ayıklayın.

// IAggregatePartner partnerOperations;

string selectedCustomerId = "58e2af4f-0ad3-4688-8744-be2357cd939a";

string selectedProductFamily = "Azure";

var productUpgradeRequest = new ProductUpgradesRequest
{
    CustomerId = selectedCustomerId,
    ProductFamily = selectedProductFamily
};

var productUpgradeLocationHeader = partnerOperations.ProductUpgrades.Create(productUpgradeRequest);

var upgradeId = Regex.Split(productUpgradeLocationHeader, "/")[1];

REST isteği

İstek söz dizimi

Yöntem İstek URI'si
post {baseURL}/v1/productupgrades HTTP/1.1

İstek başlıkları

Daha fazla bilgi için İş Ortağı Merkezi REST üst bilgileribkz.

İstek gövdesi

İstek gövdesi bir ProductUpgradeRequest kaynağı içermelidir.

İstek örneği

POST https://api.partnercenter.microsoft.com/v1/productupgrades HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c245d5f2-1de3-4ae0-9e42-95e38e3cb8ff
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 340
Expect: 100-continue
Connection: Keep-Alive
{
  "customerId": "4c721420-72ad-4708-a0a7-371a2f7b0969",
  "productFamily": "Azure"
}

Önemli

Haziran 2023 itibarıyla en son İş Ortağı Merkezi .NET SDK sürümü 3.4.0 arşivlenmiştir. SDK sürümünü GitHub 'danyararlı bilgiler içeren bir benioku dosyası indirebilirsiniz.

İş ortaklarının İş Ortağı Merkezi REST API'lerini kullanmaya devam etmesi teşvik edilir.

REST yanıtı

Başarılı olursa, ürün yükseltme durumunu almak için kullanılabilecek bir URI içeren bir Konum başlığı yanıt içinde bulunur. Bu URI'yi diğer ilgili REST API'leriyle kullanmak üzere kaydedin.

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

Her yanıt, 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 202 Accepted
Content-Length: 0
Location: productUpgrades/42d075a4-bfe7-43e7-af6d-7c68a57edcb4
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 28 Sep 2019 20:35:35 GMT
  • Last updated on