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:
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);
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();
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];
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;
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é:
Az ügyfél azonosításához használja az IAggregatePartner.Customers.ById metódust az ügyfélazonosítóval.
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.
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.
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.
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"
}
}
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: