Umstellung eines neuen Commerce-Abonnements

Gilt für: Partner Center | Partner Center betrieben von 21Vianet | Partner Center für Microsoft Cloud for US Government

Geeignete Rollen

Administrator-Agent

Diese Methoden unterstützen sowohl herkömmliche als auch neue Commerce-Quellabonnements.

Hinweis

Die neuen Commerce-Erfahrungen für lizenzbasierte Dienste umfassen viele neue Funktionen und sind für alle Cloud Solution Provider (CSPs) verfügbar. Weitere Informationen finden Sie unter Übersicht über New Commerce.

Wird verwendet, um das neue Commerce-Abonnement eines Kunden auf ein Zielabonnement zu aktualisieren oder eine NCE-Testversion in ein kostenpflichtiges Abonnement zu konvertieren. Um ein Abonnement zu übertragen, müssen zwei API-Anforderungen gestellt werden. Rufen Sie zunächst GET eligible transitions auf, um die für ein Upgrade verfügbaren SKUs zu erhalten. Dann POST transition verwenden, um den Übergang auszuführen.

Berechtigungen für Übergänge abrufen

Gibt eine Liste berechtigter Übergänge für einen bestimmten Kunden, ein Abonnement und einen angeforderten Typ zurück. Gibt auch die Berechtigung zum Upgrade des Zielabonnements zurück. Die Berechtigungsberechtigungen für Die Umstellung können Angebote enthalten, die sich im Status "EndofSaleWithConversions" befinden.

Voraussetzungen

Anmeldeinformationen, wie in Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.
Eine Kunden-ID (customer-tenant-id). Wenn Sie die ID des Kunden nicht kennen, können Sie sie in Partner Center nachschlagen, indem Sie den Arbeitsbereich Kunden, dann den Kunden aus der Kundenliste und anschließend Konto auswählen. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinformationen nach der Microsoft-ID. Die Microsoft-ID ist identisch mit der Kunden-ID (customer-tenant-id).
Eine Abonnement-ID für das anfängliche Abonnement.

GDAP-Rollen

Sie benötigen mindestens eine der folgenden GDAP-Rollen:

Verzeichnis lesen
Globaler Leser

Hinweis

Obwohl diese API für Legacy und NCE verfügbar ist, ist GDAP nur für legacy erforderlich.

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitionEligibilities?eligibilityType={immediate, scheduled} HTTP/1.1

URI-Parameter

Verwenden Sie die folgenden Abfrageparameter, um berechtigte Übergänge zurückzugeben.

Name	Typ	Erforderlich	Beschreibung
customer-tenant-id	guid	Y	Eine GUID, die dem Mandanten des Kunden entspricht.
Abonnement-ID	guid	Y	Eine GUID, die dem anfänglichen Abonnement entspricht.
eligibilityType	String	N	Beschreibt, wann der Übergang ausgeführt werden soll; kann sofort oder geplant sein. Der Standardwert ist `Immediate`.

Anfrage-Header

Weitere Informationen finden Sie unter Partner Center REST-Header.

Anforderungstext

Keine

Beispielanfrage

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-Antwort

Bei erfolgreicher Ausführung gibt diese Methode im Antworttext eine Liste der zulässigen Übergänge für das angegebene Abonnement zurück.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler und weitere Debuginformationen angibt. Verwenden Sie ein Netzwerkablaufverfolgungstool, um diesen Code, fehlertyp und andere Parameter zu lesen. Die vollständige Liste finden Sie unter Fehlercodes.

Berechtigungsfehler

Fehlerbeschreibungen und Bedeutung.

Fehlerbeschreibung	Bedeutung
Abonnement kann nicht übertragen werden – Quellabonnement ist nicht aktiv.	Originalunterstatus nicht aktiv
Abonnement kann nicht übertragen werden – Quellabonnement ist noch nicht bereitgestellt.	Original sub FulfillmentState ist nicht erfolgreich
Der Übergangstyp ist nicht kompatibel . AzureAD-Abonnementzuordnung ist erforderlich.	LegacyCannotConvertSubscriptionId-Fehler beim Aufrufen von GetSubscriptionUpgradeConflicts
Der Übergangstyp ist nicht kompatibel – widersprüchliche Abonnements für die Lizenzübertragung sind vorhanden.	Wenn ein Microsoft Entra-Dienst Über Abonnement-IDs aus einem anderen Abonnement verfügt, fügen Sie ihn der Konfliktliste hinzu (umfasst Einkäufe, die entweder mit dem älteren oder dem modernen Kaufablauf getätigt wurden)

Fehler bei der Abonnementberechtigung

Wenn ein Zielabonnement nicht zum Upgrade berechtigt ist, wird einer der folgenden Gründe zurückgegeben.

Leere Listen werden zurückgegeben, wenn das Quellabonnement eine Testversion ist oder wenn der eligibilityType als Scheduled angegeben ist. Sie können nur durch eine sofortige Umstellung (auch als „Midterm“ bezeichnet) in ein vorhandenes Abonnement wechseln, nicht durch eine geplante Änderung.

Fehlerbeschreibung	Fehlercode
Das Abonnement ist nicht aktiv.	SubscriptionNotActive = 1
Das Abonnement befindet sich innerhalb des Kündigungsfensters.	SubscriptionInCancellationWindow = 2
Die Laufzeitdauer des Abonnements ist kürzer als die Laufzeitdauer des Quellabonnements.	SubscriptionTermDurationShorterThanSourceTermDuration = 3
Das Enddatum der Abonnementlaufzeit liegt vor dem Enddatum der Quellabonnementlaufzeit.	Das Enddatum der Abonnementlaufzeit liegt vor dem Enddatum der Quellabonnementlaufzeit. = 4

Beispielantwort

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

Antwortbeispiel für zulässige Übergangsdaten

Bestimmte SKUs mit einer Laufzeit von drei Jahren und mit Teams ermöglichen Partnern in Europa den Wechsel zu SKUs ohne Teams. Diese Übergänge können nur an den Jahrestagen erfolgen, die im Ergebnis der Übergangsberechtigung und in den zulässigen Daten definiert sind.

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": 1, 
    "items": [ 
        { 
            "catalogItemId": "CFQ7TTBZZR6H:001L:CFQ7TTC0K994", 
            "title": "Microsoft 365 E7 - 3 year", 
            "description": "Microsoft 365 E5, Microsoft 365 Copilot, Agent 365, and Entra Suite. This per-user licensed suite of products offers customers the latest, most advanced, productivity, security, and AI for user and user's agents.", 
            "quantity": 100, 
            "subscriptionEligibilities": [], 
            "transitionAllowedDates": ["2026-08-01T00:00:00Z", "2027-08-01T00:00:00Z"],  // This field will show up only if applicable 
            "eligibilities": [ 
                { 
                    "isEligible": true, 
                    "transitionType": "transition_only", 
                    "errors": [] 
                }, 
                { 
                    "isEligible": true, 
                    "transitionType": "transition_with_license_transfer", 
                    "errors": [] 
                } 
            ], 
            "attributes": { 
                "objectType": "TransitionEligibility" 
            } 
        }] 
}

Nach dem Übergang

Veröffentlicht eine Übergangsanforderung für einen bestimmten Kunden und ein bestimmtes Abonnement. Gibt den Übergang mit seinem Anfangsstatus zurück.

Voraussetzungen

Anmeldeinformationen, wie in Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.
Eine Kunden-ID (customer-tenant-id). Wenn Sie die ID des Kunden nicht kennen, können Sie sie in Partner Center nachschlagen, indem Sie den Arbeitsbereich Kunden, dann den Kunden aus der Kundenliste und anschließend Konto auswählen. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinformationen nach der Microsoft-ID. Die Microsoft-ID ist identisch mit der Kunden-ID (customer-tenant-id).
Eine Abonnement-ID für das anfängliche Abonnement.

GDAP-Rollen

Sie benötigen mindestens eine der folgenden GDAP-Rollen:

Verzeichnisleser oder Global Reader (nur für den Übergang)
Directory Writer (Übergang mit Lizenzübertragung)

Hinweis

Obwohl diese API für Legacy und NCE verfügbar ist, ist GDAP nur für legacy erforderlich.

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
POST	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions HTTP/1.1

URI-Parameter

Verwenden Sie die folgenden Abfrageparameter, um einen Übergang auszuführen.

Name	Typ	Erforderlich	Beschreibung
customer-tenant-id	guid	Y	Eine GUID, die dem Mandanten des Kunden entspricht.
Abonnement-ID	guid	Y	Eine GUID, die dem ursprünglichen Abonnement entspricht.

Anfrage-Header

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Diese Tabelle beschreibt die Transition-Eigenschaften im Anforderungstext.

Eigenschaft	Typ	Erforderlich	Beschreibung
fromCatalogItemId	Zeichenfolge	Nein	Das Katalogelement, von dem Sie wechseln.
fromSubscriptionId	Zeichenfolge	Nein	Die Abonnement-ID, von der Sie wechseln.
toCatalogItemId	Zeichenfolge	Ja	Das Katalogelement, zu dem Sie wechseln.
toSubscriptionId	Zeichenfolge	Nein	Die Abonnement-ID, zu der Sie wechseln.
Menge	integer	Ja	Die Anzahl der Lizenzen für den Übergang.
termDuration	Zeichenfolge	Nein	Angeben der Laufzeit des Abonnements.
billingCycle	Zeichenfolge	Nein	Festlegen des Abrechnungszeitraums des Abonnements.
transitionType	Zeichenfolge	Ja	Der Übergangstyp. Mögliche Werte – `transition_only`, `transition_with_license_transfer`.

Beispielanfrage

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-Antwort

Bei erfolgreicher Ausführung gibt diese Methode eine Transition-Ressource mit ihrem initialen Status zurück.

Erfolgs- und Fehlercodes der Antwort

Beispielantwort

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

Feedback

War diese Seite hilfreich?

Last updated on 2026-06-19

Umstellung eines neuen Commerce-Abonnements

Berechtigungen für Übergänge abrufen

Voraussetzungen

GDAP-Rollen

REST-Anforderung

Anforderungssyntax

URI-Parameter

Anfrage-Header

Anforderungstext

Beispielanfrage

REST-Antwort

Erfolgs- und Fehlercodes der Antwort

Berechtigungsfehler

Fehler bei der Abonnementberechtigung

Beispielantwort

Antwortbeispiel für zulässige Übergangsdaten

Nach dem Übergang

Voraussetzungen

GDAP-Rollen

REST-Anforderung

Anforderungssyntax

URI-Parameter

Anfrage-Header

Anforderungstext

Beispielanfrage

REST-Antwort

Erfolgs- und Fehlercodes der Antwort

Beispielantwort

Feedback

Zusätzliche Ressourcen