Ottenere transizioni

Articolo
03/07/2025

Si applica a

Centro per i partner

Ruoli appropriati

Agente di amministrazione

Nota

Le nuove esperienze commerciali per i servizi basati su licenza includono molte nuove funzionalità e sono disponibili per tutti i provider di soluzioni cloud. Per ulteriori informazioni, vedere la panoramica delle nuove esperienze commerciali.

Usato per ottenere la cronologia delle transizioni per un cliente e una sottoscrizione specificati. La cronologia include tutti gli eventi elaborati per la transizione. Questo supporta solo le nuove transizioni di sottoscrizione basate su licenza commerciale.

Prerequisiti

Credenziali come descritto in Autenticazione del Partner Center. Questo scenario supporta l'autenticazione con le credenziali app autonome e App+Utente.
ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo nel Partner Center selezionando l'area di lavoro Clienti, e poi selezionando il cliente nella lista dei clienti, quindi Account. Nella pagina dell'Account del cliente cerca l'ID Microsoft nella sezione Informazioni sull'account del cliente. L'ID Microsoft è lo stesso dell'ID cliente (customer-tenant-id).
Un'ID di sottoscrizione per la sottoscrizione convertita.

Richiesta REST

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

Sintassi della richiesta

metodo	URI della richiesta
GET	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions HTTP/1.1

Parametro URI

Usare i parametri di query seguenti per restituire transizioni idonee.

Nome	Digita	Obbligatorio	Descrizione
customer-tenant-id	guid	Y	Un GUID corrispondente al tenant del cliente.
id-abbonamento	guid	Y	GUID corrispondente all'abbonamento iniziale.
operation-id	GUID	N	GUID per identificare in modo univoco una transizione e tenere traccia dello stato.

Intestazioni delle richieste

Per ulteriori informazioni, consultare Intestazioni REST del Centro partner.

Testo della richiesta

None

Esempio di richiesta

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

Risposta REST

In caso di esito positivo, viene restituita una cronologia delle transizioni per la sottoscrizione specificata.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore.

Risposta di esempio

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

Condividi tramite