Dela via

Byta till en ny betald prenumeration

  • Artikel

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

Lämpliga roller

  • global administratör
  • 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: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
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: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
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": "92301b7d-7598-4938-d6f2-d31e080e9da6",
          "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": "151467a1-4246-4a00-da7b-3405463d9b78",
          "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: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
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

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.

Svarsexempel

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
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" 
    }
}