Overgangen verkrijgen

Artikel
03/09/2025

Van toepassing op

Partnercentrum

Juiste rollen

Beheerderagent

Notitie

De nieuwe commerce-ervaringen voor services op basis van licenties omvatten veel nieuwe mogelijkheden en zijn beschikbaar voor alle CSP's (Cloud Solution Provider). Voor meer informatie, zie overzicht van nieuwe commerce-ervaringen.

Wordt gebruikt om de geschiedenis van overgangen voor een bepaalde klant en een bepaald abonnement op te halen. De geschiedenis bevat alle gebeurtenissen die zijn verwerkt voor de overgang. Dit ondersteunt alleen abonnementsovergangen op basis van nieuwe commercelicenties.

Vereisten

Inloggegevens zoals beschreven in Partner Center-authenticatie. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.
Een klant-ID (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in het Partnercentrum door eerst de werkruimte Klanten te selecteren, dan de klant uit de klantenlijst en vervolgens Account. Zoek op de Klantaccountpagina naar de Microsoft-id in de Klantaccountgegevenssectie. De Microsoft ID is hetzelfde als de klant ID (customer-tenant-id).
Eén abonnements-id voor het overgangsabonnement.

REST-aanvraag

[GET] klanten/{customer-tenant-id}/abonnementen/{subscription-id}/transitions

Aanvraagsyntaxis

Wijze	Aanvraag-URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions HTTP/1.1

URI-parameter

Gebruik de volgende queryparameters om in aanmerking komende overgangen te retourneren.

Name	Type	Vereist	Beschrijving
klant-huurder-id	Guid	Y	Een GUID die overeenkomt met de tenant van de klant.
subscription-id	Richtlijn	J	Een GUID die overeenkomt met het eerste abonnement.
operation-id	Guid	N	Een GUID om een overgang uniek te identificeren en de status ervan bij te houden.

Aanvraagheaders

Voor meer informatie, zie REST-koppen van Partnercentrum.

Aanvraaglichaam

Geen

Aanvraagvoorbeeld

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/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

REST-antwoord

Als dit lukt, retourneert dit een geschiedenis van overgangen voor het opgegeven abonnement.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die het succes of de mislukking aangeeft en aanvullende debugginginformatie. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Voor de volledige lijst, zie Foutcodes.

Responsvoorbeeld

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

{
    "transition": [
        {
        "operationId": "1caf8ec7-62cc-4ab5-b35d-572d2a62974c", 
        "FromCatalogItemId": "CFQ7TTC0LDPB:0001:CFQ7TTC0LGNT",
        "ToCatalogItemId": "CFQ7TTC0LF8S:0001:CFQ7TTC0K9G9",
        "quantity": 1,
        "transitionType": "transition_with_license_transfer",
        "Events": [
           {
               "name": "Conversion",
               "status": "Started ",
               "timestamp": "2021-01-08T18:01:14.7488618Z",
               "attributes":
                     {
                          "objectType": "TransitionEvent"
                     }
           }, 
           {
               "name": "Conversion",
               "status": "Completed",
               "timestamp": "2021-01-08T18:37:41.591855Z",
               "attributes":
                     {
                          "objectType": "TransitionEvent"
                     }
            }
        ],
        "attributes":
               {
                     "objectType": "Transition"
               }
        }
    ],
    "attributes":
        {
               "objectType": "Collection"
        }
}

Delen via