Megosztás a következőn keresztül:

Átmenetek lekérése

  • Cikk

A következőkre vonatkozik

  • Partnerközpont

Megfelelő szerepkörök

  • Rendszergazdai ügynök

Feljegyzés

A licencalapú szolgáltatások új kereskedelmi szolgáltatásai számos új képességet tartalmaznak, és minden Felhőszolgáltató (CSP) számára elérhetők. További információkért tekintse meg az új kereskedelmi élmények áttekintését.

Egy adott ügyfél és előfizetés áttűnési előzményeinek lekérésére szolgál. Az előzmény az áttűnéshez feldolgozott összes eseményt tartalmazza. Ez csak az új kereskedelmi licencalapú előfizetés-áttűnéseket támogatja.

Előfeltételek

  • Hitelesítő adatok a Partnerközpont hitelesítése szerint. Ez a forgatókönyv támogatja az önálló alkalmazással és az App+Felhasználói hitelesítő adatokkal való hitelesítést is.

  • Ügyfélazonosító (customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpont-ban az Ügyfelek munkaterület kiválasztásával, majd az ügyféllistából az ügyfelet kiválasztva, majd a Fiók részt. Az ügyfél Fiók oldalán keresse meg a Microsoft ID-t az Ügyfél fiókinformációk szakaszban. A Microsoft azonosító megegyezik az ügyfél azonosítóval (customer-tenant-id).

  • Egy előfizetés-azonosító az áttűnt előfizetéshez.

REST-kérés

[GET] ügyfelek/{customer-tenant-id}/subscriptions/{subscription-id}/transitions

Kérés szintaxisa

Metódus Kérés URI-ja
GET {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions HTTP/1.1

URI-paraméter

A következő lekérdezési paraméterekkel visszaadhatja a jogosult átmeneteket.

Név Típus Kötelező Leírás
ügyfél-bérlő-azonosító Guid Y Az ügyfél bérlőjének megfelelő GUID.
előfizetés-azonosító Guid Y A kezdeti előfizetésnek megfelelő GUID.
műveletazonosító Guid N GUID azonosító egy tranzíció egyedi azonosításához és állapotának nyomon követéséhez.

Kérésfejlécek

További információért lásd: Partner Center REST fejlécek.

Kérés tartalma

Egyik sem

Példa kérése

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-válasz

Ha sikeres, ez visszaadja a megadott előfizetés átmeneti történetét.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. A kód, a hibatípus és a további paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát lásd a Hibakódok-ban.

Példa válaszra

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