Creare una nuova 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 creare una migrazione di una sottoscrizione a New Commerce Experience

Prerequisiti

  • Credenziali come descritto in autenticazione del Partner Center. Questo scenario supporta l'autenticazione con le credenziali app indipendenti e App+Utente.

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

  • ID abbonamento attuale

Limite di velocità

Il limite dell'API Di creazione della migrazione è di 100 chiamate da parte di un partner in 5 minuti. Altre informazioni sui limiti di richieste e sul throttling sono disponibili in linee guida sul throttling delle API.

Richiesta REST

Sintassi della richiesta

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

Parametro URI

Questa tabella elenca i parametri di query necessari per creare una nuova migrazione commerciale.

Nome Digitare Obbligatorio Descrizione
ID cliente-locatario corda Sì Stringa in formato GUID che identifica il cliente.

Intestazioni della richiesta

Per altre informazioni, vedere intestazioni REST del Partner Center.

Corpo della richiesta

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

Proprietà Digitare Obbligatorio Descrizione
IDAbbonamentoCorrente corda Sì Identificatore di sottoscrizione che indica quale sottoscrizione richiede la convalida per la migrazione.
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.
acquistaTermineCompleto Bool NO È possibile avviare un nuovo periodo 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.
data di fine del termine personalizzato data e ora NO È possibile impostare una data di fine per allinearsi a una sottoscrizione esistente di OnlineServicesNCE 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

Esempio di richiesta

Nota: I componenti aggiuntivi annidati (sottoscrizioni di componenti aggiuntivi con sottoscrizioni di componenti aggiuntivi) devono essere scritti nel corpo della richiesta come elenco semplice all'interno di addOnMigrations e non devono essere annidati all'interno di altre sottoscrizioni di componenti aggiuntivi nella richiesta; vedere l'ultimo esempio di richiesta su come scrivere i componenti aggiuntivi nel corpo della richiesta.

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

{ 
    "currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC", 
    "termDuration": "P1M", 
    "billingCycle": "Monthly", 
} 

{
    "currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC", 
    "purchaseFullTerm": true 
}

{
    "currentSubscriptionId": "66E738D6-E0BC-4FFB-8818-BDE99BC7008B",
    "quantity": 1,
    "billingCycle": "Annual",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "359011DC-B5B0-4660-850B-A8FA9B2E3309",
            "quantity": 1,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M"
        },
        {
            "currentSubscriptionId": "159D9F87-CE39-4EBD-B9C2-ECF0892A85A1",
            "quantity": 1,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y"
        }
    ]
}

Risposta REST

In caso di esito positivo, questo metodo restituisce nel corpo della risposta i dettagli delle sottoscrizioni che vengono migrate (oggetto di migrazione).

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 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 partner.

Esempi di risposta

{
    "addOnMigrations": [
        {
            "currentSubscriptionId": "E3AFD30D-D6E7-45AF-A6C5-FB905992AE00",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "catalogItemId": "CFQ7TTC0LH0T:0001:CFQ7TTC0K4KQ",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        },
        {
            "currentSubscriptionId": "80906BD9-E45C-4D1B-92A8-EA3F3FB6E105",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "catalogItemId": "CFQ7TTC0LH0R:0001:CFQ7TTC0K0SK",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        },
        {
            "currentSubscriptionId": "72E424F4-10FF-4C76-B101-C274F73BA498",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "catalogItemId": "CFQ7TTC0LHXJ:0001:CFQ7TTC0KHTR",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        }
    ],
    "id": "7123c075-fc05-42d6-a21e-1d2036fa490b",
    "startedTime": "2022-02-23T13:00:48.4489832Z",
    "currentSubscriptionId": "2E56C7F5-E120-4CA4-BFF3-7DA763B4D777",
    "status": "Processing",
    "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
    "subscriptionEndDate": "2023-02-22T00:00:00Z",
    "quantity": 1,
    "termDuration": "P1Y",
    "billingCycle": "Monthly",
    "purchaseFullTerm": false
}
  • Last updated on