Udostępnij za pośrednictwem

Uzyskaj przejścia

  • Artykuł

Dotyczy

  • Centrum partnerskie

Odpowiednie role

  • Agent administracyjny

Uwaga

Nowe środowiska handlowe dla usług opartych na licencjach oferują wiele nowych możliwości i są dostępne dla wszystkich Dostawców rozwiązań w chmurze (CSP). Aby uzyskać więcej informacji, zobacz omówienie nowych doświadczeń handlowych.

Służy do uzyskiwania historii przejść dla danego klienta i subskrypcji. Historia obejmuje wszystkie zdarzenia, które zostały przetworzone na potrzeby przejścia. Obsługiwane są tylko przejścia subskrypcji oparte na nowych licencjach handlowych.

Wymagania wstępne

  • Poświadczenia opisane w temacie Uwierzytelnianie w Centrum Partnerów. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu samodzielnych poświadczeń aplikacji, jak i poświadczeń aplikacji oraz użytkownika.

  • Identyfikator klienta (customer-tenant-id). Jeśli nie znasz identyfikatora klienta, możesz go wyszukać w Partner Center, wybierając obszar roboczy Klienci, następnie klienta z listy klientów, a potem sekcję Konto. Na stronie konta klienta poszukaj Microsoft ID w sekcji Informacje o koncie klienta. Identyfikator Microsoft jest taki sam, jak identyfikator klienta (customer-tenant-id).

  • Jeden identyfikator subskrypcji dla subskrypcji, która została przeniesiona.

Żądanie REST

Polecenie [GET] customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions służy do pobierania przejść subskrypcji dla klienta.

Składnia żądania

Metoda URI żądania
GET {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions HTTP/1.1

Parametr identyfikatora URI

Użyj następujących parametrów zapytania, aby zwrócić przejścia spełniające warunki.

Nazwisko Typ Wymagane opis
identyfikator dzierżawy klienta guid Y Identyfikator GUID odpowiadający tenantowi klienta.
identyfikator subskrypcji guid Y Identyfikator GUID odpowiadający początkowej subskrypcji.
identyfikator operacji guid N Identyfikator GUID umożliwiający unikatową identyfikację przejścia i śledzenie jego stanu.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

Brak

Przykład żądania

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

Odpowiedź REST

Jeśli operacja zakończy się pomyślnie, zwróci historię zmian dla podanej subskrypcji.

Kody sukcesu i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów.

Przykład odpowiedzi

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