Pianificare una nuova migrazione commerciale

Articolo
07/25/2023

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

Ruoli appropriati: amministratore globale | Agente amministratore | Agente di vendita

Questo articolo descrive come pianificare una 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

Richiesta REST

Sintassi della richiesta

Metodo	URI della richiesta
POST	{baseURL}/v1/customers/{customer-tenant-id}/migrations/new commerce/schedules

Parametro URI

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

Nome	Tipo	Obbligatorio	Descrizione
customer-tenant-id	string	Sì	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à	Tipo	Obbligatorio	Descrizione
currentSubscriptionId	string	Sì	Identificatore di sottoscrizione che indica quale sottoscrizione richiede la convalida per la migrazione.
termDuration	string	No	È possibile specificare la durata del termine da modificare al momento della migrazione.
billingCycle	string	No	È possibile specificare il ciclo di fatturazione da modificare 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	Una data di fine può essere impostata in modo da allinearsi a una sottoscrizione onlineServicesNCE esistente o a un mese di calendario esistente. 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
targetDate	datetime	Obbligatorio (se migrateOnRenewal è null/false)	Data di destinazione quando pianificare la migrazione. Se targetDate è impostato per la data specificata, migrationOnRenewal può essere impostato su null o false.
migrateOnRenewal	bool	Obbligatorio (se targetDate è null)	Se il flag è impostato su true per migrateOnRenewal, non è necessario specificare targetDate per la pianificazione di una migrazione.
addOnMigrationSchedules	bool	No	Include un elenco di sottoscrizioni AddOn da includere nella migrazione pianificata.

Esempio di richiesta

{
    "currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

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 ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore REST del Centro per i partner.

Esempi di risposta

{
    "id": "f016c025-a873-47af-8b52-2516fbef4c65",
    "currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

Condividi tramite