Convalidare una sottoscrizione per la migrazione

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 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 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"
    }