Převod zkušebního předplatného na placené pomocí rozhraní API Partnerského centra

Článek
09/23/2023

Poznámka

Tento postup se nevztahuje na nové komerční produkty. Informace o převodu zkušebních verzí nového komerčního předplatného na placená předplatná najdete v dokumentaci k převodu nového komerčního předplatného .

Zkušební předplatné můžete převést na placené.

Požadavky

Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pouze s přihlašovacími údaji aplikace a uživatele.
ID zákazníka (customer-tenant-id). Pokud neznáte ID zákazníka, můžete ho vyhledat v Partnerském centru tak , že vyberete pracovní prostor Zákazníci , pak zákazník ze seznamu zákazníků a pak účet. Na stránce Účet zákazníka vyhledejte ID Microsoftu v části Informace o účtu zákazníka. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).
ID předplatného pro aktivní zkušební předplatné.
Dostupná nabídka převodu.

Převod zkušebního předplatného na placené předplatné prostřednictvím kódu

Pokud chcete zkušební předplatné převést na placené předplatné, musíte nejprve získat kolekci dostupných zkušebních převodů. Pak musíte zvolit nabídku převodu, kterou chcete koupit.

Nabídky převodu budou určovat množství, které se ve výchozím nastavení použije ke stejnému počtu licencí jako zkušební předplatné. Toto množství můžete změnit nastavením vlastnosti Množství na počet licencí, které chcete koupit.

Poznámka

Bez ohledu na počet zakoupených licencí se ID předplatného zkušební verze znovu použije pro zakoupené licence. V důsledku toho zkušební období zmizí a nahradí se nákupem.

K převodu zkušebního předplatného prostřednictvím kódu použijte následující postup:

Získejte rozhraní k dostupným operacím předplatného. Musíte identifikovat zákazníka a zadat identifikátor předplatného zkušebního předplatného.
```
var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);
```
Získejte kolekci dostupných nabídek převodu. Další informace a podrobnosti o požadavku a odpovědi pro tuto metodu naleznete v tématu Získání seznamu nabídek pro převod zkušební verze.
```
var conversions = subscriptionOperations.Conversions.Get();
```
Zvolte nabídku převodu. Následující kód vybere první nabídku převodu v kolekci.
```
var selectedConversion = conversions.Items.ToList()[0];
```
Volitelně můžete zadat počet licencí, které se mají koupit. Výchozí hodnota je počet licencí ve zkušebním předplatném.
```
selectedConversion.Quantity = 10;
```
Zavolejte metodu Create nebo CreateAsync, která převede zkušební předplatné na placené.
```
var convertResult = subscriptionOperations.Conversions.Create(selectedConversion);
```

C#

Převod zkušebního předplatného na placené předplatné:

K identifikaci zákazníka použijte metodu IAggregatePartner.Customers.ById s ID zákazníka.
Získejte rozhraní pro operace předplatného voláním metody Subscriptions.ById s ID zkušebního předplatného. Uložte odkaz na rozhraní operací předplatného v místní proměnné.
Pomocí Conversions vlastnost získat rozhraní k dostupným operacím s převody a potom volání Get nebo GetAsync metoda načíst kolekci dostupných nabídek Conversion. Musíte zvolit jednu. Následující příklad ve výchozím nastavení nastaví první dostupný převod.
Použijte odkaz na rozhraní operací předplatného, které jste uložili v místní proměnné, a vlastnost Conversions k získání rozhraní pro dostupné operace při převodech.
Předejte vybraný objekt nabídky převodu metodě Create nebo CreateAsync a pokuste se o převod zkušební verze.

Příklad jazyka C#

// 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&#39;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);
}

Požadavek REST

Syntaxe požadavku

Metoda	Identifikátor URI žádosti
POST	{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/conversions HTTP/1.1

Parametr identifikátoru URI

Pomocí následujících parametrů cesty identifikujte předplatné zákazníka a zkušební verzi.

Jméno	Type	Požadováno	Popis
ID zákazníka	řetězec	Ano	Formátovaný řetězec GUID, který identifikuje zákazníka.
id předplatného	řetězec	Ano	Řetězec formátovaný identifikátorem GUID, který identifikuje zkušební předplatné.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Naplněný prostředek převodu musí být součástí textu požadavku.

Příklad požadavku

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

Odpověď REST

V případě úspěchu obsahuje tělo odpovědi prostředek ConversionResult .

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb v Partnerském centru.

Příklad odpovědi

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