Ottenere nuovi eventi di migrazione commerciale
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"
}
]