Konvertera en utvärderingsprenumeration till betald med hjälp av Api:er för Partnercenter

Artikel
10/01/2024

Kommentar

De här stegen gäller inte för nya handelsprodukter. Se Dokumentation om övergång av en ny handelsprenumeration för konvertering av utvärderingsversioner av ny handel till betalda prenumerationer

Du kan konvertera en utvärderingsprenumeration till betald.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder endast autentisering med App+User-autentiseringsuppgifter.
Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du efter Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID :t (customer-tenant-id).
Ett prenumerations-ID för en aktiv utvärderingsprenumeration.
Ett tillgängligt konverteringserbjudande.

Konvertera en utvärderingsprenumeration till en betald prenumeration via kod

Om du vill konvertera en utvärderingsprenumeration till en betald prenumeration måste du först skaffa en samling av tillgängliga utvärderingskonverteringar. Sedan måste du välja det konverteringserbjudande som du vill köpa.

Konverteringserbjudandena anger en kvantitet som är standard för samma antal licenser som utvärderingsprenumerationen. Du kan ändra den här kvantiteten genom att ange egenskapen Quantity till det antal licenser som du vill köpa.

Kommentar

Oavsett antalet köpta licenser återanvänds prenumerations-ID för utvärderingsversionen för de köpta licenserna. Därför försvinner utvärderingsversionen och ersätts av köpet.

Använd följande steg för att konvertera en utvärderingsprenumeration via kod:

Hämta ett gränssnitt till de prenumerationsåtgärder som är tillgängliga. Du måste identifiera kunden och ange prenumerationsidentifieraren för utvärderingsprenumerationen.
```
var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);
```
Hämta en samling tillgängliga konverteringserbjudanden. Mer information om begäran/svar för den här metoden finns i Hämta en lista över erbjudanden för utvärderingskonvertering.
```
var conversions = subscriptionOperations.Conversions.Get();
```
Välj ett konverteringserbjudande. Följande kod väljer det första konverteringserbjudandet i samlingen.
```
var selectedConversion = conversions.Items.ToList()[0];
```
Du kan också ange antalet licenser som ska köpas. Standardvärdet är antalet licenser i utvärderingsprenumerationen.
```
selectedConversion.Quantity = 10;
```
Anropa metoden Skapa eller SkapaAsync för att konvertera utvärderingsprenumerationen till betald.
```
var convertResult = subscriptionOperations.Conversions.Create(selectedConversion);
```

C#

Så här konverterar du en utvärderingsprenumeration till en betald prenumeration:

Använd metoden IAggregatePartner.Customers.ById med kund-ID:t för att identifiera kunden.
Hämta ett gränssnitt för prenumerationsåtgärder genom att anropa metoden Subscriptions.ById med utvärderingsprenumerations-ID:t. Spara en referens till prenumerationsåtgärdernas gränssnitt i en lokal variabel.
Använd egenskapen Konverteringar för att hämta ett gränssnitt till de tillgängliga åtgärderna för konverteringar och anropa sedan metoden Get eller GetAsync för att hämta en samling tillgängliga konverteringserbjudanden. Du måste välja en. Följande exempel är standardvärdet för den första tillgängliga konverteringen.
Använd referensen till prenumerationsåtgärdernas gränssnitt som du sparade i en lokal variabel och egenskapen Konverteringar för att hämta ett gränssnitt till de tillgängliga åtgärderna för konverteringar.
Skicka det valda konverteringserbjudandeobjektet till metoden Skapa eller SkapaAsync för att försöka konvertera utvärderingsversionen.

C#-exempel

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

REST-begäran

Syntax för begäran

Metod	URI för förfrågan
POST	{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/conversions HTTP/1.1

URI-parameter

Använd följande sökvägsparametrar för att identifiera kunden och utvärderingsprenumerationen.

Namn	Type	Obligatoriskt	Beskrivning
kund-ID	sträng	Ja	En GUID-formaterad sträng som identifierar kunden.
prenumerations-ID	sträng	Ja	En GUID-formaterad sträng som identifierar utvärderingsprenumerationen.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

En ifylld konverteringsresurs måste ingå i begärandetexten.

Exempel på begäran

POST https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/conversions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: bd0cde7f-ba87-4010-8a73-1190b641f2a4
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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-svar

Om det lyckas innehåller svarstexten en ConversionResult-resurs .

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Felkoder för Partnercenter.

Svarsexempel

HTTP/1.1 200 OK
Content-Length: 211
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: bd0cde7f-ba87-4010-8a73-1190b641f2a4
MS-CV: kW4GzmhvHEqCq1ls.0
MS-ServerId: 030020643
Date: Thu, 15 Jun 2017 23:10:40 GMT

 {
    "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
    "offerId": "C0BD2E08-11AC-4836-BDC7-3712E744922F",
    "targetOfferId": "031C9E47-4802-4248-838E-778FB1D2CC05",
    "attributes": {
        "objectType": "ConversionResult"
    }
}

Dela via