Eseguire query sulle nuove migrazioni commerciali

Articolo
09/20/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 eseguire una query per le sottoscrizioni migrate in base all'ID cliente, all'ID sottoscrizione corrente o all'ID riferimento esterno

Ruoli appropriati: Agente amministratore | Agente di vendita

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ò filtrare in base alle stringhe di query selezionate dal partner. Le stringhe di query selezionate possono essere una delle tre 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)
ExternalReferenceId (ID batch restituito dallo strumento di migrazione batch disponibile per il download tramite l'SDK del Centro per i partner)

Richiesta REST

Sintassi della richiesta

metodo	URI della richiesta
GET	{baseURL}/v1/migrations/new commerce HTTP/1.1

Stringhe di query

Questa tabella elenca le stringhe di query necessarie per filtrare e recuperare nuove migrazioni commerciali. Per eseguire correttamente query sulle migrazioni, è necessario almeno uno dei tre ID. L'input di più ID per la query viene accettato ma non obbligatorio.

Nome	Descrizione
CustomerTenantId	Stringa in formato GUID che identifica il cliente.
CurrentSubscriptionId	Stringa in formato GUID che identifica una sottoscrizione legacy migrata.
ExternalReferenceId	Stringa in formato GUID che identifica il batch di migrazione.

Intestazioni delle richieste

Per altre informazioni, vedi Intestazioni REST del Centro per i partner. La risposta dell'API restituisce un massimo di 300 record di pagina. Se in una query immessa vengono restituiti più di 300 record, nell'intestazione della risposta viene fornito un token di continuazione. Il token di continuazione può essere immesso nell'intestazione di una richiesta seguente per restituire record di pagina aggiuntivi sottoposti a query.

Testo della richiesta

Nessuno.

Risposta REST

In caso di esito positivo, questo metodo restituisce i dettagli delle sottoscrizioni di cui è stata eseguita la migrazione (oggetto migrazione) nel corpo della risposta. Sono inclusi l'ID migrazione.

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/migrations/newcommerce?CustomerTenantId=83c51838-fed5-44a4-a275-afa201d53699&CurrentSubscriptionId=6CCC6A93-93E4-4382-AF1F-E51237232833&ExternalReferenceId=9ab61899-0b2b-4320-bd6d-8196c53607d6

baseurl/v1/migrations/newcommerce?CurrentSubscriptionId=6CCC6A93-93E4-4382-AF1F-E51237232833

Esempi di risposta

[
{
"addOnMigrations": [],
"id": "8ce7115e-0324-41b1-8ca3-7c7ae3b64f75",
"startedTime": "2022-02-24T23:50:30.4384819Z",
"completedTime": "2022-02-24T23:53:14.0813711Z",
"currentSubscriptionId": "9E289691-2FF3-419D-B39B-26B3E5A817FB",
"status": "Completed",
"customerTenantId": "ce6fcc21-c276-447b-9605-874decb9024b",
"catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
"newCommerceSubscriptionId": "f2d6534b-9e30-4cf5-c7b0-5d6393dbf12d",
"newCommerceOrderId": "09714c93092a",
"subscriptionEndDate": "2023-02-14T00:00:00Z",
"quantity": 2,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"externalReferenceId": "771317a4-275d-47d9-9724-3eefa4a168ad"
}
]

Condividi tramite