Ottenere nuovi eventi di migrazione commerciale

Articolo
03/07/2025

si applica a: Centro per i partner | Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti

Come ottenere i dettagli degli eventi di migrazione in base all'ID sottoscrizione o all'ID migrazione correnti

Prerequisiti

Credenziali come descritte in autenticazione del Partner Center. Questo scenario supporta l'autenticazione sia con le credenziali App autonome che con le credenziali App+Utente.

Questa API può ottenere eventi di migrazione in base alle stringhe di query selezionate dal partner. Le stringhe di query selezionate possono includere le opzioni seguenti:

Un CustomerTenantId. Se non si conosce l'ID del cliente, è possibile cercarlo in Centro per i partner selezionando l'area di lavoro clienti, quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina Account del cliente cercare il ID Microsoft nella sezione informazioni sull'account cliente. L'ID Microsoft corrisponde all'ID cliente.
CurrentSubscriptionId (ID legacy per una sottoscrizione di cui è stata eseguita la migrazione)
MigrationId (ID dell'oggetto di migrazione associato alla sottoscrizione corrente)

Richiesta REST

Sintassi della richiesta

Metodo	URI della richiesta
GET	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/events HTTP/1.1

Stringhe di query

Questa tabella elenca le stringhe di query che possono essere usate per recuperare nuovi eventi di migrazione commerciale. Per recuperare correttamente gli eventi di migrazione associati a una sottoscrizione corrente, è necessario almeno uno dei due ID. L'input sia dell'ID migrazione che dell'ID sottoscrizione corrente è accettato ma non obbligatorio.

Nome	Descrizione
MigrationId	Stringa in formato GUID che identifica l'oggetto migrazione.
IDAbbonamentoCorrente	Una stringa in formato GUID che identifica una sottoscrizione legacy migrata.

Intestazioni della richiesta

Per altre informazioni, vedere intestazioni REST del Centro per i partner.

Corpo della richiesta

Nessuno.

Risposta REST

In caso di esito positivo, questo metodo restituisce i dettagli dell'evento dell'Sottoscrizione corrente di cui è stata eseguita la migrazione nel corpo della risposta.

Codici di errore e esito positivo della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug. Usare uno strumento di traccia di rete per leggere questo codice, il tipo di errore e altri parametri. Per l'elenco completo, vedere codici di errore REST del Centro per i partner.

Esempi di URL di richiesta

baseurl/v1/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/migrations/newcommerce/events?current_subscription_id=02DF825B-D0C9-40BE-8CB6-BAC895510D0A

Esempi di risposta

[
    {
        "id": "6eb07675-ba1d-45c2-9d05-c693a4863427",
        "newCommerceMigrationId": "e4c1c037-7c4c-42bd-bb41-dae2aa29ebcc",
        "currentSubscriptionId": "02df825b-d0c9-40be-8cb6-bac895510d0a",
        "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "createdTime": "2022-06-11T00:06:02.7529574Z",
        "eventName": "MigrationStarted"
    },
    {
        "id": "e828079b-c974-4822-977e-f12ac67380db",
        "newCommerceMigrationId": "e4c1c037-7c4c-42bd-bb41-dae2aa29ebcc",
        "currentSubscriptionId": "02df825b-d0c9-40be-8cb6-bac895510d0a",
        "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "createdTime": "2022-06-11T00:06:21.526778Z",
        "eventName": "NewCommerceSubscriptionCreated"
    },
    {
        "id": "7dbdcbd5-7a87-4d9b-bf1f-d9298493e631",
        "newCommerceMigrationId": "e4c1c037-7c4c-42bd-bb41-dae2aa29ebcc",
        "currentSubscriptionId": "02df825b-d0c9-40be-8cb6-bac895510d0a",
        "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "createdTime": "2022-06-11T00:08:08.5185085Z",
        "eventName": "NewCommerceSubscriptionProvisioned"
    },
    {
        "id": "71a3f753-55ca-461e-807d-f541685d5c8b",
        "newCommerceMigrationId": "e4c1c037-7c4c-42bd-bb41-dae2aa29ebcc",
        "currentSubscriptionId": "02df825b-d0c9-40be-8cb6-bac895510d0a",
        "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "createdTime": "2022-06-11T00:10:07.6947014Z",
        "eventName": "MigrationCompleted"
    }
]

Condividi tramite