Müşterinin ürün yükseltme durumunu alma

Makale
09/23/2023

Yeni bir ürün ailesine yükseltme durumunu almak için ProductUpgradeRequest kaynağını kullanabilirsiniz. Bu kaynak, bir müşteriyi Microsoft Azure (MS-AZR-0145P) aboneliğinden Azure planına yükseltirken geçerlidir. Başarılı bir istek ProductUpgradesEligibility kaynağını döndürür.

Ön koşullar

İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo, App+User kimlik bilgileriyle kimlik doğrulamayı destekler. İş Ortağı Merkezi API'leriyle App+User kimlik doğrulamasını kullanırken güvenli uygulama modelini izleyin.
Müşteri kimliği (customer-tenant-id). Müşterinin kimliğini bilmiyorsanız, İş Ortağı Merkezi'nde Müşteriler çalışma alanını, ardından müşteri listesinden müşteriyi ve ardından Hesap'ı seçerek bunu arayabilirsiniz. Müşterinin Hesap sayfasında, Müşteri Hesabı Bilgileri bölümünde Microsoft Kimliği'ni arayın. Microsoft Kimliği, müşteri kimliğiyle (customer-tenant-id) aynıdır.
Ürün ailesi.
Yükseltme isteğinin upgrade-id değeri.

C#

Müşterinin Azure planına yükseltmeye uygun olup olmadığını denetlemek için:

ProductUpgradesRequest nesnesi oluşturun ve ürün ailesi olarak müşteri tanımlayıcısını ve "Azure"ı belirtin.
IAggregatePartner.ProductUpgrades koleksiyonunu kullanın.
ById yöntemini çağırın ve upgrade-id değerini geçirin.
CheckStatus yöntemini çağırın ve ProductUpgradeStatus nesnesi döndürecek Olan ProductUpgradesRequest nesnesini geçirin.

// IAggregatePartner partnerOperations;

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

string selectedProductFamily = "azure";

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

ProductUpgradesStatus productUpgradeStatus = partnerOperations.ProductUpgrades.ById(selectedUpgradeId).CheckStatus(productUpgradeRequest);

if (productUpgradeEligibility.IsEligibile)
{
    ....
}

REST isteği

İstek söz dizimi

Yöntem	İstek URI'si
POST	{baseURL}/v1/productUpgrades/{upgrade-id}/status HTTP/1.1

URI parametresi

Ürün yükseltme durumunu almakta olduğunuz müşteriyi belirtmek için aşağıdaki sorgu parametresini kullanın.

Ad	Tür	Zorunlu	Tanım
upgrade-id	GUID	Evet	Değer, GUID biçimli bir yükseltme tanımlayıcısıdır. İzlenen bir yükseltme belirtmek için bu tanımlayıcıyı kullanabilirsiniz.

İstek üst bilgileri

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

Request body

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

İstek örneği

POST https://api.partnercenter.microsoft.com/v1/productupgrades/42d075a4-bfe7-43e7-af6d-7c68a57edcb4/status  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"
  }
  "Attributes": {
  "ObjectType": "ProductUpgradeRequest"
  }
}

Ö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ü, yararlı bilgiler içeren bir benioku dosyasıyla birlikte GitHub'dan indirebilirsiniz.

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

REST yanıtı

Başarılı olursa, bu yöntem gövdede bir ProductUpgradesEligibility kaynağı döndürür.

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 200 Ok
Content-Length: 150
MS-CorrelationId: 772871a9-399b-4f3b-b8c7-38f550e4f22a
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 04 Oct 2019 20:35:35 GMT

{
    "id": "42d075a4-bfe7-43e7-af6d-7c68a57edcb4",
    "status": "Completed",
    "productFamily": "Azure",
    "lineItems": [
        {
            "sourceProduct": {
                "id": "b1beb621-3cad-4d7a-b360-62db33ce028e",
                "name": "AzureSubscription"
            },
            "targetProduct": {
                "id": "d231908e-31c1-de0e-027b-bc5ce11f09d9",
                "name": "Microsoft Azure plan"
            },
            "upgradedDate": "2019-08-29T23:47:28.8524555Z",
            "status": "Completed"
        }
    ]
}

Aracılığıyla paylaş