Övergång till en ny kommersiell prenumeration

Artikel
03/07/2025

Gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud för den amerikanska regeringen

Lämpliga roller

Administratörsagent

Dessa metoder stöder både traditionella och nya prenumerationer på handelskällor.

Kommentar

De nya handelsupplevelserna för licensbaserade tjänster innehåller många nya funktioner och är tillgängliga för alla Molnlösningsleverantör (CSP:er). För mer information, se översikten över nya handelsupplevelser.

Används för att uppgradera en kunds nya handelsprenumeration till en målprenumeration eller konvertera en NCE-utvärderingsversion till en betald prenumeration. För att kunna överföra en prenumeration måste två API-begäranden göras. Först GET berättigade övergångar för att få SKU:er tillgängliga för uppgradering. Sedan POST transition för att utföra övergången.

Hämta övergångsberättiganden

Returnerar en lista över berättigade övergångar för en viss kund, prenumeration och begärd typ. Returnerar också målprenumerationens uppgraderingsberättigande. Övergångsberättiganden kan innehålla erbjudanden som är i EndofSaleWithConversions-tillståndet.

Förutsättningar

Inloggningsuppgifter enligt beskrivningen i Partner Center-autentisering. Det här scenariot stöder autentisering med både fristående app- och 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 i avsnittet Kundkontoinformation. Microsoft-ID är samma som kund-ID (customer-tenant-id).
Ett prenumerations-ID för den första prenumerationen.

GDAP-roller

Du behöver minst en av följande GDAP-roller:

Katalogläsare
Global läsare

Kommentar

Även om det här API:et är tillgängligt för både äldre versioner och NCE, krävs endast GDAP för äldre versioner.

REST-begäran

Syntax för begäran

Metod	URI för förfrågan
GET	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitionEligibilities?eligibilityType={immediate, scheduled} HTTP/1.1

URI-parameter

Använd följande frågeparametrar för att returnera berättigade övergångar.

Namn	Typ	Obligatoriskt	Beskrivning
customer-tenant-id	GUID	Y	Ett GUID som motsvarar kundens klientorganisation.
prenumerations-ID	guid	Y	Ett GUID som motsvarar den första prenumerationen.
berättigandetyp	sträng	N	Beskriver när övergången ska köras; kan vara omedelbar eller schemalagd. Default är .

Förfrågningsrubriker

För mer information, se Partnercenter REST-huvuden.

Begärandetext

Ingen

Exempel på begäran

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitionEligibilities?eligibilityType=immediate HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

REST-svar

Om det lyckas returnerar den här metoden en lista över berättigade övergångar för den angivna prenumerationen i svarstexten.

Svarsframgång och felkoder

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

Behörighetsfel

Felbeskrivningar och innebörd.

Felbeskrivning	Innebörd
Prenumerationen kan inte överföras – källprenumerationen är inte aktiv.	Ursprunglig understatus är inte Aktiv
Prenumerationen kan inte överföras – källprenumerationen har inte etablerats ännu.	Det ursprungliga undersystemet FulfillmentState är inte lyckat
Övergångstypen är inte kompatibel – AzureAD-prenumerationsmappning krävs.	LegacyCannotConvertSubscriptionId-fel vid anrop av funktionen GetSubscriptionUpgradeConflicts
Övergångstypen är inte kompatibel – det finns konflikterande prenumerationer för licensöverföring.	Om någon Microsoft Entra-tjänst har prenumerations-ID:t från en annan prenumeration lägger du till den i konfliktlistan (inkluderar inköp som gjorts med antingen äldre eller moderna inköpsflöden)

Fel om prenumerationsberättigande

Om en målprenumeration inte är berättigad att uppgraderas till returneras någon av följande orsaker.

Tomma listor returneras om källprenumerationen är en utvärderingsversion eller om behörighetstypen anges som schemalagd. Du kan bara övergå till en befintlig prenumeration med en omedelbar övergång (även kallat "halvtidsövergång", inte en schemalagd ändring.

Felbeskrivning	Felkod
Prenumerationen är inte aktiv.	SubscriptionNotActive = 1
Prenumerationen är inom ångerfristen.	SubscriptionInCancellationWindow = 2
Prenumerationsperiodens varaktighet är kortare än källprenumerationens varaktighet.	SubscriptionTermDurationShorterThanSourceTermDuration = 3
Slutdatumet för prenumerationsperioden är före källprenumerationens slutdatum.	Slutdatumet för prenumerationsperioden är före källprenumerationens slutdatum. = 4

Svarsexempel

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
  "totalCount": 2,
  "items": [
    {
      "operationId": "1caf8ec7-62cc-4ab5-b35d-572d2a62974c",
      "catalogItemId": "CFQ7TTC0KZCR:0001:CFQ7TTC0K71H",
      "title": "Microsoft 365 E5 Test Sku Title",
      "description": "Microsoft 365 E5 Test Sku Description",
      "quantity": 1,
      "subscriptionEligibilities": [
        {
          "isEligible": false,
          "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
          "subscriptionFriendlyName": "Microsoft 365 Business Premium",
          "subscriptionTermDuration": "P1M",
          "subscriptionBillingCycle": "monthly",
          "errors": [
            {
              "code": 3,
              "description": "The subscription's term duration is shorter than the source subscription's term duration."
            }
          ]
        },
        {
          "isEligible": true,
          "subscriptionId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
          "subscriptionFriendlyName": "Microsoft 365 Business Premium",
          "subscriptionTermDuration": "P1Y",
          "subscriptionBillingCycle": "monthly",
          "errors": []
        }
      ],
      "eligibilities": [
        {
          "isEligible": true,
          "transitionType": "transition_only",
          "errors": []
        },
        {
          "isEligible": false,
          "transitionType": "transition_with_license_transfer",
          "errors": [
            {
              "code": 3,
              "description": "Subscription cannot be transitioned because there are conflicting services."
            }
          ]
        }
      ],
      "attributes": {
        "objectType": "TransitionEligibility"
      }
    },
    {
      "operationId": "1caf8ec7-62cc-4ab5-b35d-572d2a62974c",
      "catalogItemId": "CFQ7TTC0L4M3:0001:CFQ7TTC0K78T",
      "title": "Business Premium Test Sku Title",
      "description": "Business Premium Test Sku Description",
      "quantity": 1,
      "eligibilities": [
        {
          "isEligible": false,
          "transitionType": "transition_with_license_transfer",
          "errors": [
            {
              "code": 3,
              "description": "Subscription cannot be transitioned because there are conflicting services."
            }
          ]
        }
      ],
      "attributes": {
        "objectType": "TransitionEligibility"
      }
    }
  ],
  "attributes": {
    "objectType": "Collection"
  }
}

Efter övergången

Publicerar en övergångsbegäran för en viss kund och prenumeration. Returnerar övergången med dess ursprungliga status.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående app- och App+User-autentiseringsuppgifter.
Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du söka efter det i Partner Center genom att välja Kunder-arbetsytan, sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du efter Microsoft-ID i avsnittet Kundkontoinformation. Microsoft-ID är samma som kund-ID (customer-tenant-id).
Ett prenumerations-ID för den första prenumerationen.

GDAP-roller

Du behöver minst en av följande GDAP-roller:

Katalogläsare eller global läsare (endast övergång)
Katalogskrivare (övergång med licensöverföring)

Kommentar

Även om detta API är tillgängligt för både äldre och NCE, krävs GDAP endast för äldre.

REST-begäran

Syntax för begäran

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

URI-parameter

Använd följande frågeparametrar för att köra en övergång.

Namn	Typ	Obligatoriskt	Beskrivning
customer-tenant-id	GUID	Y	Ett GUID som motsvarar kundens klientorganisation.
prenumerations-id	GUID	Y	Ett GUID som motsvarar den första prenumerationen.

Begäranhuvuden

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

Begärandetext

Denna tabell beskriver övergångsegenskaperna i begärandekroppen.

Egendom	Typ	Obligatoriskt	Beskrivning
frånKatalogArtikelId	sträng	Nej	Katalogobjektet som du övergår från.
fromSubscriptionId	sträng	Nej	Prenumerations-ID:t som du övergår från.
toCatalogItemId	sträng	Ja	Katalogobjektet som du övergår till.
toSubscriptionId	sträng	Nej	Det prenumerations-ID som du övergår till.
kvantitet	integer	Ja	Antalet licenser som ska övergå till nytt system.
periodensVaraktighet	sträng	Nej	Ange prenumerationens varaktighet.
billingCycle	sträng	Nej	Ange faktureringscykeln för prenumerationen.
övergångstyp	sträng	Ja	Övergångstypen. Möjliga värden - `transition_only`, `transition_with_license_transfer`.

Exempel på begäran

POST https://api.partnercenter.microsoft.com/v1/customers/{customerId}/subscriptions/{subscriptionId}/transitions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

{
    "fromCatalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0K39X",
    "fromSubscriptionId": "e487e8dc-421e-4275-cb42-3c1c8daccf70",
    "toCatalogItemId": "CFQ7TTC0LF8R:0001:CFQ7TTC0KCSV",
    "toSubscriptionId": "0af52192-4a2a-4364-d25b-c8ecab3a5697",
    "quantity": 2,
    "termDuration": "P1M",
    "billingCycle": "Monthly",
    "transitionType": "transition_only"
}

REST-svar

Om operationen lyckas returnerar den här metoden en Transition-resurs med sin ursprungliga status.

Svarsframgång och felkoder

Svarsexempel

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "fromCatalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0K39X",
    "fromSubscriptionId": "e487e8dc-421e-4275-cb42-3c1c8daccf70",
    "toCatalogItemId": "CFQ7TTC0LF8R:0001:CFQ7TTC0KCSV",
    "toSubscriptionId": "0af52192-4a2a-4364-d25b-c8ecab3a5697",
    "quantity": 2,
    "termDuration": "P1M",
    "billingCycle": "Monthly",
    "transitionType": "transition_only"
    "Events": [
        {
            "name": "Conversion",
            "status": "Started ",
            "timestamp": "2021-01-08T18:01:14.7488618Z",
            "attributes":
            {
                "objectType": "TransitionEvent"
            }
        }
    ],
    "attributes":
    {
        "objectType": "Transition" 
    }
}

Dela via

Övergång till en ny kommersiell prenumeration

Hämta övergångsberättiganden

Förutsättningar

GDAP-roller

REST-begäran

Syntax för begäran

URI-parameter

Förfrågningsrubriker

Begärandetext

Exempel på begäran

REST-svar

Svarsframgång och felkoder

Behörighetsfel

Fel om prenumerationsberättigande

Svarsexempel

Efter övergången

Förutsättningar

GDAP-roller

REST-begäran

Syntax för begäran

URI-parameter

Begäranhuvuden

Begärandetext

Exempel på begäran

REST-svar

Svarsframgång och felkoder

Svarsexempel

Feedback

Ytterligare resurser