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

  • Makale
  • Okumak için 2 dakika

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 doğrulamasında açıklandığı gibi İş Ortağı Merkezi bilgileri. Bu senaryo, App+User kimlik bilgileriyle kimlik doğrulamasını destekler. Uygulama+Kullanıcı kimlik doğrulamasını api'lerle kullanırken güvenli İş Ortağı Merkezi izleyin.

  • Müşteri kimliği ( customer-tenant-id ). Müşterinin kimliğini bilmiyorsanız bu kimliği panoda İş Ortağı Merkezi. İş Ortağı Merkezi'den CSP'yi ve ardından Müşteriler'i seçin. Müşteri listesinden müşteriyi ve ardından Hesap'ı seçin. Müşterinin Hesap sayfasında Müşteri Hesabı Bilgileri bölümünde MicrosoftKimliği'ne bakın. Microsoft Kimliği, müşteri kimliği () ile customer-tenant-id aynıdır.

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

C#

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

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

  2. IAggregatePartner.ProductUpgrades koleksiyonunu kullanın.

  3. Create yöntemini çağırarak ProductUpgradesRequest nesnesini iletin; bu nesne bir konum üst bilgisi dizesi döndürür.

  4. Yükseltme durumunu sorgulamak için kullanılan konum üst bilgisi dizesinde upgrade-id'sini ayıklar.

// 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
YAYINLA {baseURL}/v1/productupgrades HTTP/1.1

İstek üst bilgileri

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

İstek gövdesi

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

İ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: e3f26e6a-044f-4371-ad52-0d91ce4200be
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"
}

REST yanıtı

Başarılı olursa yanıt, ürün yükseltme durumunu almak için URI'ye sahip bir Konum üst bilgisi içerir. Diğer ilgili REST API'leriyle kullanmak için bu URI'yi kaydedin.

Yanıt başarı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu gösteren 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: 772871a9-399b-4f3b-b8c7-38f550e4f22a
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 28 Sep 2019 20:35:35 GMT