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 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 Di creazione della migrazione è di 100 chiamate da parte di un partner 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 HTTP/1.1

Parametro URI

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

Nome Digita Obbligatorio Descrizione
customer-tenant-id string Stringa in formato GUID che identifica il cliente.

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

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 del componente aggiuntivo nella richiesta; vedere l'ultimo esempio di richiesta per la scrittura dei 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 i dettagli delle sottoscrizioni di cui viene eseguita la migrazione (oggetto migrazione) nel corpo della risposta.

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

{
    "addOnMigrations": [
        {
            "currentSubscriptionId": "E3AFD30D-D6E7-45AF-A6C5-FB905992AE00",
            "customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
            "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": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
            "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": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
            "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": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
    "catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
    "subscriptionEndDate": "2023-02-22T00:00:00Z",
    "quantity": 1,
    "termDuration": "P1Y",
    "billingCycle": "Monthly",
    "purchaseFullTerm": false
}