Získat přechody

Článek
03/07/2025

Platí pro

Partnerské centrum

Odpovídající role

Agent pro správu

Poznámka:

Nové komerční prostředí pro služby založené na licencích zahrnují mnoho nových funkcí a jsou k dispozici pro všechny poskytovatele cloudových řešení (CSP). Pro více informací se podívejte na přehled nových obchodních prostředí.

Používá se k získání historie přechodů pro daného zákazníka a předplatného. Historie zahrnuje všechny události, které byly zpracovány pro přechod. Podporuje to pouze přechody předplatných založených na novém komerčním licencování.

Požadavky

Přihlašovací údaje, jak jsou popsány v Partnerském centru ověřování. Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů pro aplikaci a kombinovaných přihlašovacích údajů pro aplikaci a uživatele.
ID zákazníka (customer-tenant-id). Pokud neznáte ID zákazníka, můžete ho vyhledat v Partnerském centru, a to tak, že zvolíte pracovní prostor Zákazníci, poté zákazníka ze seznamu zákazníků a nakonec účet. Na stránce účtu zákazníka vyhledejte ID Microsoft v části Informace o účtu zákazníka. Microsoft ID je stejné jako ID zákazníka (customer-tenant-id).
Jedno ID předplatného pro převedené předplatné

Požadavek REST

[GET] zákazníci/{customer-tenant-id}/subscriptions/{subscription-id}/transitions

Syntaxe požadavku

metoda	Identifikátor URI žádosti
GET	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions HTTP/1.1

Parametr identifikátoru URI

K vrácení oprávněných přechodů použijte následující parametry dotazu.

Name	Typ	Požadováno	Popis
ID zákazníka-nájemce	GUID	Y	Identifikátor GUID odpovídající nájemnímu prostředí zákazníka.
id-předplatného	guid	Y	Identifikátor GUID odpovídající počátečnímu předplatnému.
id operace	guid	N	Identifikátor GUID, který jednoznačně identifikuje přechod a sleduje jeho stav.

Záhlaví žádosti

Další informace najdete v Hlavičky REST Partner Center.

Text požadavku

Nic

Příklad požadavku

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

Odpověď REST

V případě úspěchu se vrátí historie přechodů pro poskytnuté předplatné.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v Kódy chyb.

Příklad odpovědi

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

Sdílet prostřednictvím