Byta till en ny betald prenumeration

Artikel
09/25/2024

Gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government

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). Mer information finns i ö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örsta GET-berättigade övergångar för att få SKU:er tillgängliga för uppgradering. Sedan postövergång för att kö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å berättigande till uppgradering av målprenumeration. Övergångsberättiganden kan innehålla erbjudanden som är i tillståndet EndofSaleWithConversions.

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 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 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 äldre och NCE krävs ENDAST GDAP för äldre.

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.
eligibilityType	sträng	N	Beskriver när övergången ska köras; kan vara omedelbar eller schemalagd. Standard är `Immediate`.

Begärandehuvuden

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

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. Den fullständiga listan finns i Felkoder.

Berättigandefel

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 delunderavsnittet FulfillmentState lyckas inte
Övergångstypen är inte kompatibel – AzureAD-prenumerationsmappning krävs.	LegacyCannotConvertSubscriptionId-fel vid anrop av GetSubscriptionUpgradeConflicts
Övergångstypen är inte kompatibel – det finns prenumerationer i konflikt 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 eligibilityType 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 ett annulleringsfönster.	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 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 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 det här API:et är tillgängligt för äldre och NCE krävs ENDAST GDAP 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ärandehuvuden

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

Begärandetext

I den här tabellen beskrivs övergångsegenskaperna i begärandetexten.

Property	Type	Obligatoriskt	Beskrivning
fromCatalogItemId	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å.
termDuration	sträng	Nej	Ange prenumerationens varaktighet.
billingCycle	sträng	Nej	Ange faktureringscykeln för prenumerationen.
transitionType	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 det lyckas returnerar den här metoden en övergångsresurs med dess 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

Byta till en ny betald prenumeration

Hämta övergångsberättiganden

Förutsättningar

GDAP-roller

REST-begäran

Syntax för begäran

URI-parameter

Begärandehuvuden

Begärandetext

Exempel på begäran

REST-svar

Svarsframgång och felkoder

Berättigandefel

Fel om prenumerationsberättigande

Svarsexempel

Efter övergången

Förutsättningar

GDAP-roller

REST-begäran

Syntax för begäran

URI-parameter

Begärandehuvuden

Begärandetext

Exempel på begäran

REST-svar

Svarsframgång och felkoder

Svarsexempel

Feedback

Ytterligare resurser