Aggiornare una nuova pianificazione della migrazione commerciale

Articolo
10/26/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

Questo articolo descrive come aggiornare una nuova pianificazione della migrazione commerciale. I partner possono eseguire l'aggiornamento prima della data di destinazione pianificata.

Importante

Questa API è attualmente disponibile solo nel tenant sandbox.

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
PUT	{baseURL}/v1/customers/{customer-tenant-id}/migrations/new commerce/schedules/{scheduleID}

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.
scheduleID	string	Sì	Stringa in formato GUID che ha identificato la pianificazione

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	Sì	Identificatore di sottoscrizione che indica quale sottoscrizione richiede la convalida per la migrazione. Non consentito per l'operazione di aggiornamento.
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	No	Data di destinazione quando pianificare la migrazione. Se targetDate è impostato per la data specificata, migrationOnRenewal può essere impostato su null o false.
migrateOnRenewal	bool	No	Se il flag è impostato su true per migrateOnRenewal, non è necessario specificare targetDate per pianificare una migrazione.

Esempio di richiesta

{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"status": "Created",
"customerTenantId": "6f297517-16e6-4313-8c6d-4e10496d2871",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00"
}

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": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"subscriptionEndDate": "2023-07-19T00:00:00Z",
"status": "Created",
"customerTenantId": "6f297517-16e6-4313-8c6d-4e10496d2871",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00",
"createdTime": "2022-10-18T21:20:50.9668605+00:00",
"lastModifiedTime": "2022-10-18T21:29:32.8992819+00:00"
}

Condividi tramite