Convalidare una sottoscrizione per la migrazione

Articolo
10/28/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 convalidare una sottoscrizione per la migrazione a Nuova esperienza commerciale

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. 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 Centro per i partner selezionando l'area di lavoro Clienti , quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina dell'account del cliente cerca l'ID Microsoft nella sezione Info account del cliente. L'ID Microsoft corrisponde all'ID del cliente (customer-tenant-id).
ID sottoscrizione corrente

Limite di frequenza

Il limite dell'API Convalida migrazione è di 450 chiamate per ogni combinazione di partner-cliente in 5 minuti. Altre informazioni sui limiti di velocità e sulla limitazione delle richieste sono disponibili in Linee guida per la limitazione delle RICHIESTE API.

Richiesta REST

Sintassi della richiesta

metodo	URI della richiesta
POST	{baseURL}/v1/customers/{customer-tenant-id}/migrations/new commerce/validate HTTP/1.1

Parametro URI

Questa tabella elenca i parametri di query necessari per convalidare una sottoscrizione per la migrazione.

Nome	Digita	Obbligatorio	Descrizione
customer-tenant-id	string	Sì	Stringa in formato GUID che identifica il cliente.
termDuration	string	No	La durata del termine può essere modificata al momento della migrazione.
billingCycle	string	No	Il ciclo di fatturazione può essere modificato al momento della migrazione.
purchaseFullTerm	bool	No	È possibile avviare un nuovo termine in NCE al momento della migrazione.
quantity	int	No	La quantità di licenze per una sottoscrizione può essere aumentata o ridotta al momento della migrazione.
customTermEndDate	datetime	No	È possibile impostare una data di fine per allinearsi a una sottoscrizione onlineservicesNCE esistente o a un mese di calendario. Altre informazioni sull'allineamento delle date di fine della sottoscrizione sono disponibili qui: Allineare le date di fine della sottoscrizione nel Centro per i partner

Intestazioni delle richieste

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Testo della richiesta

Questa tabella descrive le proprietà della sottoscrizione nel corpo della richiesta.

Proprietà	Type	Obbligatorio	Descrizione
currentSubscriptionId	string	Sì	Identificatore di sottoscrizione che indica quale sottoscrizione richiede la convalida per la migrazione.

Esempio di richiesta

"currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"

Risposta REST

In caso di esito positivo, questo metodo restituisce un valore booleano "isEligible" nel corpo della risposta, che indica se la sottoscrizione corrente è idonea per la migrazione a un nuovo commercio. Nota, l'API Convalida migrazione non fornisce informazioni sull'idoneità di una sottoscrizione per le promozioni in New Commerce.

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 le informazioni di debug aggiuntive. 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 risposta

1. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": false,
        "errors": [
            {
                "code": 5,
                "description": "Subscription cannot be migrated to New Commerce because the equivalent offer is not yet available in New Commerce",
            }
        ]
    }

2. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": true,
        "catalogItemId": "CFQ7TTC0LF8S:0002:CFQ7TTC0KSVV"
    }

Condividi tramite