Ottenere nuovi eventi di migrazione commerciale

Articolo
10/01/2024

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 descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali app autonome e 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:

A CustomerTenantId. Se non si conosce l'ID del cliente, è possibile cercarlo nel 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 l'ID Microsoft nella sezione Informazioni sull'account del 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/new commerce/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.
CurrentSubscriptionId	Stringa in formato GUID che identifica una sottoscrizione legacy migrata.

Intestazioni delle richieste

Per altre informazioni, vedi 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 della sottoscrizione corrente di cui è stata eseguita la migrazione nel corpo della risposta.

Codici di errore e di esito 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, vedi Codici di errore REST del Centro per i partner.

Esempi di URL di richiesta

baseurl/v1/customers/948ebea1-0fe5-4e45-8f2e-900288b7883e/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": "948ebea1-0fe5-4e45-8f2e-900288b7883e",
        "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": "948ebea1-0fe5-4e45-8f2e-900288b7883e",
        "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": "948ebea1-0fe5-4e45-8f2e-900288b7883e",
        "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": "948ebea1-0fe5-4e45-8f2e-900288b7883e",
        "createdTime": "2022-06-11T00:10:07.6947014Z",
        "eventName": "MigrationCompleted"
    }
]

Condividi tramite