Deneme aboneliğini Iş Ortağı Merkezi API 'Leri kullanarak ücretli olarak dönüştürme

Deneme aboneliğini ücretli olarak dönüştürebilirsiniz.

Önkoşullar

• Iş ortağı merkezi kimlik doğrulamasındaaçıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca uygulama + kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.

• Bir müşteri KIMLIĞI ( customer-tenant-id ). Müşterinin KIMLIĞINI bilmiyorsanız Iş Ortağı Merkezi panosundabulabilirsiniz. Iş Ortağı Merkezi menüsünden CSP ' yi ve ardından müşteriler' i seçin. Müşteri listesinden müşteriyi seçin ve ardından Hesap' ı seçin. 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ĞI () ile aynıdır customer-tenant-id .

• Etkin deneme aboneliği için abonelik KIMLIĞI.

• Kullanılabilir bir dönüştürme teklifi.

Kod aracılığıyla bir deneme aboneliğini ücretli aboneliğe dönüştürme

Deneme aboneliğini ücretli bir sürüme dönüştürmek için, önce kullanılabilir deneme dönüştürmelerinden oluşan bir koleksiyonu edinmeniz gerekir. Ardından, Satın almak istediğiniz dönüştürme teklifini seçmeniz gerekir.

Dönüştürme teklifleri, deneme aboneliğiyle aynı sayıda lisansla varsayılan olarak bir miktar belirtir. Bu miktarı, Miktar özelliğini satın almak istediğiniz lisansların sayısı olarak ayarlayarak değiştirebilirsiniz.

Bir deneme aboneliğini kodla dönüştürmek için aşağıdaki adımları kullanın:

1. Kullanılabilir abonelik işlemlerine bir arabirim alın. Müşteriyi tanımlamalısınız ve deneme aboneliğinin abonelik tanımlayıcısını belirtmeniz gerekir.

   var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);
   

2. Kullanılabilir dönüştürme tekliflerinin bir koleksiyonunu alın. Bu yöntem için istek/yanıt hakkında daha fazla bilgi ve Ayrıntılar için bkz. deneme dönüştürme tekliflerinin bir listesini alın.

   var conversions = subscriptionOperations.Conversions.Get();
   

3. Bir dönüştürme teklifi seçin. Aşağıdaki kod, koleksiyondaki ilk dönüştürme teklifini seçer.

   var selectedConversion = conversions.Items.ToList()[0];
   

4. İsteğe bağlı olarak, satın alınabilecek lisansların sayısını belirtin. Varsayılan değer, deneme aboneliğindeki lisansların sayısıdır.

   selectedConversion.Quantity = 10;
   

5. Deneme aboneliğini ücretli olarak dönüştürmek için Create veya createasync yöntemini çağırın.

   var convertResult = subscriptionOperations.Conversions.Create(selectedConversion);
   

C#

Deneme aboneliğini ücretli birine dönüştürmek için:

1. Müşteriyi tanımlamak için, müşteri KIMLIĞIYLE ıaggregatepartner. Customers. Byıd yöntemini kullanın.

2. Deneme aboneliği KIMLIĞIYLE abonelikler. Byıd metodunu çağırarak abonelik işlemlerine yönelik bir arabirim alın. Yerel bir değişkende abonelik işlemleri arabirimine bir başvuru kaydedin.

3. Dönüşümlerde kullanılabilir işlemlere bir arabirim elde etmek için dönüşümler özelliğini kullanın ve ardından kullanılabilir dönüştürme tekliflerinin bir koleksiyonunu almak Için Get veya GetAsync yöntemini çağırın. Birini seçmeniz gerekir. Aşağıdaki örnek varsayılan olarak kullanılabilir ilk dönüştürmeyi alır.

4. Dönüşümlerdeki kullanılabilir işlemlere bir arabirim elde etmek için yerel bir değişkende kaydettiğiniz abonelik işlemleri arabirimine yönelik başvuruyu ve dönüşümler özelliğini kullanın.

5. Deneme dönüşümünü denemek için seçili dönüştürme teklifini nesnesini Create veya createasync metoduna geçirin.

C# örneği

// IAggregatePartner partnerOperations;
// string customerId;
// string subscriptionId;

// Get subscription operations for the trial subscription.
var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);

// Get the available conversions.
var conversions = subscriptionOperations.Conversions.Get();

// If there are no conversions available, we're done.
// Otherwise, convert the trial to the first available conversion offer.
if (conversions.TotalCount <= 0)
{
    System.Console.WriteLine("This subscription has no conversions");
}
else
{
    // Default to the first conversion.
    var selectedConversion = conversions.Items.ToList()[0];

    // Convert the trial and return the result.
    var convertResult = subscriptionOperations.Conversions.Create(selectedConversion);
}

REST isteği

İstek sözdizimi

URI parametresi

Müşteri ve deneme aboneliğini belirlemek için aşağıdaki yol parametrelerini kullanın.

İstek üst bilgileri

Daha fazla bilgi için bkz. Iş ortağı MERKEZI Rest üstbilgileri.

İstek gövdesi

İstek gövdesine doldurulmuş bir dönüştürme kaynağı eklenmelidir.

İstek örneği

POST https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/488745B5-2086-4912-802C-6ABB9F7C3638/conversions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: bd0cde7f-ba87-4010-8a73-1190b641f2a4
MS-CorrelationId: 8daa6d54-72ab-4d6b-9c7d-9266d3734a47
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 234
Expect: 100-continue

{
    "OfferId": "C0BD2E08-11AC-4836-BDC7-3712E744922F",
    "TargetOfferId": "031C9E47-4802-4248-838E-778FB1D2CC05",
    "OrderId": "D51A052E-043C-4A2A-AA37-2BB938CEF6C1",
    "Quantity": 25,
    "BillingCycle": "monthly",
    "Attributes": {
        "ObjectType": "Conversion"
    }
}

REST yanıtı

Başarılı olursa, yanıt gövdesi bir Conversionresult kaynağı içerir.

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

Her yanıt başarı veya başarısızlık ve ek hata ayıklama bilgilerini gösteren bir HTTP durum kodu ile gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. Partner Center hata kodları.

Yanıt örneği

HTTP/1.1 200 OK
Content-Length: 211
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 8daa6d54-72ab-4d6b-9c7d-9266d3734a47
MS-RequestId: bd0cde7f-ba87-4010-8a73-1190b641f2a4
MS-CV: kW4GzmhvHEqCq1ls.0
MS-ServerId: 030020643
Date: Thu, 15 Jun 2017 23:10:40 GMT

 {
    "subscriptionId": "488745B5-2086-4912-802C-6ABB9F7C3638",
    "offerId": "C0BD2E08-11AC-4836-BDC7-3712E744922F",
    "targetOfferId": "031C9E47-4802-4248-838E-778FB1D2CC05",
    "attributes": {
        "objectType": "ConversionResult"
    }
}