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 come descritto in Partner Center autenticazione. Questo scenario supporta l'autenticazione con credenziali di app autonoma e App+Utente.

  • ID del cliente (customer-tenant-id). 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 l'ID Microsoft nella sezione informazioni account cliente. L'ID Microsoft corrisponde all'ID cliente (customer-tenant-id).

  • ID della sottoscrizione corrente

Limite di velocità

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

Richiesta REST

Sintassi della richiesta

Metodo URI della richiesta
POST {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/validate HTTP/1.1

Parametro URI

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

Nome Digitare Obbligatorio Descrizione
ID cliente-tenant corda Sì Stringa in formato GUID che identifica il cliente.
durata del termine corda No La durata del termine può essere modificata al momento della migrazione.
ciclo di fatturazione corda No Il ciclo di fatturazione può essere modificato al momento della migrazione.
acquistoTermineCompleto Bool No È possibile avviare un nuovo termine in NCE al momento della migrazione.
quantità Int No La quantità di licenze per una sottoscrizione può essere aumentata o ridotta al momento della migrazione.
customTermEndDate data e ora No È possibile impostare una data di fine per allinearla a una sottoscrizione esistente di OnlineServicesNCE o a un mese di calendario. Qui sono disponibili altre informazioni sull'allineamento delle date di fine della sottoscrizione: Allineare le date di fine della sottoscrizione nel Centro per i partner

Intestazioni della richiesta

Per altre informazioni, vedere intestazioni REST del Centro per i partner.

Corpo della richiesta

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

Proprietà Digitare Obbligatorio Descrizione
currentSubscriptionId corda 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 modello commerciale. Nota, l'API Convalida migrazione non fornisce informazioni sull'idoneità di una sottoscrizione per le promozioni in New Commerce.

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 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, vedere 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"
    }
  • Last updated on