Próbaverziós előfizetés konvertálása fizetőssé a Partnerközpont API-kkal

Megjegyzés:

Ezek a lépések nem alkalmazhatók az új kereskedelmi termékekre. Az Új kereskedelmi próbaverziók fizetős előfizetéssé alakításához tekintse meg az új kereskedelmi előfizetések áttűnési dokumentációját

A próbaverziós előfizetést fizetőssé alakíthatja.

Előfeltételek

  • Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv csak app+felhasználói hitelesítő adatokkal támogatja a hitelesítést.

  • Ügyfélazonosító (customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban az Ügyfelek munkaterület kiválasztásával, majd az ügyféllistából, majd a Fiók listában. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosítót az Ügyfélfiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id).

  • Egy aktív próbaverziós előfizetés előfizetés-azonosítója.

  • Elérhető konverziós ajánlat.

Próbaverziós előfizetés konvertálása fizetős előfizetéssé kóddal

Ha fizetőssé szeretne konvertálni egy próbaverziós előfizetést, először be kell szereznie az elérhető próbaverziókonverziók gyűjteményét. Ezután ki kell választania a megvásárolni kívánt konverziós ajánlatot.

A konverziós ajánlatok olyan mennyiséget adnak meg, amely alapértelmezés szerint a próbaverziós előfizetéssel megegyező számú licencet ad meg. Ezt a mennyiséget úgy módosíthatja, hogy a Quantity tulajdonságot a megvásárolni kívánt licencek számára állítja.

Megjegyzés:

A megvásárolt licencek számától függetlenül a próbaverzió előfizetés-azonosítója újra felhasználható a megvásárolt licencekhez. Ennek eredményeképpen a tényleges próbaverzió eltűnik, és a vásárlás helyettesíti.

A próbaverziós előfizetés kóddal való konvertálásához kövesse az alábbi lépéseket:

  1. Szerezze be az elérhető előfizetési műveletek felületét. Azonosítania kell az ügyfelet, és meg kell adnia a próbaverziós előfizetés előfizetés-azonosítóját.

    var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);
    
  2. Szerezze be az elérhető konverziós ajánlatok gyűjteményét. A metódus kérésével/válaszával kapcsolatos további információkért és részletekért tekintse meg a próbakonverziós ajánlatok listáját.

    var conversions = subscriptionOperations.Conversions.Get();
    
  3. Válasszon konverziós ajánlatot. Az alábbi kód a gyűjtemény első konverziós ajánlatát választja ki.

    var selectedConversion = conversions.Items.ToList()[0];
    
  4. Igény szerint adja meg a megvásárolni kívánt licencek számát. Az alapértelmezett érték a próbaverziós előfizetésben lévő licencek száma.

    selectedConversion.Quantity = 10;
    
  5. A próbaverziós előfizetés fizetőssé alakításához hívja meg a Create vagy a CreateAsync metódust.

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

C#

Próbaverziós előfizetés konvertálása fizetőssé:

  1. Az ügyfél azonosításához használja az IAggregatePartner.Customers.ById metódust az ügyfélazonosítóval.

  2. Az előfizetési műveletekhez az Subscriptions.ById metódus meghívásával kaphat felületet a próba-előfizetés azonosítójával. Mentsen egy hivatkozást az előfizetés műveleti felületére egy helyi változóban.

  3. A Konverziók tulajdonság használatával szerezzen be egy felületet a konverziókhoz elérhető műveletekhez, majd hívja meg a Get vagy a GetAsync metódust az elérhető konverziós ajánlatok gyűjteményének lekéréséhez. Válasszon egyet. Az alábbi példa alapértelmezés szerint az első elérhető konverzióra mutat.

  4. A helyi változóban mentett előfizetés-üzemeltetési felületre és a Konverziók tulajdonságra mutató hivatkozással szerezze be a konverziókon elérhető műveletek felületét.

  5. Adja át a kiválasztott konverziós ajánlat objektumot a Létrehozás vagy a CreateAsync metódusnak a próbakonverzió megkísérléséhez.

C# példa

// 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-kérés

Kérés szintaxisa

Metódus Kérés URI-ja
POST {baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/conversions HTTP/1.1

URI-paraméter

Az ügyfél- és próbaverziós előfizetés azonosításához használja az alábbi elérésiút-paramétereket.

Name Type Kötelező Leírás
ügyfél-azonosító sztring Igen Egy GUID formátumú sztring, amely azonosítja az ügyfelet.
előfizetés-azonosító sztring Igen A próbaverziós előfizetést azonosító GUID formátumú sztring.

Kérelemfejlécek

További információ: Partnerközpont – REST fejlécek.

A kérés törzse

A kérelem törzsének tartalmaznia kell egy kitöltött konverziós erőforrást.

Példa kérése

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-válasz

Ha sikeres, a válasz törzse egy ConversionResult-erőforrást tartalmaz.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. A kód, a hibatípus és a további paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát a Partnerközpont hibakódjaiban találja.

Példa válaszra

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"
    }
}