Dela via


Hämta övergångar

Gäller för

  • Partnercenter

Lämpliga roller

  • Administratörsagent

Anteckning

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 hämta historiken för övergångar för en viss kund och prenumeration. Historiken innehåller alla händelser som bearbetats för övergången. Detta stöder endast nya övergångar för licensbaserade prenumerationer för handel.

Förutsättningar

  • Autentiseringsuppgifter 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 Partner Center 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 detsamma som kund ID (customer-tenant-id).

  • Ett prenumerations-ID för den övergångna prenumerationen.

REST-begäran

[GET] kunder/{customer-tenant-id}/abonnemang/{subscription-id}/övergångar

Syntax för förfrågan

Metod URI för förfrågan
GET {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions 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.
operation-id GUID N Ett GUID för att unikt identifiera en övergång och spåra dess status.

Begärandehuvuden

För mer information, se Partner Center REST headers.

Begäranens innehåll

Ingen

Exempel på begäran

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

Om det lyckas returnerar detta en historik över övergångar för den angivna prenumerationen.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. För hela listan, se 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

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